Get Token On-Chain Total Value (TVC)
1. Overview & Typical Use
Returns the total on-chain value of tokens, including market cap, price, and holder information for each token.
- Typical use: view total locked value of tokens on the TRON chain, token market cap rankings.
- When not to use: for transfer analysis of a single token use “Get Token Transaction Data”.
2. Endpoint & Authentication
GET /api/tokenTvc
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
startTime | integer | No | 7 days ago | Start time, in seconds |
endTime | integer | No | current time | End time, in seconds |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tvcLine | array | Required | TVC trend line data; each entry contains value (USD) and time (seconds timestamp) | — |
stableCoinCountOfTopTen | integer | Required | Number of stablecoins in the Top 10 | — |
totalTokenNum | integer | Required | Total number of tokens included in the statistics | — |
lastWeekTokenNum | integer | Optional | Total tokens included last week (may be 0) | — |
totalTvc | number | Required | Current total TVC | USD |
updateTime | integer | Required | Data update time | Millisecond timestamp |
tokens | array | Required | Token details list; see below | — |
tokens[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
abbr | string | Required | Token abbreviation | — |
name | string | Required | Token name | — |
contractAddress | string | Optional | Token contract address (Base58Check format) | — |
contractAddressLower | string | Optional | Token contract address (lowercase hex format) | — |
tokenType | string | Optional | Token type | — |
priceInTrx | number | Optional | Price in TRX | TRX |
supply | number | Optional | Total supply | — |
decimal | integer | Optional | Token decimal places | — |
nrOfTokenHolders | integer | Optional | Number of holders | — |
transferCount | integer | Optional | Transfer count | — |
recentTransferCount | integer | Optional | Recent transfer count | — |
volume24hInTrx | number | Optional | 24-hour trading volume (TRX) | TRX |
volume24hInUsd | number | Optional | 24-hour trading volume (USD) | USD |
gain | number | Optional | Price change | — |
marketcap | number | Optional | Market cap (TRX) | TRX |
marketCapUSD | number | Required | Market cap (USD) | USD |
priceInUsd | number | Optional | Price in USD | USD |
imgUrl | string | Optional | Token icon URL | — |
ownerAddress | string | Optional | Issuer address | — |
issueTime | string | Optional | Issue time | yyyy-MM-dd HH:mm:ss |
dateCreated | integer | Optional | Creation time | Millisecond timestamp |
isTop | boolean | Optional | Whether this is a top token | — |
vip | boolean | Optional | Whether this is a VIP token | — |
level | string | Optional | Token level: 0 (UNKNOWN), 1 (NEUTRAL), 2 (OK), 3 (SUSPICIOUS), 4 (UNSAFE) | — |
publicTag | string | Optional | Public tag | — |
blueTag | string | Optional | Blue tag | — |
greyTag | string | Optional | Grey tag | — |
redTag | string | Optional | Risk tag | — |
verifier | string | Optional | Verifier | — |
pairUrl | string | Optional | Trading pair URL | — |
description | string | Optional | Token description | — |
projectSite | string | Optional | Project website | — |
email | string | Optional | Contact email | — |
whitePaper | string | Optional | Whitepaper link | — |
github | string | Optional | GitHub link | — |
socialMedia | array | Optional | Social media list | — |
announcement | string | Optional | Announcement link | — |
extra | object | Optional | Additional information | — |
canShow | integer | Optional | Whether to display | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Empty result is not an error: no matches returns
200+ empty arrays — this is a normal response.
Last updated on: