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”.

GET /api/stableCoin/pool/change

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

Parameter	Type	Required	Default	Description
`pool`	string	Yes	—	Pool contract address

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 or `_` for native TRX)	—

data[] element

Field	Type	Required	Description	Unit/Precision
`timestamp`	integer	Required	Snapshot time	milliseconds
`tvl`	string	Required	Total pool TVL at this timestamp, equal to the sum of token `liquidity` values in the same snapshot	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, or `_` for native TRX	—
`liquidity`	string	Required	USD value of this token’s liquidity	USD
`liquidityPercent`	string	Required	Token’s share of pool TVL: `liquidity / tvl` within the same snapshot	decimal ratio (0–1, rounded to 6 decimal places)

<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	—

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