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 response41 ms · just now · 9.1 KB · 334 lines
https://api.xrpl.to/v1/amm{ "success": true, "took": 39, "summary": { "totalLiquidity": 28980435.284960967, "xrpTokenLiquidity": 24477377.081235655, "tokenTokenLiquidity": 4503058.203725312, "totalVolume24h": 671276.5866952188, "totalVolume7d": 5161645.5428785505, "totalFees24h": 3039.9234815571335, "totalFees7d": 22818.86750417297, "avgFee": 0.480625049143499 }, "offset": 0, "limit": 25, "total": 31640, "count": 25, "totalPages": 1266, "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": 41.60154406040159, "yield": 0.11397683304219612, "volume": 25833.282967, "fees": 258.33282967, "liquidity": 226653.805668, "trades": 578 }, "apy7d": { "apy": 111.28515459387539, "yield": 2.1342358415263774, "volume": 483732.675675, "fees": 4837.32675675, "liquidity": 226653.805668, "trades": 7301 }, "currentLiquidity": { "asset1Amount": 113326.902834, "asset2Amount": 17878898.93341565, "lpTokenBalance": 616276988.7020134 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1792390470000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "lastFeeUpdate": 1740160571000, "health": { "balance": [ 50, 50 ], "depth": "medium", "activity": "high" }, "lpBurnedPercent": 48.6165, "lpHolderCount": 105, "lockedAsset1": 55958.09355627536, "lockedAsset2": 8580890.162023675 }, { "_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": 13.86806030722596, "yield": 0.037994685773221806, "volume": 70490.104267, "fees": 445.49745896744, "liquidity": 1172525.709586, "trades": 635 }, "apy7d": { "apy": 18.807608085044418, "yield": 0.3606938536857833, "volume": 669181.6720510001, "fees": 4229.22816736232, "liquidity": 1172525.709586, "trades": 6068 }, "currentLiquidity": { "asset1Amount": 586262.854793, "asset2Amount": 14826305110.55599, "lpTokenBalance": 56432713438.52759 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1792388721000, "createTxHash": "39A45D76CD55C7E2A2B9A2818F3ABE0559E00907BC3FE5FB50E122AB9C727923", "creator": "rBCQWyLxdbiy1LmmnmLBpin2YHG7VGUJ4f", "lastFeeUpdate": 1792306720000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "deep", "activity": "high" }, "lpBurnedPercent": 17.898, "lpHolderCount": 437, "lockedAsset1": 104014.42347744278, "lockedAsset2": 2676784685.7656026 }, { "_id": "7b3f4519a8da7d51062b8ee5ee55c1ca", "ammAccount": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3", "asset1": { "currency": "XRP", "issuer": "XRPL", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "asset2": { "currency": "524C555344000000000000000000000000000000", "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De", "md5": "0dd550278b74cb6690fdae351e8e0df3" }, "lpTokenCurrency": "03B245BE580EC4F4386A751C084489EC4B514A2F", "tradingFee": 205, "status": "active", "createdLedger": null, "createdTime": 1762037864722, "apy24h": { "apy": 3.037453182339875, "yield": 0.008321789540657192, "volume": 149582.069597, "fees": 306.64324267385, "liquidity": 3684823.332478, "trades": 1060 }, "apy7d": { "apy": 4.251747113462065, "yield": 0.08154035560064234, "volume": 1465667.34076, "fees": 3004.6180485580003, "liquidity": 3684823.332478, "trades": 9504 }, "currentLiquidity": { "asset1Amount": 1842411.666239, "asset2Amount": 2415884.508093536, "lpTokenBalance": 1787708829.81209 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1792391902000, "lastFeeUpdate": 1792058300000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "deep", "activity": "high" }, "lpBurnedPercent": 0, "lpHolderCount": 1204, "lockedAsset1": 0, "lockedAsset2": 0 }, { "_id": "dc97c990b397058bc2f0c6c1a2dd3405", "ammAccount": "rQEwagDWWQzB3a3LuxkiZ9rxHwzzshrr89", "asset1": { "currency": "XRP", "issuer": "XRPL", "md5": "84e5efeb89c4eae8f68188982dc290d8" }, "asset2": { "currency": "54494D4500000000000000000000000000000000", "issuer": "rExSpmk2PAqxKRTT3mhjCrCpqVasBra5v8", "md5": "00d32006174e7600cb1451ae971e9443" }, "lpTokenCurrency": "03DD3ED7DE16ABFC5E68A251961822B9C0FE8BE3", "tradingFee": 1000, "status": "active", "createdLedger": null, "createdTime": 1762037864814, "apy24h": { "apy": 1869.028743343723, "yield": 5.120626694092391, "volume": 76512.44256, "fees": 765.1244256, "liquidity": 14942.007518, "trades": 2837 }, "apy7d": { "apy": 335.72904432422814, "yield": 6.438639206218073, "volume": 96206.195425, "fees": 962.06195425, "liquidity": 14942.007518, "trades": 4375 }, "currentLiquidity": { "asset1Amount": 7469.7522, "asset2Amount": 9682775022.747997, "lpTokenBalance": 3605566334.844034 }, "tags": [ "High APY", "Active Pool", "Deep Liquidity" ], "lastTraded": 1792391122000, "lastFeeUpdate": 1757221102000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "shallow", "activity": "high" }, "lpBurnedPercent": 87.5408, "lpHolderCount": 14, "lockedAsset1": 6457.098676855393, "lockedAsset2": 8584184850.98502 }, { "_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": 6.551385367129016, "yield": 0.01794900100583292, "volume": 27012.464935, "fees": 64.829915844, "liquidity": 361189.54934, "trades": 1086 }, "apy7d": { "apy": 10.937242472940104, "yield": 0.20975533509748143, "volume": 315672.645648, "fees": 757.6143495552, "liquidity": 361189.54934, "trades": 9283 }, "currentLiquidity": { "asset1Amount": 180594.77519, "asset2Amount": 28008683708.0005, "lpTokenBalance": 45035666438.07521 }, "tags": [ "Active Pool", "Deep Liquidity" ], "lastTraded": 1792392321000, "lastFeeUpdate": 1789830442000, "asset": { "currency": "XRP", "issuer": "XRPL" }, "health": { "balance": [ 50, 50 ], "depth": "medium", "activity": "high" }, "lpBurnedPercent": 69.3155, "lpHolderCount": 453, "lockedAsset1": 125138.04479010148, "lockedAsset2": 19418408269.85053 } ] }
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[] }