Get BRC-20 balances

Retrieves BRC-20 token balances for a Bitcoin address.

GET

/ordinals/v1/brc-20/balances/{address}

Retrieves BRC-20 token balances for a Bitcoin address.

Query parameters

tickerarray of string

block_heightstring

Bitcoin block height

Pattern: "^[0-9]+$"

offsetinteger

Result offset

Minimum: 0

limitinteger

Results per page

Minimum: 1Maximum: 60

Path parameters

address
Required
string

Bitcoin address

Status codeDescription
200Default response
curl
curl -X GET "https://api.hiro.so/ordinals/v1/brc-20/balances/string"
Example response
{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "ticker": "PEPE",
      "available_balance": "1500.00000",
      "transferrable_balance": "500.00000",
      "overall_balance": "2000.00000"
    }
  ]
}