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 response3 ms · just now · 3.0 KB · 102 lines
https://api.xrpl.to/v1/testnet/amm{ "success": true, "took": 2, "pools": [ { "_id": "rPn7kHwycXzS5XNj167CnKwC2t82yAAdNW", "deleted": false, "firstSeen": 1789997921000, "ledger": 21969975, "spot": 12.487458362126445, "time": 1793476010000, "token": { "currency": "524C555344000000000000000000000000000000", "issuer": "rQhWct2fv4Vc4KRjRgMrxa8xPN9Zx9iLKV", "value": 117886.8824556641 }, "xrp": 1472107.536106, "fee": 501, "lp": "400920252.1737754" }, { "_id": "rf5BMXZaaCpwZHKAbTqfGXF2NHoHT1A1W8", "createTx": "71C284D7CA4F5075BE8E9CFD6A7524DC532DFA0B5A03994B229CD6EEDC0CB2B2", "created": 1790616420000, "creator": "rsvfsyp86rVfUe21YS3nRcmS9GHgGVruS5", "deleted": false, "fee": 23, "firstSeen": 1790616420000, "ledger": 21768931, "lp": "82461.49050383494", "spot": 204076933.61905497, "time": 1792787141000, "token": { "currency": "5249504C00000000000000000000000000000000", "issuer": "rHxyYNNzCY6eK3xAMH9JzT4DxGUnZeG2fj", "value": 0.006063181704321073 }, "xrp": 1237355.530193 }, { "_id": "rse5rNAWmzGaChypvxVhcZDAqCy4UqbDQx", "createTx": "CF1AA9E530F143C4D08C1A7227F0661EBF0227D4549DFD13ED4FA088F33E1ED1", "created": 1790631002000, "creator": "rKYGXdmMfmVavPaVmmT1qRpLhAZxqKq4wF", "deleted": false, "fee": 500, "firstSeen": 1790631002000, "ledger": 21760816, "lp": "15306.03497749697", "spot": 1038194285.4565653, "time": 1792760412000, "token": { "currency": "ELI", "issuer": "rGhtkZpVTVmaJ7SE1XD4kqWZzacXMB92tV", "value": 0.0004929887654861425 }, "xrp": 511818.119122 }, { "_id": "rUY9rjsgfQ4fHaS3tssqR1GaiWGHsaYguX", "createTx": "062F60908358024EACCAE4907C9CD86FB95B028927AB211073A5E5F702954A2A", "created": 1790616191000, "creator": "r955YzhynWxgtxp9dgtm2ceVNdPpo7D6sw", "deleted": false, "fee": 654, "firstSeen": 1790616191000, "ledger": 21760498, "lp": "79340.44517746902", "spot": 17156876.167684935, "time": 1792759340000, "token": { "currency": "424C4B4800000000000000000000000000000000", "issuer": "rDCaWfxEasyEZocudzc7zeRgFix6aBnLBt", "value": 0.01997927147196128 }, "xrp": 342781.886565 }, { "_id": "rnoVNEcgaNXVFgqYQ3mi9bvy6PKoECkvEo", "createTx": "CF1055D87485BFBADF1BCE0D88A300F82FCF95B7B567AF0BC4AFA6618017498A", "created": 1790620051000, "creator": "rM3gNP1fiHgTTDBdLCRCPrxvt6TmMAb4u8", "deleted": false, "fee": 99, "firstSeen": 1790620051000, "ledger": 21759283, "lp": "42053.97836926224", "spot": 57554438.866802454, "time": 1792755242000, "token": { "currency": "TAR", "issuer": "rUcJbY2my49KpsYt4W3QCUQdDTR91SNBnx", "value": 0.005632974273301463 }, "xrp": 324202.673451 } ], "count": 50, "total": 3004, "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 →