Skip to main content
Version: 1.0.0

Runes API

Runes protocol indexer API. Tracks Runes etching, minting, and transfers on Bitcoin.

Response Format​

All endpoints return responses in the following format:

{
  "error": null,
  "result": { ... },
  "db_block_height": 890000
}

On error, "error" contains a message string with HTTP status 400 or 500.

Paginated endpoints additionally return limit and offset at the top level:

{
  "error": null,
  "result": [ ... ],
  "db_block_height": 890000,
  "limit": 20,
  "offset": 0
}

Pagination​

Several endpoints support pagination via limit and offset query parameters.

  • limit: Number of results per page (default: 20, max: 20)
  • offset: Number of results to skip (default: 0)

Notes​

  • Rune names use uppercase with bullet spacers (e.g., UNCOMMON•GOODS)
  • Rune IDs are in format block:tx (e.g., 840000:1)
  • All amounts are returned as strings to preserve precision