Skip to Content
APIDeep AnalysisGet Stablecoin Key Events

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

ParameterTypeRequiredDefaultDescription
startintegerYes—Starting index
limitintegerNo20Number to return
sortstringYes—Sort field (e.g., time)
operatorAddressstringNo—Filter by operator address
directionintegerYes—1: ascending, 2: descending
startTimeintegerNo—Start time
endTimeintegerNo—End time
startAmountstringNo—Minimum event amount
endAmountstringNo—Maximum event amount
USDTintegerNo—Include USDT events: 1 = yes
USDCOLDintegerNo—Include USDC events: 1 = yes
USDDintegerNo—Include USDD events: 1 = yes
TUSDintegerNo—Include TUSD events: 1 = yes

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
totalintegerRequiredTotal matching event count—
codeintegerRequiredResponse code (0 = success)—
dataarrayRequiredKey event list—
refreshTimeInfoobjectRequiredCache refresh time metadata—
addressTagobjectOptionalOperator address label map (address → label info); code-derived from Greason v5 scan, returned in certain scenarios (reproducing sample pending)—
chartRefreshTimeintegerOptionalChart data refresh timestamp; code-derived from Greason v5 scan (reproducing sample pending)Unix seconds

data[] element

FieldTypeRequiredDescriptionUnit/Precision
tokenNamestringRequiredToken name—
tokenAddressstringRequiredToken contract address—
eventNamestringRequiredEvent name (e.g., Issue, Redeem, AddedBlackList)—
countstringRequiredEvent amount (minimum unit)sun (per token decimal)
operatorAddressstringRequiredOperator address—
timeintegerRequiredEvent timemilliseconds
hashstringRequiredTransaction hash—

refreshTimeInfo object

FieldTypeRequiredDescriptionUnit/Precision
typestringRequiredData refresh type, e.g. realtime—
lastUpdateTimeintegerRequiredLast update timeSecond timestamp

5. Errors

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

  • API Key Required: returns 401 if TRON-PRO-API-KEY header is not provided.
Last updated on: