Skip to Content
APIDeep AnalysisGet DeFi Pool TVL Change

Get DeFi Pool TVL Change

1. Overview & Typical Use

Returns the historical TVL (total value locked) change for a specific DeFi pool, including per-token liquidity snapshots at each data point.

  • Typical use: draw TVL trend charts for a specific pool.
  • When not to use: to query current pool metrics use “Get DeFi Pool Info” or “Get DeFi Pool Overview”.

2. Endpoint & Authentication

GET /api/stableCoin/pool/change

For Base URL and authentication, see Common Network & Authentication.

3. Request

ParameterTypeRequiredDefaultDescription
poolstringYesPool contract address

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
countintegerRequiredNumber of data points
dataarrayRequiredTVL change history
<tokenAddress>objectOptionalToken metadata (one entry per token in the pool, keyed by contract address)

data[] element

FieldTypeRequiredDescriptionUnit/Precision
timestampintegerRequiredSnapshot timemilliseconds
tvlstringRequiredTotal pool TVL in USD at this timestampUSD
tokensarrayRequiredPer-token liquidity at this snapshot

data[].tokens[] element

FieldTypeRequiredDescriptionUnit/Precision
tokenIdstringRequiredToken contract address
liquiditystringRequiredToken liquidity (minimum unit)minimum unit (divide by 10^token decimal)
liquidityPercentstringRequiredToken’s share of pool TVLdecimal

<tokenAddress> metadata object

FieldTypeRequiredDescriptionUnit/Precision
tokenAbbrstringRequiredToken abbreviation
tokenNamestringRequiredToken name
tokenDecimalintegerRequiredToken decimal precision

5. Errors

For HTTP status codes, see Common Errors. Key points for this endpoint:

  • General error handling rules apply; no special error scenarios.
Last updated on: