Docs • rebar labs
X / TwitterContact
  • Introduction
  • Mission
  • Rebar Shield
    • Introduction
      • Shield Overview
      • Quick Start Guide
    • Developer Guide
      • Fee Management
      • Mining Considerations
      • Security Best Practices
    • API
      • Authentication
      • API Reference
      • Rate Limits & Quotas
      • Error Codes
      • Change Log
    • FAQ
    • Glossary
    • Troubleshooting
  • Rebar Data
    • Introduction
    • Developer Guide
    • API
      • Runes
        • Etchings
        • Activity
        • Balances
      • Ordinals & BRC20s
        • Inscriptions
        • Satoshis
        • BRC 20
        • Statistics
    • RPC
      • Alkanes
      • Bitcoin
  • Resources
    • Contact
Powered by GitBook
LogoLogo

Legal

  • Terms of Service

Resources

  • Github
  • Media Kit

© 2025 Rebar Labs Inc

On this page
Export as PDF
  1. Rebar Data
  2. API
  3. Runes

Balances

PreviousActivityNextOrdinals & BRC20s

Rune balances

Rune holders

get

Retrieves a paginated list of holders for a Rune

Path parameters
etchingany ofRequired
stringOptionalPattern: ^[0-9]+:[0-9]+$
or
stringOptionalPattern: ^[0-9]+$
or
stringOptionalPattern: ^[A-Z]+$
or
stringOptionalPattern: ^[A-Za-z]+(•[A-Za-z]+)+$
Query parameters
offsetintegerOptional

Result offset

limitinteger · min: 1 · max: 60Optional

Results per page

Responses
200
Default Response
application/json
get
GET /runes/v1/etchings/{etching}/holders HTTP/1.1
Host: api.rebarlabs.io
Accept: */*
200

Default Response

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "address": "bc1q7jd477wc5s88hsvenr0ddtatsw282hfjzg59wz",
      "balance": "11000000000"
    }
  ]
}

Rune holder balance

get

Retrieves holder balance for a specific Rune

Path parameters
etchingany ofRequired
stringOptionalPattern: ^[0-9]+:[0-9]+$
or
stringOptionalPattern: ^[0-9]+$
or
stringOptionalPattern: ^[A-Z]+$
or
stringOptionalPattern: ^[A-Za-z]+(•[A-Za-z]+)+$
addressstringRequired

Bitcoin address

Example: bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5
Responses
200
Default Response
application/json
404
Default Response
application/json
get
GET /runes/v1/etchings/{etching}/holders/{address} HTTP/1.1
Host: api.rebarlabs.io
Accept: */*
{
  "address": "bc1q7jd477wc5s88hsvenr0ddtatsw282hfjzg59wz",
  "balance": "11000000000"
}

Address balances

get

Retrieves a paginated list of address balances

Path parameters
addressstringRequired

Bitcoin address

Example: bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5
Query parameters
offsetintegerOptional

Result offset

limitinteger · min: 1 · max: 60Optional

Results per page

Responses
200
Default Response
application/json
get
GET /runes/v1/addresses/{address}/balances HTTP/1.1
Host: api.rebarlabs.io
Accept: */*
200

Default Response

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "rune": {
        "id": "840000:1",
        "number": 1,
        "name": "ZZZZZFEHUZZZZZ",
        "spaced_name": "Z•Z•Z•Z•Z•FEHU•Z•Z•Z•Z•Z"
      },
      "address": "bc1q7jd477wc5s88hsvenr0ddtatsw282hfjzg59wz",
      "balance": "11000000000"
    }
  ]
}
  • GETRune holders
  • GETRune holder balance
  • GETAddress balances