GET
/v1/amm
List AMM pools
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/amm| Query parameter | Value | Description |
|---|---|---|
| sort | fees|apy|liquidity|volume|volume24h|created (fees, apy, liquidity and volume rank the 7-day figures) | |
| status | active|all | |
| limit | int (max 100) | |
| offset | int | |
| token | token id | |
| currency | currency code filter | |
| issuer | issuer address filter | |
| minLiquidity | only pools holding at least this much, in XRP (7-day liquidity) |
curl 'https://api.xrpl.to/v1/amm'
Response
200Example response40 ms · just now · 9.2 KB · 333 lines
https://api.xrpl.to/v1/amm{ "success": true, "took": 39, "summary": { "totalLiquidity": 28480971.681389295, "xrpTokenLiquidity": 24270014.901181996, "tokenTokenLiquidity": 4210956.780207301, "totalVolume24h": 355746.0131478952, "totalVolume7d": 2845312.3180556176, "totalFees24h": 1907.7097550587746, "totalFees7d": 10787.262200029216, "avgFee": 0.4808436863543788 }, "offset": 0, "limit": 25, "total": 31416, "count": 25, "totalPages": 1257, "pools": [ { "_id": "316c4362b9596a68e8f7fd66fc370d1d", "ammAccount": "rNVWpnUrR5RMjLsV3dcvjbFm6knaGcqd4Q", "asset1": { "currency": "XRP", "issuer": "XRPL", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "asset2": { "currency": "424348414D500000000000000000000000000000", "issuer": "rhYhn7s6z4HAfuJm7ehuSE7wxepRoUPwpi", "md5": "d64c6f50786392b868ee036528a2d823" }, "lpTokenCurrency": "03D65C0022D7ED297D50ECB98D70D9053E8D3CF4", "tradingFee": 1000, "status": "active", "createdLedger": null, "createdTime": 1762037864739, "apy24h": { "apy": 85.1029860323905, "yield": 0.23315886584216575, "volume": 69923.928065, "fees": 699.2392806500001, "liquidity": 299898.216662, "trades": 819 }, "apy7d": { "apy": 34.50319675643943, "yield": 0.6617051432741808, "volume": 198444.192424, "fees": 1984.4419242400002, "liquidity": 299898.216662, "trades": 2364 }, "currentLiquidity": { "asset1Amount": 149831.592954, "asset2Amount": 12938745.24164591, "lpTokenBalance": 613678183.2502666 }, "tags": [ "High APY", "Active Pool", "Deep Liquidity" ], "lastTraded": 1791766222000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "lastFeeUpdate": 1740160571000, "health": { "balance": [ 50, 50 ], "depth": "medium", "activity": "high" }, "lpBurnedPercent": 45.5161, "lpHolderCount": 76, "lockedAsset1": 70870.51417689974, "lockedAsset2": 6514565.511460926 }, { "_id": "7b3f4519a8da7d51062b8ee5ee55c1ca", "ammAccount": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3", "asset1": { "currency": "XRP", "issuer": "XRPL", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "asset2": { "currency": "524C555344000000000000000000000000000000", "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De", "md5": "0dd550278b74cb6690fdae351e8e0df3" }, "lpTokenCurrency": "03B245BE580EC4F4386A751C084489EC4B514A2F", "tradingFee": 196, "status": "active", "createdLedger": null, "createdTime": 1762037864722, "apy24h": { "apy": 1.3603346038202064, "yield": 0.00372694412005536, "volume": 67690.18822, "fees": 132.6727689112, "liquidity": 3559827.15698, "trades": 586 }, "apy7d": { "apy": 2.6534447714733216, "yield": 0.05088798191866644, "volume": 924247.040806, "fees": 1811.52419997976, "liquidity": 3559827.15698, "trades": 7493 }, "currentLiquidity": { "asset1Amount": 1780039.525064, "asset2Amount": 2509046.426445487, "lpTokenBalance": 1792226028.063491 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1791765702000, "lastFeeUpdate": 1791180790000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "deep", "activity": "high" }, "lpBurnedPercent": 0, "lpHolderCount": 1206, "lockedAsset1": 0, "lockedAsset2": 0 }, { "_id": "740ffdf157ae4bf1e620353f34793191", "ammAccount": "rBudi9ArACZzLrReUWKFZmHve13LD7CbrM", "asset1": { "currency": "XRP", "issuer": "XRPL", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "asset2": { "currency": "46555A5A59000000000000000000000000000000", "issuer": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62", "md5": "b05f7c8e58b832c74267d988567dea33" }, "lpTokenCurrency": "030230B01D2EA24FA6512EDEBA60EE0F8C4E65AC", "tradingFee": 632, "status": "active", "createdLedger": 93643665, "createdTime": 1737602531000, "apy24h": { "apy": 5.267238608796719, "yield": 0.014430790709032106, "volume": 23903.599806, "fees": 151.07075077392, "liquidity": 1046863.985626, "trades": 165 }, "apy7d": { "apy": 3.209598257246683, "yield": 0.06155393918007336, "volume": 101959.813451, "fees": 644.38602101032, "liquidity": 1046863.985626, "trades": 1272 }, "currentLiquidity": { "asset1Amount": 523431.992813, "asset2Amount": 16276827618.81602, "lpTokenBalance": 56110459863.02522 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1791765931000, "createTxHash": "39A45D76CD55C7E2A2B9A2818F3ABE0559E00907BC3FE5FB50E122AB9C727923", "creator": "rBCQWyLxdbiy1LmmnmLBpin2YHG7VGUJ4f", "lastFeeUpdate": 1791076941000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "deep", "activity": "medium" }, "lpBurnedPercent": 18.001, "lpHolderCount": 431, "lockedAsset1": 94371.18285927929, "lockedAsset2": 2924996469.3478003 }, { "_id": "cf1bc5108fcaca1dab24b994c9f9891e", "ammAccount": "rMpTKAquQfx5sAepbeKQczaPyyMZMMmwea", "asset1": { "currency": "SHX", "issuer": "rfmS3zqrQrka8wVyhXifEeyTwe8AMz2Yhw", "value": "20000000", "md5": "9b4ddc2e62f736881eef8f9f02812dbc" }, "asset2": { "currency": "XRP", "issuer": "XRPL", "value": "80000", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "createdHash": "7C2E230A5E67F53E22CB21881638C2339DE0597762FB94E64AFDE94C0FE04338", "createdLedger": 102314518, "createdTime": 1771359310000, "creator": "rMcBfCiALoRFeDpsvEUcHgtbtuz74Gc8zn", "lpTokenCurrency": "038CD3923D748A5874E75E306D58CBCC3D81217E", "status": "active", "tradingFee": 300, "apy24h": { "apy": 4.593152378132346, "yield": 0.01258397911817081, "volume": 7815.58568, "fees": 23.44675704, "liquidity": 186322.281846, "trades": 144 }, "apy7d": { "apy": 9.171968248989506, "yield": 0.17590076093952475, "volume": 109247.437189, "fees": 327.742311567, "liquidity": 186322.281846, "trades": 1948 }, "lastTraded": 1791763410000, "tags": [ "Active Pool", "Deep Liquidity" ], "currentLiquidity": { "asset1Amount": 18761960.61325639, "asset2Amount": 93161.140923, "lpTokenBalance": 1303116943.589744 }, "health": { "balance": [ 50, 50 ], "depth": "medium", "activity": "medium" }, "lpBurnedPercent": 0, "lpHolderCount": 19, "lockedAsset1": 0, "lockedAsset2": 0 }, { "_id": "a162e98e28dd44ae0aa64a87b0b4fa94", "ammAccount": "rLJMi56CJMUnELQ5XzSrefn2WuFAwKQmDt", "asset1": { "currency": "XRP", "issuer": "XRPL", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "asset2": { "currency": "50484E4958000000000000000000000000000000", "issuer": "rDFXbW2ZZCG5WgPtqwNiA2xZokLMm9ivmN", "md5": "ef02bf7d8b650fc962227d2a52261383" }, "lpTokenCurrency": "0344303A1372D9FA9B05A70FFB751DFA129B0477", "tradingFee": 240, "status": "active", "createdLedger": null, "createdTime": 1762037864725, "apy24h": { "apy": 1.845861501763756, "yield": 0.005057154799352756, "volume": 7782.523112, "fees": 18.678055468799997, "liquidity": 369339.207714, "trades": 110 }, "apy7d": { "apy": 3.991643147659562, "yield": 0.07655206036607379, "volume": 117806.988852, "fees": 282.73677324479996, "liquidity": 369339.207714, "trades": 5095 }, "currentLiquidity": { "asset1Amount": 184669.603857, "asset2Amount": 27205867550.94915, "lpTokenBalance": 45005630049.29011 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1791765651000, "lastFeeUpdate": 1789830442000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "medium", "activity": "medium" }, "lpBurnedPercent": 69.3618, "lpHolderCount": 453, "lockedAsset1": 128001.82555312867, "lockedAsset2": 18882680878.583424 } ] }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ success, took, summary, offset, limit, total (matching pools), count (pools in this response), totalPages, pools[] }