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\|volume24h\|created (fees, apy, liquidity and volume rank the 7-day figures)
status		active\|all
limit		int (max 100)
offset		int
token		token id
currency		currency code filter
issuer		issuer address filter
minLiquidity		only pools holding at least this much, in XRP (7-day liquidity)

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

Response

200Example response44 ms · just now · 9.2 KB · 334 lines

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

{
  "success": true,
  "took": 43,
  "summary": {
    "totalLiquidity": 29810426.077283993,
    "xrpTokenLiquidity": 25143497.224028002,
    "tokenTokenLiquidity": 4666928.85325599,
    "totalVolume24h": 309287.946044925,
    "totalVolume7d": 6420695.816102698,
    "totalFees24h": 1529.0006829027704,
    "totalFees7d": 28713.56039859262,
    "avgFee": 0.47806320629293153
  },
  "offset": 0,
  "limit": 25,
  "total": 31978,
  "count": 25,
  "totalPages": 1280,
  "pools": [
    {
      "_id": "740ffdf157ae4bf1e620353f34793191",
      "ammAccount": "rBudi9ArACZzLrReUWKFZmHve13LD7CbrM",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "46555A5A59000000000000000000000000000000",
        "issuer": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62",
        "md5": "b05f7c8e58b832c74267d988567dea33"
      },
      "lpTokenCurrency": "030230B01D2EA24FA6512EDEBA60EE0F8C4E65AC",
      "tradingFee": 613,
      "status": "active",
      "createdLedger": 93643665,
      "createdTime": 1737602531000,
      "apy24h": {
        "apy": 6.626215735275297,
        "yield": 0.018154015713083005,
        "volume": 37996.910116,
        "fees": 232.92105901108,
        "liquidity": 1283027.748198,
        "trades": 168
      },
      "apy7d": {
        "apy": 34.68444514873432,
        "yield": 0.6651811398387403,
        "volume": 1392244.469806,
        "fees": 8534.458599910779,
        "liquidity": 1283027.748198,
        "trades": 11324
      },
      "currentLiquidity": {
        "asset1Amount": 641513.874099,
        "asset2Amount": 11936341710.57444,
        "lpTokenBalance": 52088734026.68396
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1793515521000,
      "createTxHash": "39A45D76CD55C7E2A2B9A2818F3ABE0559E00907BC3FE5FB50E122AB9C727923",
      "creator": "rBCQWyLxdbiy1LmmnmLBpin2YHG7VGUJ4f",
      "lastFeeUpdate": 1793211410000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "deep",
        "activity": "medium"
      },
      "lpBurnedPercent": 19.3906,
      "lpHolderCount": 449,
      "lockedAsset1": 124273.45355890038,
      "lockedAsset2": 2316748315.966565
    },
    {
      "_id": "7b3f4519a8da7d51062b8ee5ee55c1ca",
      "ammAccount": "rhWTXC2m2gGGA9WozUaoMm6kLAVPb1tcS3",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "524C555344000000000000000000000000000000",
        "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        "md5": "0dd550278b74cb6690fdae351e8e0df3"
      },
      "lpTokenCurrency": "03B245BE580EC4F4386A751C084489EC4B514A2F",
      "tradingFee": 214,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864722,
      "apy24h": {
        "apy": 0.40338356779535606,
        "yield": 0.0011051604597133043,
        "volume": 19285.073139,
        "fees": 41.27005651746,
        "liquidity": 3734304.476308,
        "trades": 223
      },
      "apy7d": {
        "apy": 3.6857226395686253,
        "yield": 0.07068509171775446,
        "volume": 1233456.329018,
        "fees": 2639.59654409852,
        "liquidity": 3734304.476308,
        "trades": 8294
      },
      "currentLiquidity": {
        "asset1Amount": 1867152.238154,
        "asset2Amount": 2340033.096617831,
        "lpTokenBalance": 1768916601.84954
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1793513200000,
      "lastFeeUpdate": 1792885640000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "deep",
        "activity": "high"
      },
      "lpBurnedPercent": 0,
      "lpHolderCount": 1203,
      "lockedAsset1": 0,
      "lockedAsset2": 0
    },
    {
      "_id": "1a5a458b5a92b688fc0c1d8bc0622b8f",
      "ammAccount": "rPsfdMyrP99ifrJxLedNbv1Dszw89BhM79",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "4E4F525448000000000000000000000000000000",
        "issuer": "razRVbPbtNtFt5TTa63XE122uRzoYooEpJ",
        "md5": "6de73669c9a935b90c5bab8148e92330"
      },
      "lpTokenCurrency": "03A7870C5548E3920361FE88C1BFB76100721B30",
      "tradingFee": 1000,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864795,
      "apy24h": {
        "apy": 37.858532769673126,
        "yield": 0.10372200758814555,
        "volume": 3924.445138,
        "fees": 39.24445138,
        "liquidity": 37836.185678,
        "trades": 139
      },
      "apy7d": {
        "apy": 239.50589772826885,
        "yield": 4.593263792048991,
        "volume": 173791.581704,
        "fees": 1737.91581704,
        "liquidity": 37836.185678,
        "trades": 3624
      },
      "currentLiquidity": {
        "asset1Amount": 18918.092839,
        "asset2Amount": 98432267.0957335,
        "lpTokenBalance": 895729990.902006
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1793514250000,
      "lastFeeUpdate": 1777476841000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "shallow",
        "activity": "medium"
      },
      "lpBurnedPercent": 92.7912,
      "lpHolderCount": 22,
      "lockedAsset1": 17570.298831169035,
      "lockedAsset2": 91252608.24317543
    },
    {
      "_id": "eaada3fb3b08ff9e44bcb35586c075c2",
      "ammAccount": "rL8Zbq4uejDjfKdQygp1i6FzN28FmwpNp",
      "asset1": {
        "currency": "XYZ",
        "issuer": "rU5nUwkBUPx3MFPQSHmMnr9S9yg4g8cKLc",
        "value": "950000000",
        "md5": "29e0f1ac3a8c906d59bb39e40673369a"
      },
      "asset2": {
        "currency": "XRP",
        "issuer": "XRPL",
        "value": "301.137979",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "createdHash": "A2717EC5694EC00911FC97820CB19DBB89DD526652C79A4B5A1877FC246FF5F8",
      "createdLedger": 107863578,
      "createdTime": 1792814831000,
      "creator": "rUjA9nj8TwW5NPJ3gkzzN5mrB2QpFBCnrs",
      "lpTokenCurrency": "03D1DA9BF8BD8F2ADF41E20091A87328D34D4081",
      "status": "active",
      "tradingFee": 505,
      "currentLiquidity": {
        "asset1Amount": 72922641.111546,
        "asset2Amount": 6553.834176,
        "lpTokenBalance": 601451841.7474533
      },
      "lockedAsset1": 64766101.371350914,
      "lockedAsset2": 5835.7218093975325,
      "lpBurnedPercent": 88.9291,
      "lpHolderCount": 7,
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "shallow",
        "activity": "high"
      },
      "apy24h": {
        "apy": 101.47634716263225,
        "yield": 0.2780173894866637,
        "volume": 7216.157896,
        "fees": 36.4415973748,
        "liquidity": 13107.668352,
        "trades": 275
      },
      "apy7d": {
        "apy": 422.07490318802473,
        "yield": 8.094587184427871,
        "volume": 210101.315366,
        "fees": 1061.0116425982999,
        "liquidity": 13107.668352,
        "trades": 7131
      },
      "lastTraded": 1793515401000,
      "tags": [
        "High APY",
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastFeeUpdate": 1793319491000
    },
    {
      "_id": "da0d10d5df824327a12fe02c43567a69",
      "ammAccount": "rMzZ16KNa5NRbosSp3Y3enxVDb6DrjhJ3L",
      "asset1": {
        "currency": "XRP",
        "issuer": "XRPL",
        "md5": "84e5efeb89c4eae8f68188982dc290d8"
      },
      "asset2": {
        "currency": "44524F5000000000000000000000000000000000",
        "issuer": "rszenFJoDdiGjyezQc8pME9KWDQH43Tswh",
        "md5": "233d2c15a1c1288bb65b318ab1846e58"
      },
      "lpTokenCurrency": "030D7BEE49319A3173C25A85C34A04A0A2E4DE07",
      "tradingFee": 393,
      "status": "active",
      "createdLedger": null,
      "createdTime": 1762037864727,
      "apy24h": {
        "apy": 4.977226845208415,
        "yield": 0.01363623793207785,
        "volume": 7716.657257,
        "fees": 30.326463020010003,
        "liquidity": 222396.112264,
        "trades": 723
      },
      "apy7d": {
        "apy": 23.80809613271897,
        "yield": 0.4565936244631035,
        "volume": 258383.325611,
        "fees": 1015.4464696512301,
        "liquidity": 222396.112264,
        "trades": 11968
      },
      "currentLiquidity": {
        "asset1Amount": 111198.056132,
        "asset2Amount": 48129.85505942853,
        "lpTokenBalance": 36010877.05820013
      },
      "tags": [
        "Active Pool",
        "Deep Liquidity"
      ],
      "lastTraded": 1793516051000,
      "lastFeeUpdate": 1790831230000,
      "asset": {
        "currency": "XRP",
        "issuer": "XRPL"
      },
      "health": {
        "balance": [
          50,
          50
        ],
        "depth": "medium",
        "activity": "high"
      },
      "lpBurnedPercent": 27.9051,
      "lpHolderCount": 243,
      "lockedAsset1": 31048.516386193565,
      "lockedAsset2": 13422.579052724976
    }
  ]
}

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