GET
/last/tvl/:chain/:pairAggregated TVL · per chain, per pair
Total value locked for a specific token pair on a specific chain. Sums across every pool MarketEngine tracks for that pair on that chain (concentrated-liquidity AMMs across fee tiers, stable-pair AMMs, etc.).
Parameters
ParameterDescription
Parameter
chainrequiredenum · path- eth | base | arbitrum | bsc | polygon, see chain whitelist above.
pairrequiredstring · path- TOKEN0-TOKEN1, single hyphen separator. Each leg is 3–10 uppercase alphanumeric (e.g. WETH-USDC).
Example
request · shell
curl -H "X-API-Key: $KEY" \
"https://api.sifting.io/v1/last/tvl/polygon/WETH-USDC"200OKapplication/json
{ "chain": "polygon", "pair": "WETH-USDC", "usd": "231543.82179", "r0": "153.96483", "r1": "231543.82179", "n": 1, "v": 1, "t": 1777813200526}Loading runner…
First load onlyReference
Field keyDescription
Field key
- chain
- echoed chain segment
- pair
- echoed pair
- usd
- total USD value locked across all contributing pools (string, full precision)
- r0 / r1
- summed reserves of token0 / token1 (raw token units)
- n
- number of pools contributing to this aggregation
- v
- schema version
- t
- timestamp · int64 (Unix epoch ms)
Error responses
StatusCodeMeaning
- 503
stale_snapshotTVL snapshot is older than the staleness threshold.
{ "error": "stale_snapshot", "last_t": 1777813100000, "server_now": 1777813300000}