GET

/v1/amm

List AMM pools

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/amm

Query parameter	Value	Description
sort		fees\|apy\|liquidity\|volume\|created
status		active\|all
limit		int (max 100)
offset		int
token		token id
currency		currency code filter
issuer		issuer address filter

curl 'https://api.xrpl.to/v1/amm'

Response

200Example response45 ms · just now · 9.1 KB · 333 lines

https://api.xrpl.to/v1/amm

{
  "success": true,
  "took": 42,
  "summary": {
    "totalLiquidity": 28079183.420283884,
    "xrpTokenLiquidity": 23912868.460453883,
    "tokenTokenLiquidity": 4166314.95983,
    "totalVolume24h": 673625.9312632999,
    "totalVolume7d": 6996982.618195566,
    "totalFees24h": 1922.451511074766,
    "totalFees7d": 20141.35965761647,
    "avgFee": 0.4810789773374331
  },
  "offset": 0,
  "limit": 25,
  "total": 31061,
  "count": 25,
  "totalPages": 1243,
  "pools": [
    {
      "_id": "7b3f4519a8da7d51062b8ee5ee55c1ca",
      "ammAccount": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "md5": "0dd550278b74cb6690fdae351e8e0df3"
      },
      "lpTokenCurrency": "03B245BE580EC4F4386A751C084489EC4B514A2F",
      "tradingFee": 205,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864722,
      "apy24h": {
        "apy": 6.101863103431552,
        "yield": 0.016717433160086444,
        "volume": 267408.821121,
        "fees": 548.1880832980501,
        "liquidity": 3279140.272604,
        "trades": 1724
      },
      "apy7d": {
        "apy": 12.162333710899043,
        "yield": 0.23325023555148847,
        "volume": 3731025.565811,
        "fees": 7648.602409912551,
        "liquidity": 3279140.272604,
        "trades": 16088
      },
      "currentLiquidity": {
        "asset1Amount": 1640428.982087,
        "asset2Amount": 2363565.606565066,
        "lpTokenBalance": 1676305205.007748
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1789975461000,
      "lastFeeUpdate": 1787236112000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "deep",
        "activity": "high"
      },
      "lpBurnedPercent": 0,
      "lpHolderCount": 1207,
      "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": 652,
      "status": "active",
      "createdLedger": 93643665,
      "createdTime": 1737602531000,
      "apy24h": {
        "apy": 7.020963720353427,
        "yield": 0.019235517042064183,
        "volume": 30479.285011,
        "fees": 198.72493827172,
        "liquidity": 1033114.617284,
        "trades": 660
      },
      "apy7d": {
        "apy": 11.161963272441008,
        "yield": 0.21406504906051246,
        "volume": 339192.839316,
        "fees": 2211.53731234032,
        "liquidity": 1033114.617284,
        "trades": 6084
      },
      "currentLiquidity": {
        "asset1Amount": 516557.308642,
        "asset2Amount": 16472463146.73082,
        "lpTokenBalance": 56256513772.49992
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1789975482000,
      "createTxHash": "39A45D76CD55C7E2A2B9A2818F3ABE0559E00907BC3FE5FB50E122AB9C727923",
      "creator": "rBCQWyLxdbiy1LmmnmLBpin2YHG7VGUJ4f",
      "lastFeeUpdate": 1789749721000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "deep",
        "activity": "high"
      },
      "lpBurnedPercent": 17.9601,
      "lpHolderCount": 426,
      "lockedAsset1": 94260.5926436393,
      "lockedAsset2": 2909369574.0425315
    },
    {
      "_id": "5035b7ce609f76c4534814d909ef8c90",
      "ammAccount": "rM7cHVPfhe9yxQNk2kDNBEQqoQmMcQGPWE",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "5553444300000000000000000000000000000000",
        "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
        "md5": "1c54f16ec1b45eef983f202b9954999b"
      },
      "lpTokenCurrency": "03B20F3A7D26D33C6DA3503E5CCE3E67B102D4D2",
      "tradingFee": 202,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864726,
      "apy24h": {
        "apy": 7.379961729911772,
        "yield": 0.020219073232634988,
        "volume": 44713.021819,
        "fees": 90.32030407438,
        "liquidity": 446708.42741,
        "trades": 832
      },
      "apy7d": {
        "apy": 8.424181932855843,
        "yield": 0.16155965350682436,
        "volume": 357277.518569,
        "fees": 721.7005875093801,
        "liquidity": 446708.42741,
        "trades": 6559
      },
      "currentLiquidity": {
        "asset1Amount": 223354.213705,
        "asset2Amount": 321855.6255478511,
        "lpTokenBalance": 246991457.5019849
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1789975312000,
      "lastFeeUpdate": 1778388711000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "lpBurnedPercent": 0,
      "lpHolderCount": 98,
      "lockedAsset1": 0,
      "lockedAsset2": 0
    },
    {
      "_id": "a162e98e28dd44ae0aa64a87b0b4fa94",
      "ammAccount": "rLJMi56CJMUnELQ5XzSrefn2WuFAwKQmDt",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "50484E4958000000000000000000000000000000",
        "issuer": "rDFXbW2ZZCG5WgPtqwNiA2xZokLMm9ivmN",
        "md5": "ef02bf7d8b650fc962227d2a52261383"
      },
      "lpTokenCurrency": "0344303A1372D9FA9B05A70FFB751DFA129B0477",
      "tradingFee": 240,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864725,
      "apy24h": {
        "apy": 5.0648994895341435,
        "yield": 0.01387643695762779,
        "volume": 22579.303491,
        "fees": 54.19032837839999,
        "liquidity": 390520.481186,
        "trades": 797
      },
      "apy7d": {
        "apy": 8.367185094835792,
        "yield": 0.16046656346260418,
        "volume": 261106.164907,
        "fees": 626.6547957767999,
        "liquidity": 390520.481186,
        "trades": 9731
      },
      "currentLiquidity": {
        "asset1Amount": 195260.077379,
        "asset2Amount": 27263979135.3279,
        "lpTokenBalance": 46499189372.94697
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1789974920000,
      "lastFeeUpdate": 1789830442000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "lpBurnedPercent": 67.1367,
      "lpHolderCount": 458,
      "lockedAsset1": 131583.19768641502,
      "lockedAsset2": 18231638539.616516
    },
    {
      "_id": "da0d10d5df824327a12fe02c43567a69",
      "ammAccount": "rMzZ16KNa5NRbosSp3Y3enxVDb6DrjhJ3L",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "44524F5000000000000000000000000000000000",
        "issuer": "rszenFJoDdiGjyezQc8pME9KWDQH43Tswh",
        "md5": "233d2c15a1c1288bb65b318ab1846e58"
      },
      "lpTokenCurrency": "030D7BEE49319A3173C25A85C34A04A0A2E4DE07",
      "tradingFee": 394,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864727,
      "apy24h": {
        "apy": 24.979867013039687,
        "yield": 0.06843799181654708,
        "volume": 29772.875757,
        "fees": 117.30513048258,
        "liquidity": 171403.525102,
        "trades": 874
      },
      "apy7d": {
        "apy": 17.177113741388975,
        "yield": 0.3294240991499255,
        "volume": 143310.791492,
        "fees": 564.64451847848,
        "liquidity": 171403.525102,
        "trades": 6648
      },
      "currentLiquidity": {
        "asset1Amount": 85701.575286,
        "asset2Amount": 51991.8198553295,
        "lpTokenBalance": 33626944.20083781
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1789975312000,
      "lastFeeUpdate": 1787419430000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "lpBurnedPercent": 29.8834,
      "lpHolderCount": 240,
      "lockedAsset1": 25207.262632019072,
      "lockedAsset2": 15772.75188945973
    }
  ]
}

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

PrevGET/pairs/{id}NextGET/amm/info

/v1/amm

Request

Response

What it does

Also under AMM pools