Skip to Content
APIDeep AnalysisGet Stablecoin Holder Balance Overview

Get Stablecoin Holder Balance Overview

1. Overview & Typical Use

Returns the balance distribution of all major stablecoins (USDT, USDC, TUSD, USDD, USDJ) across wallet and protocol categories.

  • Typical use: display a cross-stablecoin balance breakdown grouped by category (Wallet, JustLend, SunSwap, SunCurve, Other).
  • When not to use: to query a specific address’s holdings use “Get Holder Token Basic Info”.

2. Endpoint & Authentication

GET /api/stableCoin/holder/balance/overview

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

3. Request

No request parameters.

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
dataarrayRequiredStablecoin balance overview list
refreshTimeInfoobjectRequiredCache refresh time metadata

data[] element

FieldTypeRequiredDescriptionUnit/Precision
tokenAddressstringRequiredStablecoin contract address
tokenNamestringRequiredToken name
decimalintegerRequiredToken decimal precision
statisticarrayRequiredBalance breakdown by category

data[].statistic[] element

FieldTypeRequiredDescriptionUnit/Precision
balancestringRequiredBalance (minimum unit)minimum unit (divide by 10^decimal)
tokenNamestringRequiredToken name
categorystringRequiredCategory: Wallet / JustLend / SunSwap / SunCurve / Other

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:

  • General error handling rules apply; no special error scenarios.
Last updated on: