Get BRC-20 token holders

Retrieves a list of holders and their balances for a particular BRC-20 token.

GET
/ordinals/v1/brc-20/tokens/{ticker}/holders

BRC-20 Token Holders

Retrieves a list of holders and their balances for a BRC-20 token

Query Parameters

offsetOffset

Result offset

Minimum: 0

limitLimit

Results per page

Minimum: 1Maximum: 60

Path Parameters

ticker
Required
string

Status codeDescription
200Default Response
404Default Response
/ordinals/v1/brc-20/tokens/{ticker}/holders

curl -X GET "https://api.hiro.so/ordinals/v1/brc-20/tokens/string/holders?offset=0&limit=1"

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "overall_balance": "2000.00000"
    }
  ]
}