GET /amm/liquidity-chart
GET

/v1/amm/liquidity-chart

Historical TVL chart data

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/amm/liquidity-chart?token=0dd550278b74cb6690fdae351e8e0df3
Query parameterValueDescription
tokentoken id
token2token id
ammAccountaddress
period1d|5d|1w|1m|3m|6m|1y|5y|all
poolTypexrp|token|all
curl 'https://api.xrpl.to/v1/amm/liquidity-chart?token=0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response672 ms · just now · 1.9 KB · 75 lines
https://api.xrpl.to/v1/amm/liquidity-chart?token=0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 671,
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "ammAccount": null,
  "period": "3m",
  "count": 91,
  "data": [
    {
      "date": "2026-08-23T00:00:00.000Z",
      "hour": 0,
      "tvl": 3196223.291194,
      "xrpLiquidity": 1598111.645597,
      "tokenLiquidity": 2432989.806174683,
      "lpTokenValue": 1689517541.446234,
      "volume": 934516.079471,
      "fees": 1915.7579629155503,
      "trades": 4516,
      "apr": 26.349655603020715,
      "poolCount": 1
    },
    {
      "date": "2026-08-24T00:00:00.000Z",
      "hour": 0,
      "tvl": 3242806.0866,
      "xrpLiquidity": 1621403.0433,
      "tokenLiquidity": 2399011.427161919,
      "lpTokenValue": 1689134632.561149,
      "volume": 674924.794103,
      "fees": 1383.59582791115,
      "trades": 4805,
      "apr": 27.985371049117592,
      "poolCount": 1
    },
    {
      "date": "2026-08-25T00:00:00.000Z",
      "hour": 0,
      "tvl": 3288703.83359,
      "xrpLiquidity": 1644351.916795,
      "tokenLiquidity": 2367864.692254163,
      "lpTokenValue": 1689448157.384578,
      "volume": 485127.660818,
      "fees": 994.5117046769001,
      "trades": 3839,
      "apr": 29.042592654987164,
      "poolCount": 1
    },
    {
      "date": "2026-08-26T00:00:00.000Z",
      "hour": 0,
      "tvl": 3305575.47931,
      "xrpLiquidity": 1652787.739655,
      "tokenLiquidity": 2339489.989816209,
      "lpTokenValue": 1683081794.984438,
      "volume": 490713.570329,
      "fees": 1005.9628191744501,
      "trades": 3167,
      "apr": 28.939519215439873,
      "poolCount": 1
    },
    {
      "date": "2026-08-27T00:00:00.000Z",
      "hour": 0,
      "tvl": 3262494.65777,
      "xrpLiquidity": 1631247.328885,
      "tokenLiquidity": 2372411.786557371,
      "lpTokenValue": 1683379689.155791,
      "volume": 401033.752502,
      "fees": 822.1191926291001,
      "trades": 2426,
      "apr": 26.023400084769637,
      "poolCount": 1
    }
  ]
}

Long arrays and strings are shortened in the example; Send request for the full answer.

What it does

Historical TVL chart data

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