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
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pool | string | Yes | — | Pool contract address |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
count | integer | Required | Number of data points | — |
data | array | Required | TVL change history | — |
<tokenAddress> | object | Optional | Token metadata (one entry per token in the pool, keyed by contract address) | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
timestamp | integer | Required | Snapshot time | milliseconds |
tvl | string | Required | Total pool TVL in USD at this timestamp | USD |
tokens | array | Required | Per-token liquidity at this snapshot | — |
data[].tokens[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenId | string | Required | Token contract address | — |
liquidity | string | Required | Token liquidity (minimum unit) | minimum unit (divide by 10^token decimal) |
liquidityPercent | string | Required | Token’s share of pool TVL | decimal |
<tokenAddress> metadata object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenAbbr | string | Required | Token abbreviation | — |
tokenName | string | Required | Token name | — |
tokenDecimal | integer | Required | Token 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: