GET /amm
GET

/v1/amm

List AMM pools

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/amm
Query parameterValueDescription
sortfees|apy|liquidity|volume|volume24h|created (fees, apy, liquidity and volume rank the 7-day figures)
statusactive|all
limitint (max 100)
offsetint
tokentoken id
currencycurrency code filter
issuerissuer address filter
minLiquidityonly pools holding at least this much, in XRP (7-day liquidity)
curl 'https://api.xrpl.to/v1/amm'

Response

200Example response40 ms · just now · 9.1 KB · 334 lines
https://api.xrpl.to/v1/amm
{
  "success": true,
  "took": 39,
  "summary": {
    "totalLiquidity": 32067707.322450213,
    "xrpTokenLiquidity": 26821472.482298,
    "tokenTokenLiquidity": 5246234.840152213,
    "totalVolume24h": 1088829.823665287,
    "totalVolume7d": 6003050.311671187,
    "totalFees24h": 3272.3511227633694,
    "totalFees7d": 20241.343878625783,
    "avgFee": 0.477157740835003
  },
  "offset": 0,
  "limit": 25,
  "total": 32716,
  "count": 25,
  "totalPages": 1309,
  "pools": [
    {
      "_id": "7b3f4519a8da7d51062b8ee5ee55c1ca",
      "ammAccount": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "md5": "0dd550278b74cb6690fdae351e8e0df3"
      },
      "lpTokenCurrency": "03B245BE580EC4F4386A751C084489EC4B514A2F",
      "tradingFee": 315,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864722,
      "apy24h": {
        "apy": 13.534509741977306,
        "yield": 0.037080848608157004,
        "volume": 470781.379412,
        "fees": 1482.9613451478,
        "liquidity": 3999264.851834,
        "trades": 1780
      },
      "apy7d": {
        "apy": 9.793723170710384,
        "yield": 0.18782482793143201,
        "volume": 2384638.833803,
        "fees": 7511.61232647945,
        "liquidity": 3999264.851834,
        "trades": 10951
      },
      "currentLiquidity": {
        "asset1Amount": 1999632.425917,
        "asset2Amount": 1864532.076011512,
        "lpTokenBalance": 1627404240.462051
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1795282152000,
      "lastFeeUpdate": 1794458351000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "deep",
        "activity": "high"
      },
      "lpBurnedPercent": 0,
      "lpHolderCount": 1192,
      "lockedAsset1": 0,
      "lockedAsset2": 0
    },
    {
      "_id": "740ffdf157ae4bf1e620353f34793191",
      "ammAccount": "rBudi9ArACZzLrReUWKFZmHve13LD7CbrM",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "46555A5A59000000000000000000000000000000",
        "issuer": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62",
        "md5": "b05f7c8e58b832c74267d988567dea33"
      },
      "lpTokenCurrency": "030230B01D2EA24FA6512EDEBA60EE0F8C4E65AC",
      "tradingFee": 462,
      "status": "active",
      "createdLedger": 93643665,
      "createdTime": 1737602531000,
      "apy24h": {
        "apy": 5.769400373050586,
        "yield": 0.015806576364522155,
        "volume": 40696.258777,
        "fees": 188.01671554974,
        "liquidity": 1189484.118596,
        "trades": 471
      },
      "apy7d": {
        "apy": 8.923015942199074,
        "yield": 0.1711263331380644,
        "volume": 440588.864808,
        "fees": 2035.52055541296,
        "liquidity": 1189484.118596,
        "trades": 3639
      },
      "currentLiquidity": {
        "asset1Amount": 594742.059298,
        "asset2Amount": 10509655303.93723,
        "lpTokenBalance": 46798357165.97981
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1795277990000,
      "createTxHash": "39A45D76CD55C7E2A2B9A2818F3ABE0559E00907BC3FE5FB50E122AB9C727923",
      "creator": "rBCQWyLxdbiy1LmmnmLBpin2YHG7VGUJ4f",
      "lastFeeUpdate": 1794891570000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "deep",
        "activity": "high"
      },
      "lpBurnedPercent": 21.5782,
      "lpHolderCount": 455,
      "lockedAsset1": 128401.68170446543,
      "lockedAsset2": 2267520944.155609
    },
    {
      "_id": "8ad8e77b4860f9ccdbf3949c621b736a",
      "ammAccount": "r9zeQhjj3scQFDRriCJpMjDtW6eWjWnp6M",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "XAH",
        "issuer": "rswh1fvyLqHizBS2awu1vs6QcmwTBd9qiv",
        "md5": "33d41a287177d13f69da580dde9b968b"
      },
      "lpTokenCurrency": "03B7FD829F075C67B6C87A45FA0E67CF4E5A83A9",
      "tradingFee": 971,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864732,
      "apy24h": {
        "apy": 39.15788658486598,
        "yield": 0.10728188105442733,
        "volume": 13658.296531,
        "fees": 132.62205931601,
        "liquidity": 123620.18452,
        "trades": 521
      },
      "apy7d": {
        "apy": 30.742063267537205,
        "yield": 0.5895738160897546,
        "volume": 75059.962856,
        "fees": 728.83223933176,
        "liquidity": 123620.18452,
        "trades": 4123
      },
      "currentLiquidity": {
        "asset1Amount": 61810.09226,
        "asset2Amount": 4601830.844184699,
        "lpTokenBalance": 282312756.3029439
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1795282211000,
      "lastFeeUpdate": 1793333760000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "lpBurnedPercent": 0,
      "lpHolderCount": 198,
      "lockedAsset1": 0,
      "lockedAsset2": 0
    },
    {
      "_id": "11105d22e327d7818176e6bbd42f60d0",
      "ammAccount": "rGRUZfeqTrwizmiT4fZdVYgEWdoac2WBQ",
      "asset1": {
        "currency": "LHT",
        "issuer": "rHashLabsu2H6hXDSunL8AcVDmTyE17Z35",
        "value": "3333333",
        "md5": "27b31c7f69d1d6eed45480cb0b204a6e"
      },
      "asset2": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": "1000",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "createdHash": "23F14D5C792FBC342942A19390FE9AAC18569DBC9557698CFF4C3D85ACC3C762",
      "createdLedger": 106384147,
      "createdTime": 1787079582000,
      "creator": "rCSCdAn63Rx4qodvnZ81TRcmZNu4WjEtP",
      "lpTokenCurrency": "0352AC9D01A3E8FCE0DB21D66AEE4E905D083016",
      "status": "active",
      "tradingFee": 1000,
      "currentLiquidity": {
        "asset1Amount": 496795854.8796886,
        "asset2Amount": 41308.00942,
        "lpTokenBalance": 3894646906.383147
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "apy24h": {
        "apy": 56.00570860483986,
        "yield": 0.15344029754750646,
        "volume": 12676.626513,
        "fees": 126.76626513,
        "liquidity": 82616.01884,
        "trades": 223
      },
      "apy7d": {
        "apy": 38.80329566169536,
        "yield": 0.7441727935119657,
        "volume": 61480.593529,
        "fees": 614.80593529,
        "liquidity": 82616.01884,
        "trades": 1287
      },
      "lastTraded": 1795282160000,
      "tags": [
        "High APY",
        "Active Pool",
        "Deep Liquidity"
      ],
      "lockedAsset1": 0,
      "lockedAsset2": 0,
      "lpBurnedPercent": 0,
      "lpHolderCount": 68,
      "lastFeeUpdate": 1795045262000
    },
    {
      "_id": "5035b7ce609f76c4534814d909ef8c90",
      "ammAccount": "rM7cHVPfhe9yxQNk2kDNBEQqoQmMcQGPWE",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "5553444300000000000000000000000000000000",
        "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
        "md5": "1c54f16ec1b45eef983f202b9954999b"
      },
      "lpTokenCurrency": "03B20F3A7D26D33C6DA3503E5CCE3E67B102D4D2",
      "tradingFee": 97,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864726,
      "apy24h": {
        "apy": 15.257544628864569,
        "yield": 0.04180149213387553,
        "volume": 120615.848779,
        "fees": 116.99737331563001,
        "liquidity": 279888.031128,
        "trades": 5029
      },
      "apy7d": {
        "apy": 10.504737788230928,
        "yield": 0.2014607247057986,
        "volume": 581303.562758,
        "fees": 563.86445587526,
        "liquidity": 279888.031128,
        "trades": 27999
      },
      "currentLiquidity": {
        "asset1Amount": 139933.348456,
        "asset2Amount": 130614.4366140091,
        "lpTokenBalance": 122460730.4564352
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1795282230000,
      "lastFeeUpdate": 1791388920000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "lpBurnedPercent": 0,
      "lpHolderCount": 93,
      "lockedAsset1": 0,
      "lockedAsset2": 0
    }
  ]
}

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[]
}

What it does

List AMM pools

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI