Skip to main content
GET
Get block by hash or height

Authorizations

X-Api-Key
string
header
required

API key (programmatic access — recommended)

Send your API key in the X-Api-Key header. Keys start with nxs_ and are created in the dashboard (or via POST /api/keys with a session JWT).

Each key is scoped to one chain and one network (for example cardano-mainnet), fixed at creation time. It cannot query a different network on the same chain, and it cannot query a different chain at all. A mismatched network parameter returns 400 Network Mismatch. Create one key per chain and network under the same account.

This is the credential most integrations should use.

Path Parameters

idOrHeight
string
required
Pattern: ^([a-fA-F0-9]{64}|[0-9]{1,8})$

Query Parameters

network
enum<string>
Available options:
CARDANO_MAINNET,
CARDANO_PREPROD,
CARDANO_PREVIEW,
APEX_PRIME_MAINNET,
APEX_VECTOR_MAINNET,
APEX_VECTOR_TESTNET,
MIDNIGHT_MAINNET,
MIDNIGHT_PREPROD,
MIDNIGHT_PREVIEW,
BITCOIN_MAINNET,
BITCOIN_TESTNET4

Response

200 - */*

OK

Bitcoin block

hash
string
default:""

Block hash

height
integer<int64>
default:""

Block height

time
integer<int64>
default:""

Block timestamp (epoch seconds)

mediantime
integer<int64>
default:""

Median time past (epoch seconds)

txCount
integer<int32>
default:""

Number of transactions in this block

size
integer<int64>
default:""

Block size in bytes

strippedsize
integer<int64>
default:""

Stripped (witness-stripped) size in bytes

weight
integer<int64>
default:""

Block weight (BIP141)

version
integer<int32>
default:""

Block version

merkleroot
string
default:""

Merkle root

nonce
integer<int64>
default:""

Nonce

bits
string
default:""

Difficulty bits (compact target)

difficulty
number<double>
default:""

Difficulty

chainwork
string
default:""

Chainwork as hex

previousblockhash
string
default:""

Hash of the previous block

nextblockhash
string
default:""

Hash of the next block, if any

confirmations
integer<int64>
default:""

Number of confirmations