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 response473 ms · just now · 1.9 KB · 75 lines
https://api.xrpl.to/v1/amm/liquidity-chart?token=0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 472,
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "ammAccount": null,
  "period": "3m",
  "count": 91,
  "data": [
    {
      "date": "2026-07-21T00:00:00.000Z",
      "hour": 0,
      "tvl": 3553552.626576,
      "xrpLiquidity": 1776776.313288,
      "tokenLiquidity": 2027158.268351323,
      "lpTokenValue": 1635685609.338762,
      "volume": 122868.646956,
      "fees": 255.56678566847998,
      "trades": 2024,
      "apr": 1.8795664532983667,
      "poolCount": 1
    },
    {
      "date": "2026-07-22T00:00:00.000Z",
      "hour": 0,
      "tvl": 3579252.019692,
      "xrpLiquidity": 1789626.009846,
      "tokenLiquidity": 2036659.223127457,
      "lpTokenValue": 1645351844.294588,
      "volume": 83345.122609,
      "fees": 173.35785502672,
      "trades": 1098,
      "apr": 1.789155002779462,
      "poolCount": 1
    },
    {
      "date": "2026-07-23T00:00:00.000Z",
      "hour": 0,
      "tvl": 3623711.030212,
      "xrpLiquidity": 1811855.515106,
      "tokenLiquidity": 2011740.432124344,
      "lpTokenValue": 1645317314.793596,
      "volume": 64799.95506,
      "fees": 134.7839065248,
      "trades": 988,
      "apr": 1.6927815475874488,
      "poolCount": 1
    },
    {
      "date": "2026-07-24T00:00:00.000Z",
      "hour": 0,
      "tvl": 3657863.91923,
      "xrpLiquidity": 1828931.959615,
      "tokenLiquidity": 1994229.069782966,
      "lpTokenValue": 1645786202.562504,
      "volume": 58925.20727,
      "fees": 122.56443112159998,
      "trades": 766,
      "apr": 1.556230142779995,
      "poolCount": 1
    },
    {
      "date": "2026-07-25T00:00:00.000Z",
      "hour": 0,
      "tvl": 3646337.973672,
      "xrpLiquidity": 1823168.986836,
      "tokenLiquidity": 2003536.533136723,
      "lpTokenValue": 1646990930.464651,
      "volume": 32320.002946,
      "fees": 67.22560612768,
      "trades": 868,
      "apr": 1.5966781779391332,
      "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