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 response367 ms · just now · 1.9 KB · 75 lines
https://api.xrpl.to/v1/amm/liquidity-chart?token=0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 365,
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "ammAccount": null,
  "period": "3m",
  "count": 91,
  "data": [
    {
      "date": "2026-06-23T00:00:00.000Z",
      "hour": 0,
      "tvl": 4209932.77068,
      "xrpLiquidity": 2104966.38534,
      "tokenLiquidity": 2330098.766436415,
      "lpTokenValue": 1913863412.353511,
      "volume": 148772.706539,
      "fees": 330.27540851658006,
      "trades": 701,
      "apr": 2.649568493400019,
      "poolCount": 1
    },
    {
      "date": "2026-06-24T00:00:00.000Z",
      "hour": 0,
      "tvl": 4274973.948912,
      "xrpLiquidity": 2137486.974456,
      "tokenLiquidity": 2288315.88812359,
      "lpTokenValue": 1910908996.761194,
      "volume": 310817.169133,
      "fees": 690.01411547526,
      "trades": 1390,
      "apr": 2.81126947000494,
      "poolCount": 1
    },
    {
      "date": "2026-06-25T00:00:00.000Z",
      "hour": 0,
      "tvl": 4267658.064746,
      "xrpLiquidity": 2133829.032373,
      "tokenLiquidity": 2216262.449670582,
      "lpTokenValue": 1878287844.222325,
      "volume": 710989.122519,
      "fees": 1578.39585199218,
      "trades": 1999,
      "apr": 4.3704472069841565,
      "poolCount": 1
    },
    {
      "date": "2026-06-26T00:00:00.000Z",
      "hour": 0,
      "tvl": 3853849.128628,
      "xrpLiquidity": 1926924.564314,
      "tokenLiquidity": 2015023.371572894,
      "lpTokenValue": 1701462223.251398,
      "volume": 506663.85487,
      "fees": 1124.7937578114002,
      "trades": 1877,
      "apr": 6.012059964176113,
      "poolCount": 1
    },
    {
      "date": "2026-06-27T00:00:00.000Z",
      "hour": 0,
      "tvl": 3790521.609128,
      "xrpLiquidity": 1895260.804564,
      "tokenLiquidity": 1993422.192167473,
      "lpTokenValue": 1678219236.516578,
      "volume": 114533.617396,
      "fees": 254.26463061912003,
      "trades": 686,
      "apr": 6.254619301797705,
      "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