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

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

Query parameters

offsetinteger

Result offset

Minimum: 0

limitinteger

Results per page

Minimum: 1Maximum: 60

Path parameters

ticker
Required
string

Status codeDescription
200Default response
404Default response
curl
curl -X GET "https://api.hiro.so/ordinals/v1/brc-20/tokens/string/holders"
Example response
{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "overall_balance": "2000.00000"
    }
  ]
}