GET
/v1/testnet/amm
Testnet AMM pools, deepest first. A pool of two tokens has token and token2 (in a fixed order, by code) and xrp 0; its spot is token2 per token
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/testnet/amm| Query parameter | Value | Description |
|---|---|---|
| limit | 1-100 | |
| page | from 1 |
curl 'https://api.xrpl.to/v1/testnet/amm'
Response
200Example response5 ms · just now · 3.0 KB · 102 lines
https://api.xrpl.to/v1/testnet/amm{ "success": true, "took": 4, "pools": [ { "_id": "rf5BMXZaaCpwZHKAbTqfGXF2NHoHT1A1W8", "createTx": "71C284D7CA4F5075BE8E9CFD6A7524DC532DFA0B5A03994B229CD6EEDC0CB2B2", "created": 1790616420000, "creator": "rsvfsyp86rVfUe21YS3nRcmS9GHgGVruS5", "deleted": false, "fee": 23, "firstSeen": 1790616420000, "ledger": 21652668, "lp": "82461.49050383494", "spot": 134114292.6444512, "time": 1792398650000, "token": { "currency": "5249504C00000000000000000000000000000000", "issuer": "rHxyYNNzCY6eK3xAMH9JzT4DxGUnZeG2fj", "value": 0.007478849656606668 }, "xrp": 1003020.63149 }, { "_id": "rPn7kHwycXzS5XNj167CnKwC2t82yAAdNW", "deleted": false, "firstSeen": 1789997921000, "ledger": 21652371, "spot": 3.563419090218343, "time": 1792397682000, "token": { "currency": "524C555344000000000000000000000000000000", "issuer": "rQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV", "value": 219813.6194109588 }, "xrp": 783288.047699, "fee": 501, "lp": "399890348.8952954" }, { "_id": "rUY9rjsgfQ4fHaS3tssqR1GaiWGHsaYguX", "createTx": "062F60908358024EACCAE4907C9CD86FB95B028927AB211073A5E5F702954A2A", "created": 1790616191000, "creator": "r955YzhynWxgtxp9dgtm2ceVNdPpo7D6sw", "deleted": false, "fee": 654, "firstSeen": 1790616191000, "ledger": 21652482, "lp": "79340.5734492256", "spot": 23456358.39828258, "time": 1792398050000, "token": { "currency": "424C4B4800000000000000000000000000000000", "issuer": "rDCaWfxEasyEZocudzc7zeRgFix6aBnLBt", "value": 0.01704729889300623 }, "xrp": 399867.552557 }, { "_id": "rse5rNAWmzGaChypvxVhcZDAqCy4UqbDQx", "createTx": "CF1AA9E530F143C4D08C1A7227F0661EBF0227D4549DFD13ED4FA088F33E1ED1", "created": 1790631002000, "creator": "rKYGXdmMfmVavPaVmmT1qRpLhAZxqKq4wF", "deleted": false, "fee": 500, "firstSeen": 1790631002000, "ledger": 21652568, "lp": "15321.35633349697", "spot": 367401569.0642966, "time": 1792398321000, "token": { "currency": "ELI", "issuer": "rGhtkZpVTVmaJ7SE1XD4kqWZzacXMB92tV", "value": 0.0008261518337932881 }, "xrp": 303529.480021 }, { "_id": "rnoVNEcgaNXVFgqYQ3mi9bvy6PKoECkvEo", "createTx": "CF1055D87485BFBADF1BCE0D88A300F82FCF95B7B567AF0BC4AFA6618017498A", "created": 1790620051000, "creator": "rM3gNP1fiHgTTDBdLCRCPrxvt6TmMAb4u8", "deleted": false, "fee": 565, "firstSeen": 1790620051000, "ledger": 21650774, "lp": "42053.97836926224", "spot": 48109100.98479991, "time": 1792392431000, "token": { "currency": "TAR", "issuer": "rUcJbY2my49KpsYt4W3QCUQdDTR91SNBnx", "value": 0.006160368128467796 }, "xrp": 296369.772396 } ], "count": 50, "total": 1579, "page": 1, "limit": 50 }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ pools: [ { _id (pool account), xrp, token: { currency, issuer, value }, token2?: { currency, issuer, value }, spot, fee, lp } ], count, total }
What it does
Testnet AMM pools, deepest first. A pool of two tokens has token and token2 (in a fixed order, by code) and xrp 0; its spot is token2 per token
Start at GET /v1/testnet/fixtures: it names live accounts, a busy token, an NFT with offers and one of every ledger object that xrpl.to keeps alive on Testnet, plus a real transaction of every type. The busiest token gains holders every hour, so its GET /v1/testnet/tokens/{md5}/holders is the place to test paginating a long list. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →