Get Stablecoin Key Events
1. Overview & Typical Use
Returns key on-chain events for stablecoins, such as minting (AddedBlackList, Issue) and burning (DestroyedBlackFunds, Redeem), with optional filters by operator, time range, and amount range. This endpoint requires an API Key; calls without a Key return 401.
- Typical use: monitor large mint/burn events; detect blacklist operations; compliance analysis.
- When not to use: for general transfer records use the TRC20 transfers endpoint.
2. Endpoint & Authentication
GET /api/deep/stableCoin/totalSupply/keyEvents
For Base URL and authentication, see Common Network & Authentication.
This endpoint requires an API Key; calls without a Key return 401.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start | integer | Yes | — | Starting index |
limit | integer | No | 20 | Number to return |
sort | string | Yes | — | Sort field (e.g., time) |
operatorAddress | string | No | — | Filter by operator address |
direction | integer | Yes | — | 1: ascending, 2: descending |
startTime | integer | No | — | Start time |
endTime | integer | No | — | End time |
startAmount | string | No | — | Minimum event amount |
endAmount | string | No | — | Maximum event amount |
USDT | integer | No | — | Include USDT events: 1 = yes |
USDCOLD | integer | No | — | Include USDC events: 1 = yes |
USDD | integer | No | — | Include USDD events: 1 = yes |
TUSD | integer | No | — | Include TUSD events: 1 = yes |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total matching event count | — |
code | integer | Required | Response code (0 = success) | — |
data | array | Required | Key event list | — |
refreshTimeInfo | object | Required | Cache refresh time metadata | — |
addressTag | object | Optional | Operator address label map (address → label info); code-derived from Greason v5 scan, returned in certain scenarios (reproducing sample pending) | — |
chartRefreshTime | integer | Optional | Chart data refresh timestamp; code-derived from Greason v5 scan (reproducing sample pending) | Unix seconds |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenName | string | Required | Token name | — |
tokenAddress | string | Required | Token contract address | — |
eventName | string | Required | Event name (e.g., Issue, Redeem, AddedBlackList) | — |
count | string | Required | Event amount (minimum unit) | sun (per token decimal) |
operatorAddress | string | Required | Operator address | — |
time | integer | Required | Event time | milliseconds |
hash | string | Required | Transaction hash | — |
refreshTimeInfo object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
type | string | Required | Data refresh type, e.g. realtime | — |
lastUpdateTime | integer | Required | Last update time | Second timestamp |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- API Key Required: returns 401 if
TRON-PRO-API-KEYheader is not provided.
Last updated on: