Stablecoins

Get realtime stablecoin balances across all supported EVM chains. Includes USD-pegged, yield-bearing, and euro-pegged stablecoins.

GET /v1/evm/balances/{address}/stablecoins

Get stablecoin balances for a given address

cURL

curl --request GET \
  --url https://api.sim.dune.com/v1/evm/balances/{address}/stablecoins \
  --header 'X-Sim-Api-Key: <api-key>'

200

{
  "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "balances": [
    {
      "chain": "ethereum",
      "chain_id": 1,
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "amount": "1000000000",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "price_usd": 1,
      "value_usd": 1000
    },
    {
      "chain": "base",
      "chain_id": 8453,
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "amount": "500000000",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "price_usd": 1,
      "value_usd": 500
    },
    {
      "chain": "gnosis",
      "chain_id": 100,
      "address": "native",
      "amount": "100000000000000000000",
      "symbol": "XDAI",
      "decimals": 18,
      "price_usd": 1,
      "value_usd": 100
    }
  ],
  "next_offset": "opaque-pagination-token",
  "request_time": "2026-02-05T10:31:08Z",
  "response_time": "2026-02-05T10:31:08Z"
}

The Stablecoin Balances API provides a dedicated endpoint for retrieving only stablecoin holdings for a wallet across supported EVM chains. This is a specialized version of the Balances endpoint that filters results to include only configured stablecoins.

Supported Stablecoins

The endpoint includes stablecoins from three categories:

Category	Description	Examples
Standard	USD-pegged stablecoins	USDC, USDT, DAI, BUSD
Yield-bearing	Stablecoins that accrue yield	sDAI, sUSDe
Euro-pegged	EUR-pegged stablecoins	EURC, EURe

The stablecoin category is used for filtering only and is not included in the response. The response format is identical to the standard Balances endpoint.

On Gnosis chain (chain_id: 100), the native token xDAI is a stablecoin and will be included in results with address: "native".

Alternative Access

You can also access stablecoin balances through the main Balances endpoint using the asset_class query parameter:

curl -s -X GET 'https://api.sim.dune.com/v1/evm/balances/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?asset_class=stablecoin&chain_ids=1,8453' \
  -H 'X-Sim-Api-Key: YOUR_API_KEY'

Both methods return identical results.

Compute Unit Cost

The Stablecoin Balances endpoint’s CU cost equals the number of chains you include via the chain_ids query parameter, the same as the standard Balances endpoint.

If you omit chain_ids, the endpoint uses its default chain set, which equals chains at request time. See the tags section of the Supported Chains page.

Pagination

This endpoint uses cursor-based pagination, identical to the Balances endpoint. Use the limit query parameter to define the maximum page size. The next_offset value from the response can be used to fetch subsequent pages.

# First page
curl -s -X GET 'https://api.sim.dune.com/v1/evm/balances/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/stablecoins?limit=10' \
  -H 'X-Sim-Api-Key: YOUR_API_KEY'

# Next page (using next_offset from previous response)
curl -s -X GET 'https://api.sim.dune.com/v1/evm/balances/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/stablecoins?limit=10&offset=NEXT_OFFSET_VALUE' \
  -H 'X-Sim-Api-Key: YOUR_API_KEY'

Example Response

{
  "request_time": "2026-02-05T10:31:08Z",
  "response_time": "2026-02-05T10:31:08Z",
  "wallet_address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "balances": [
    {
      "chain": "ethereum",
      "chain_id": 1,
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "amount": "1000000000",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "price_usd": 1.0,
      "value_usd": 1000.0
    },
    {
      "chain": "gnosis",
      "chain_id": 100,
      "address": "native",
      "amount": "100000000000000000000",
      "symbol": "XDAI",
      "decimals": 18,
      "price_usd": 1.0,
      "value_usd": 100.0
    }
  ]
}

Authorizations

X-Sim-Api-Key · string · header · required

API key for authentication. Obtain your key from the Dune dashboard at sim.dune.com.

Path Parameters

address · string<address> · default: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 · required

Wallet address to get stablecoin balances for

Pattern: ^0x[a-fA-F0-9]{40}$

Query Parameters

chain_ids · string

Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. ?chain_ids=1 or ?chain_ids=mainnet) or a comma-separated list (e.g. ?chain_ids=1,8453,137). If omitted, results include balances from chains with the default tag. See the Supported Chains Tags section.

filters · enum<string>

Specify erc20 or native to get only ERC20 stablecoins or native stablecoins (e.g., xDAI on Gnosis), respectively

Available options: erc20, native

metadata · string

A comma separated list of additional metadata fields to include for each token. Supported values: logo, url, pools

exclude_spam_tokens · boolean · default: false

When true, excludes tokens with less than 100 USD liquidity from the response. This differs from the low_liquidity field in the response.

exclude_unpriced · boolean · default: false

When true, excludes balances for tokens without available pricing data. By default, unpriced token balances are included.

historical_prices · string

Historical price selection. Provide a single integer or a comma-separated list of up to 3 integers representing hours in the past (e.g. 168 for 1 week ago or 720,168,24 for 1 month, 1 week, and 1 day ago). When set, each balance includes a historical_prices array with one entry per offset.

offset · string

The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.

limit · integer<int32> · default: 1000

Maximum number of balances to return. Default is 1000 when not provided. Values above 1000 are reduced to 1000.

Required range: 1 <= x <= 1000

Response

200

application/json

Successful Response

balances · object[] · required

Show child attributes

wallet_address · string · required

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

errors · object

Show child attributes

warnings · object[]

Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled.

Show child attributes

next_offset · string

Use this value as the offset in your next request to continue pagination. Not included when there are no more balances.

request_time · string<date-time>

Timestamp of when the request was received.

response_time · string<date-time>

Timestamp of when the response was generated.