Get All Rune Transfers by Blocks

This endpoint returns all Rune transfer activity across the chain. Results are cursor-paginated and can be filtered by runeId, fromBlockHeight, and toBlockHeight.

get

Get rune transfer events (inputs and outputs) from the blockchain.

Filtering Options:

• Filter by block range using fromBlockHeight/toBlockHeight

• Filter by specific rune using runeId

Pagination:

• Uses cursor-based pagination that returns full blocks of data with variable number of blocks per page depending how many transfers occurred in that period.

• Pass the nextCursor from the response as cursor to fetch the next page. Stop on items empty or when nextCursor is null.

• Returns complete blocks (no partial results within a block)

Response Structure:

• Each item represents a transaction with rune transfers

• inputs: Rune amounts consumed by the transaction

• outputs: Rune amounts created by the transaction

Examples:

• Filter by rune: /block/runes/transfers?runeId=840000:1

• Block range: /block/runes/transfers?fromBlockHeight=870000&toBlockHeight=875000

Authorizations

x-api-keystringRequired

Query parameters

runeIdstringOptional

Filter transfers by specific rune ID

Example: 840000:1

fromBlockHeightnumberOptional

Start of block range (defaults to rune activation height)

Example: 870000

toBlockHeightnumberOptional

End of block range

Example: 875000

cursorstringOptional

Pagination cursor from previous response

Responses

200

Default Response

application/json

nextCursorstring · nullableRequired

Cursor for fetching the next page of results

400

Invalid input

application/json

401

Unauthorized

application/json

404

Not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get/v1/block/runes/transfers

GET /v1/block/runes/transfers HTTP/1.1
Host: api.secretkeylabs.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "nextCursor": "text",
  "items": [
    {
      "blockHeight": 875000,
      "blockTime": "2024-12-20T15:30:00.000Z",
      "txid": "text",
      "inputs": [
        {
          "runeId": "840000:1",
          "address": "text",
          "amount": "1000000",
          "index": 0
        }
      ],
      "outputs": [
        {
          "runeId": "840000:1",
          "address": "text",
          "amount": "1000000",
          "index": 0
        }
      ]
    }
  ]
}