GET /testnet/amm
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

GEThttps://api.xrpl.to/v1/testnet/amm
Query parameterValueDescription
limit1-100
pagefrom 1
curl 'https://api.xrpl.to/v1/testnet/amm'

Response

200Example response2 ms · just now · 2.6 KB · 92 lines
https://api.xrpl.to/v1/testnet/amm
{
  "success": true,
  "took": 1,
  "pools": [
    {
      "_id": "rEc17YM54zCGkzHfnNGtrp1dR31ACUYhep",
      "deleted": false,
      "firstSeen": 1789944340000,
      "ledger": 20930524,
      "spot": 0.6949000529524078,
      "time": 1789975830000,
      "token": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
        "value": 27837.73512293121
      },
      "xrp": 19344.443611
    },
    {
      "_id": "rsbGzWhoSpcoE6sBWq18QzfKyZh7aA692C",
      "deleted": false,
      "firstSeen": 1789944350000,
      "ledger": 20930184,
      "spot": 948.8239870056804,
      "time": 1789974670000,
      "token": {
        "currency": "56454C4158000000000000000000000000000000",
        "issuer": "rDtb4JAujk7zJPFVtGaJQpbc7HzZG5frbs",
        "value": 15.40009040677059
      },
      "xrp": 14611.97518,
      "fee": 11,
      "lp": "460772.1058594754"
    },
    {
      "_id": "rUU1ELMLU73U94U6w8DeQAikCtsvvKUUen",
      "createTx": "8B984CBFC034D0280827988B633A9F852FCC193F1E0DD4841F92CBDEE42B9AFB",
      "created": 1789967940000,
      "creator": "rLmaFpMUedJ72RrcLUUFfr2b7CncusVksZ",
      "deleted": false,
      "fee": 500,
      "firstSeen": 1789967940000,
      "ledger": 20930524,
      "lp": "6781263.992305068",
      "spot": 1.8553371747688299,
      "time": 1789975830000,
      "token": {
        "currency": "4445455000000000000000000000000000000000",
        "issuer": "rBsTWpza7J6PRRhSzWZ9XhU5w65deaXv6M",
        "value": 4987.115228881711
      },
      "xrp": 9252.780279
    },
    {
      "_id": "rPzZWRMyiuHHuiCX3owr3t7mvN18ykwczs",
      "deleted": false,
      "firstSeen": 1789952150000,
      "ledger": 20930121,
      "spot": 6.0671767890981,
      "time": 1789974462000,
      "token": {
        "currency": "4F4E595849410000000000000000000000000000",
        "issuer": "rQDKJE1dzWLU7VaWuiHVf14q6uFhZXsX3B",
        "value": 38.12471451559345
      },
      "xrp": 231.309383
    },
    {
      "_id": "rGkpj9FdtyKiB324xqDq6Z8kRDaGqTuMfi",
      "createTx": "C9726DA96B12073DDEE6F7963EADAB8AC88DFE7F7E00285E8A3971F131904435",
      "created": 1789967992000,
      "creator": "rNjdYWLaVb9q4UyDa4t5FJQqG1gXdfMt4M",
      "deleted": false,
      "fee": 500,
      "firstSeen": 1789967992000,
      "ledger": 20930375,
      "lp": "79074.39535020165",
      "spot": 1.8564663686606715,
      "time": 1789975311000,
      "token": {
        "currency": "564F4C5400000000000000000000000000000000",
        "issuer": "rUfzQ6XdytZ2GBbZoQTUBjnda3fVDBwai2",
        "value": 58.70430180678379
      },
      "xrp": 108.982562
    }
  ],
  "count": 25,
  "total": 25,
  "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. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI