Skip to main content
GET
cURL
This endpoint is only available on the starter plan or higher.
200 credits per request

  • Each rune and BRC-20 token held: id, name, symbol and balance in whole units
  • Price and value in your currency, and the CoinStats coin id when the token is listed
  • Total value of the priced balances
For inscriptions, use GET /wallet/ordinals.
  • address: Query parameter. Bitcoin address.
  • currency: Fiat currency for prices and values. Defaults to USD.
Prices come from CoinStats market data; runes CoinStats does not list fall back to their latest trade price. Tokens without a price have price and value null and are left out of totalValue.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

address
string
required

Bitcoin address: Taproot (bc1p…), SegWit (bc1q…) or legacy (1…, 3…). Ordinals and runes usually sit on a Taproot address.

Example:

"bc1pr8vjq0fk89f5sw3r4n9scrasvw7kaud9akhzw57c3ygycsjspvvseyjcma"

currency
object

Fiat currency for prices and values, e.g. USD, EUR.

Example:

"USD"

Response

address
string
required
Example:

"bc1pr8vjq0fk89f5sw3r4n9scrasvw7kaud9akhzw57c3ygycsjspvvseyjcma"

currency
string
required
Example:

"USD"

totalValue
number
required

Sum of the values that have a price

Example:

5691.28

data
object[]
required

Runes and BRC-20 tokens, most valuable first