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 response2 ms · just now · 3.1 KB · 102 lines
https://api.xrpl.to/v1/testnet/amm{ "success": true, "took": 1, "pools": [ { "_id": "rf5BMXZaaCpwZHKAbTqfGXF2NHoHT1A1W8", "createTx": "71C284D7CA4F5075BE8E9CFD6A7524DC532DFA0B5A03994B229CD6EEDC0CB2B2", "created": 1790616420000, "creator": "rsvfsyp86rVfUe21YS3nRcmS9GHgGVruS5", "deleted": false, "fee": 23, "firstSeen": 1790616420000, "ledger": 21467167, "lp": "82539.070993525", "spot": 83874364.58850366, "time": 1791766451000, "token": { "currency": "5249504C00000000000000000000000000000000", "issuer": "rHxyYNNzCY6eK3xAMH9JzT4DxGUnZeG2fj", "value": 0.009455345465778966 }, "xrp": 793061.092907 }, { "_id": "rPn7kHwycXzS5XNj167CnKwC2t82yAAdNW", "deleted": false, "firstSeen": 1789997921000, "ledger": 21464026, "spot": 3.5495070083422338, "time": 1791755890000, "token": { "currency": "524C555344000000000000000000000000000000", "issuer": "rQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV", "value": 220236.7160824683 }, "xrp": 781731.767229, "fee": 501, "lp": "399885241.0840405" }, { "_id": "rUY9rjsgfQ4fHaS3tssqR1GaiWGHsaYguX", "createTx": "062F60908358024EACCAE4907C9CD86FB95B028927AB211073A5E5F702954A2A", "created": 1790616191000, "creator": "r955YzhynWxgtxp9dgtm2ceVNdPpo7D6sw", "deleted": false, "fee": 654, "firstSeen": 1790616191000, "ledger": 21467132, "lp": "79340.5734492256", "spot": 39532002.55558326, "time": 1791766330000, "token": { "currency": "424C4B4800000000000000000000000000000000", "issuer": "rDCaWfxEasyEZocudzc7zeRgFix6aBnLBt", "value": 0.01304178469226534 }, "xrp": 515567.865784 }, { "_id": "rfR5FeAqy3oF672BVWeF8eqtXotE9WwN1o", "createTx": "1EEF5D632A547AF817BAC6DE1F7EC6FDFECF0E64ABAFB39F6698D10C4645C87B", "created": 1790302932000, "creator": "rwMAfNLdZ4rRF8S6fvgzSeHce2DRSpgMjH", "deleted": false, "fee": 760, "firstSeen": 1790302932000, "ledger": 21120383, "lp": "74353.56077552705", "spot": 14958297.425218873, "time": 1790608100000, "token": { "currency": "424C4B4800000000000000000000000000000000", "issuer": "rGvBwXn9jjjUAu77sLEavZ4jC7fxFahtBV", "value": 0.0196874616105376 }, "xrp": 294490.906318 }, { "_id": "r4vCh1AV7dyBV72BNeNLzqVQaTXQZvKCNx", "createTx": "BA85C53851F0E109195C2F94E0E4BE1C6CEEC25090BDFC14D2E065B22DDE82B2", "created": 1790303141000, "creator": "r9RScgdzKFFN18HamtwGgVchzWWdTTomMM", "deleted": false, "fee": 733, "firstSeen": 1790303141000, "ledger": 21120646, "lp": "87983.7257678941", "spot": 4900695.55039421, "time": 1790608980000, "token": { "currency": "5249504C00000000000000000000000000000000", "issuer": "r9byVHQhrPUfnBMrdif4g8NNUjavMdTxRp", "value": 0.04089745729866403 }, "xrp": 200425.987006 } ], "count": 50, "total": 1177, "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 →