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 response352 ms · just now · 1.9 KB · 75 lines
https://api.xrpl.to/v1/amm/liquidity-chart?token=0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 351,
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "ammAccount": null,
  "period": "3m",
  "count": 91,
  "data": [
    {
      "date": "2026-08-03T00:00:00.000Z",
      "hour": 0,
      "tvl": 3737836.78544,
      "xrpLiquidity": 1868918.39272,
      "tokenLiquidity": 2008245.031161005,
      "lpTokenValue": 1668826062.709848,
      "volume": 63840.76813,
      "fees": 132.7887977104,
      "trades": 576,
      "apr": 1.561219142815171,
      "poolCount": 1
    },
    {
      "date": "2026-08-04T00:00:00.000Z",
      "hour": 0,
      "tvl": 3735921.353344,
      "xrpLiquidity": 1867960.676672,
      "tokenLiquidity": 2009439.166472277,
      "lpTokenValue": 1668842614.336693,
      "volume": 56508.047717,
      "fees": 117.53673925135999,
      "trades": 485,
      "apr": 1.460936427170106,
      "poolCount": 1
    },
    {
      "date": "2026-08-05T00:00:00.000Z",
      "hour": 0,
      "tvl": 3753704.763514,
      "xrpLiquidity": 1876852.381757,
      "tokenLiquidity": 1993794.023560372,
      "lpTokenValue": 1666222051.721146,
      "volume": 64343.613079,
      "fees": 133.83471520432,
      "trades": 517,
      "apr": 1.1114193051025731,
      "poolCount": 1
    },
    {
      "date": "2026-08-06T00:00:00.000Z",
      "hour": 0,
      "tvl": 3811142.974202,
      "xrpLiquidity": 1905571.487101,
      "tokenLiquidity": 1965780.998605434,
      "lpTokenValue": 1666999515.752058,
      "volume": 92507.932567,
      "fees": 192.41649973935998,
      "trades": 551,
      "apr": 1.181929754886888,
      "poolCount": 1
    },
    {
      "date": "2026-08-07T00:00:00.000Z",
      "hour": 0,
      "tvl": 3829117.864814,
      "xrpLiquidity": 1914558.932407,
      "tokenLiquidity": 1954642.578284483,
      "lpTokenValue": 1666037542.105681,
      "volume": 161841.842523,
      "fees": 336.63103244783997,
      "trades": 749,
      "apr": 1.4435399888717524,
      "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