Block Operations
resource: block — block metadata, contents, and chain-tip browsing
All 9 operations share the same two optional/required fields pattern — most take a
blockHash, a few take a numeric height, and two need neither.
get
Returns full block metadata for a block hash.
| Field | Type | Required | Description |
|---|---|---|---|
blockHash | text | ✓ Yes | Block hash (hex). |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getStatus
Returns the block's confirmation/orphan status.
| Field | Type | Required | Description |
|---|---|---|---|
blockHash | text | ✓ Yes | Block hash. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getTransactions
Returns the block's transaction list, paginated.
| Field | Type | Required | Description |
|---|---|---|---|
blockHash | text | ✓ Yes | Block hash. |
startIndex | number | No | Offset into the block's transaction list — omit for the first page. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getTransactionId
Returns a single transaction id at a specific position within the block, without fetching the whole list.
| Field | Type | Required | Description |
|---|---|---|---|
blockHash | text | ✓ Yes | Block hash. |
index | number | No (default 0) | Zero-based position of the transaction within the block. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getRaw
Returns the block's raw serialized bytes as hex.
| Field | Type | Required | Description |
|---|---|---|---|
blockHash | text | ✓ Yes | Block hash. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getHeader
Returns just the 80-byte block header (hex) — lighter than getRaw when you only need the header.
| Field | Type | Required | Description |
|---|---|---|---|
blockHash | text | ✓ Yes | Block hash. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getHash
Looks up a block's hash by its height — the reverse of the usual hash-based lookups above.
| Field | Type | Required | Description |
|---|---|---|---|
height | number | No (default 0) | Block height, must be non-negative. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getRecentBlocks
Returns the most recent blocks at the current chain tip — no parameters beyond network.
| Field | Type | Required | Description |
|---|---|---|---|
network | select | No | Defaults to Bitcoin:DefaultNetwork. |
getBlocksFromHeight
Returns a page of blocks starting from a given height — useful for backfilling or scanning a range.
| Field | Type | Required | Description |
|---|---|---|---|
startHeight | number | No (default 0) | Height to start from, must be non-negative. |
network | select | No | Defaults to Bitcoin:DefaultNetwork. |