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
startintegerYesStarting index
limitintegerNo20Number to return
sortstringYesSort field (e.g., time)
operatorAddressstringNoFilter by operator address
directionintegerYes1: ascending, 2: descending
startTimeintegerNoStart time
endTimeintegerNoEnd time
startAmountstringNoMinimum event amount
endAmountstringNoMaximum event amount
USDTintegerNoInclude USDT events: 1 = yes
USDCOLDintegerNoInclude USDC events: 1 = yes
USDDintegerNoInclude USDD events: 1 = yes
TUSDintegerNoInclude 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: