Skip to main content
GET
https://starknet.impulse.avnu.fi
/
v3
/
tokens
/
{tokenAddress}
/
exchange-tvl
/
line
curl "https://starknet.impulse.avnu.fi/v3/tokens/0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7/exchange-tvl/line?startDate=2024-02-01T00:00:00Z&endDate=2024-02-14T00:00:00Z&resolution=1D"

[
  {
    "exchange": "JediSwap",
    "value": 5234567.89,
    "valueUsd": 12750000,
    "date": "2024-02-13T00:00:00Z"
  },
  {
    "exchange": "Ekubo",
    "value": 3456789.12,
    "valueUsd": 8420000,
    "date": "2024-02-13T00:00:00Z"
  },
  {
    "exchange": "JediSwap",
    "value": 5345678.90,
    "valueUsd": 13020000,
    "date": "2024-02-14T00:00:00Z"
  },
  {
    "exchange": "Ekubo",
    "value": 3567890.12,
    "valueUsd": 8690000,
    "date": "2024-02-14T00:00:00Z"
  }
]

​
Overview

Returns historical TVL (Total Value Locked) data for a token across different exchanges over time. Use this to build TVL trend charts and analyze liquidity changes.

​
Path Parameters

​
tokenAddress
string
required
Token contract address (hex format)

​
Query Parameters

​
startDate
string
required
Start date (ISO 8601 format)
​
endDate
string
required
End date (ISO 8601 format)
​
resolution
string
default:"1H"
Data point frequency: 1, 5, 15, 1H, 4H, 1D, 1W

​
Response

Returns an array of TVL data points by exchange (ExchangeDataPoint).
​
exchange
string
required
Exchange/DEX name
​
value
number
required
TVL in token amount
​
valueUsd
number
required
TVL in USD
​
date
string
required
ISO 8601 timestamp
curl "https://starknet.impulse.avnu.fi/v3/tokens/0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7/exchange-tvl/line?startDate=2024-02-01T00:00:00Z&endDate=2024-02-14T00:00:00Z&resolution=1D"

[
  {
    "exchange": "JediSwap",
    "value": 5234567.89,
    "valueUsd": 12750000,
    "date": "2024-02-13T00:00:00Z"
  },
  {
    "exchange": "Ekubo",
    "value": 3456789.12,
    "valueUsd": 8420000,
    "date": "2024-02-13T00:00:00Z"
  },
  {
    "exchange": "JediSwap",
    "value": 5345678.90,
    "valueUsd": 13020000,
    "date": "2024-02-14T00:00:00Z"
  },
  {
    "exchange": "Ekubo",
    "value": 3567890.12,
    "valueUsd": 8690000,
    "date": "2024-02-14T00:00:00Z"
  }
]