Skip to main content
GET
/
v1
/
evm
/
balances
/
{address}
/
stablecoins
Get stablecoin balances for a given address
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/balances/{address}/stablecoins \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'
{
  "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:
CategoryDescriptionExamples
StandardUSD-pegged stablecoinsUSDC, USDT, DAI, BUSD
Yield-bearingStablecoins that accrue yieldsDAI, sUSDe
Euro-peggedEUR-pegged stablecoinsEURC, 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
    }
  ]
}

Headers

​
X-Sim-Api-Key
string
required

Used for authenticating requests. Visit Authentication to learn how to create your API key.

Path Parameters

​
address
string
default:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
required

Wallet address to get stablecoin balances for

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.

​
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

Successful Response

​
balances
object[]
required
​
wallet_address
string
required
Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

​
errors
object
​
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.

​
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.