Maestro Official Developer Documentation

Block Info

curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/blocks/{height_or_hash} \
  --header 'api-key: <api-key>'

{
  "data": {
    "coinbase_tag": "A8tlDQgvVmlhQlRDLyz6vm1tPXaDOuJgXZs6zuF9J7o+V55Fu/UWyF9S+hZG5d/z+c8QAAAAAAAAABDThC4BY8HxNM7fc9SQsQ8AAAAAAA==",
    "hash": "000000000000000000004fe9dc835b41f2da749287c4d1fca9055d83b2e06fa4",
    "height": 878027,
    "metaprotocols": [
      "inscriptions",
      "runes",
      "brc20"
    ],
    "miner_name": "ViaBTC",
    "size": 1865672,
    "timestamp": "2025-01-06 02:09:37",
    "total_fees": "2110512",
    "total_txs": 1849,
    "total_volume": "240371600038",
    "unix_timestamp": 1736129377,
    "weight_units": 3993329
  },
  "last_updated": {
    "block_hash": "00000000000000000002467d678b845978ef175b424cff2985860bb156280c53",
    "block_height": 878064
  }
}

GET

blocks

{height_or_hash}

Block Info

curl --request GET \
  --url https://xbt-mainnet.gomaestro-api.org/v0/blocks/{height_or_hash} \
  --header 'api-key: <api-key>'

{
  "data": {
    "coinbase_tag": "A8tlDQgvVmlhQlRDLyz6vm1tPXaDOuJgXZs6zuF9J7o+V55Fu/UWyF9S+hZG5d/z+c8QAAAAAAAAABDThC4BY8HxNM7fc9SQsQ8AAAAAAA==",
    "hash": "000000000000000000004fe9dc835b41f2da749287c4d1fca9055d83b2e06fa4",
    "height": 878027,
    "metaprotocols": [
      "inscriptions",
      "runes",
      "brc20"
    ],
    "miner_name": "ViaBTC",
    "size": 1865672,
    "timestamp": "2025-01-06 02:09:37",
    "total_fees": "2110512",
    "total_txs": 1849,
    "total_volume": "240371600038",
    "unix_timestamp": 1736129377,
    "weight_units": 3993329
  },
  "last_updated": {
    "block_hash": "00000000000000000002467d678b845978ef175b424cff2985860bb156280c53",
    "block_height": 878064
  }
}

Authorizations

api-key

string

header

required

Project API Key

Path Parameters

height_or_hash

string

required

Block height or block hash

Query Parameters

from_timestamp

boolean | null

Whether numeric path param should be taken as timestamp instead of block height. Default: false.

Response

Requested data

data

object

required

Show child attributes

data.coinbase_tag

string

required

Base64-encoding of script pubkey used in coinbase transaction input.

Example:

"A8tlDQgvVmlhQlRDLyz6vm1tPXaDOuJgXZs6zuF9J7o+V55Fu/UWyF9S+hZG5d/z+c8QAAAAAAAAABDThC4BY8HxNM7fc9SQsQ8AAAAAAA=="

data.hash

string

required

Block hash.

Example:

"0000000000000000000290db65621592a96224ecbe92ae22532a35dc40213471"

data.height

integer<int64>

required

Block height.

Required range: x >= 0

Example:

875075

data.metaprotocols

enum<string>[]

required

Whether any of the transactions in the block involved metaprotocols.

Available options:

inscriptions,

runes,

brc20

data.size

integer<int64>

required

Block size in bytes.

Required range: x >= 0

Example:

1865672

data.timestamp

string

required

The timestamp of the block, as claimed by the miner, in UTC format.

Example:

"2024-12-16 22:48:06"

data.total_fees

string

required

Total fees paid by all transactions in the block, in satoshis.

Example:

"2110512"

data.total_txs

integer<int32>

required

Total number of transactions.

Required range: x >= 0

Example:

"1849"

data.total_volume

string

required

Total number of satoshis that went through this block, minus fees.

Example:

"240371600038"

data.unix_timestamp

integer<int32>

required

The timestamp of the block, as claimed by the miner.

Required range: x >= 0

Example:

1734389286

data.weight_units

integer<int64>

required

Number of weight units (WU) of the block.

Required range: x >= 0

Example:

3993329

data.miner_name

string | null

Miner name.

Example:

"ViaBTC"

last_updated

object

required

Show child attributes

last_updated.block_hash

string

required

The hash of the block

Example:

"0000000000000000000a7f3b7b6b6e1d9a18db65a3b4a3f4f3bcb2e1f1b2d3e7"

last_updated.block_height

integer<int64>

required

The height of the block in the blockchain

Required range: x >= 0

Example:

707000

UTxOs by Runes Inscription Activity by Block

⌘I

Blockchain Indexer API

Esplora API

Node RPC API

Mempool Monitoring API

Event Manager API

Market Price API

Wallet API

Block Info

Authorizations

Path Parameters

Query Parameters

Response