--- title: "Get block by hash or height" method: GET path: "/v4/data/blockchains/block" tags: ["Blockchains API"] --- # Get block by hash or height `GET /v4/data/blockchains/block` /v4/data/blockchains/block **50 credits per API call** Get block details by hash or height for supported blockchains. Response shape differs by chain (EVM-style vs UTXO-style). Bitcoin Cash (bch-mainnet, bch-testnet) returns the raw node block format (see UtxoRawBlock). ## Query parameters - `chain` 'algorand-mainnet-algod' | 'algorand-testnet-algod' | 'arb-one-mainnet' | 'arb-testnet' | 'avax-mainnet' | 'avax-testnet' | 'base-mainnet' | 'base-sepolia' | 'bch-mainnet' | 'bch-testnet' | 'berachain-mainnet' | 'bitcoin-mainnet' | 'bitcoin-testnet' | 'bsc-mainnet' | 'bsc-testnet' | 'cardano-mainnet' | 'cardano-preprod' | 'celo-mainnet' | 'celo-testnet' | 'chiliz-mainnet' | 'cro-mainnet' | 'cro-testnet' | 'doge-mainnet' | 'doge-testnet' | 'egld-mainnet' | 'egld-testnet' | 'eos-mainnet' | 'eos-testnet' | 'ethereum-classic-mainnet' | 'ethereum-classic-testnet' | 'ethereum-mainnet' | 'ethereum-sepolia' | 'fantom-mainnet' | 'fantom-testnet' | 'flare-coston' | 'flare-coston2' | 'flare-mainnet' | 'flare-songbird' | 'kcs-mainnet' | 'kcs-testnet' | 'klaytn-baobab' | 'klaytn-cypress' | 'litecoin-mainnet' | 'litecoin-testnet' | 'monad-mainnet' | 'monad-testnet' | 'one-mainnet-s0' | 'one-testnet-s0' | 'optimism-mainnet' | 'optimism-testnet' | 'polygon-amoy' | 'polygon-mainnet' | 'ripple-mainnet' | 'ripple-testnet' | 'solana-devnet' | 'solana-mainnet' | 'sonic-blaze' | 'sonic-mainnet' | 'stellar-mainnet' | 'stellar-testnet' | 'tron-mainnet' | 'tron-testnet' | 'unichain-mainnet' | 'unichain-sepolia' | 'vechain-mainnet' | 'vechain-testnet' | 'xdc-mainnet' | 'xdc-testnet' | 'zcash-mainnet' | 'zcash-testnet' | 'gno-mainnet' | 'gno-testnet' | 'zksync-mainnet' | 'zksync-testnet' | 'rsk-mainnet' | 'rsk-testnet' | 'lisk-mainnet' | 'lisk-testnet', required - `hashOrHeight` string, required ## Response `200` OK - union - EVMBlock — EVM-style block object (Ethereum, BSC, Polygon, etc.). - `hash` string - `number` integer - `height` integer — Alias for number. - `parentHash` string - `timestamp` integer - `gasUsed` integer - `gasLimit` integer - `miner` string - `size` integer - `difficulty` string - `baseFeePerGas` string - `extraData` string - `transactions` EVMTransaction[] — Transaction objects with receipts (logs, status, etc.). - `hash` string - `transactionHash` string — Same as hash (for receipt merge). - `blockHash` string - `blockNumber` integer - `from` string - `to` string, nullable - `value` string — Value in native units (wei-like). - `gas` integer - `gasPrice` string - `maxFeePerGas` integer, nullable - `maxPriorityFeePerGas` integer, nullable - `nonce` integer - `transactionIndex` integer - `input` string — Input data hex. - `type` integer — Transaction type (0=legacy, 1=EIP-2930, 2=EIP-1559). - `accessList` unknown[] — Access list (EIP-2930/EIP-1559). - unknown - `chainId` integer, nullable - `yParity` string — Recovery id (0x0 or 0x1). - `gasUsed` integer, nullable - `effectiveGasPrice` integer, nullable - `cumulativeGasUsed` integer - `contractAddress` string, nullable — Created contract address (for contract creation txs). - `status` boolean — true if tx succeeded. - `logsBloom` string — Bloom filter for logs. - `logs` object[] — Event logs (when merged with receipt). - `address` string - `topics` string[] - `data` string - `blockNumber` integer - `transactionHash` string - `transactionIndex` integer - `blockHash` string - `logIndex` integer - `removed` boolean — true when log was removed (chain reorg). - `blockTimestamp` string — Block timestamp hex. - `fee` string, nullable — Paid fee in native units, if available. - UtxoBlock — UTXO-style block object (Bitcoin, Litecoin, Dogecoin). - `hash` string - `height` integer - `time` integer - `size` integer - `weight` integer - `bits` integer - `nonce` integer - `prevBlock` string - `merkleRoot` string - `nTx` integer - `txs` UTXOTransaction[] — Transaction objects with inputs/outputs. - `blockNumber` integer — Block height where the transaction was included. - `block` string — Block hash. - `fee` integer — Transaction fee in satoshis. - `hash` string — Transaction hash (txid). - `hex` string — Raw transaction hex. - `index` integer — Transaction index within the block. - `inputs` object[] — Transaction inputs. - `prevout` object - `hash` string — Previous output transaction hash. - `index` integer — Previous output index. - `sequence` integer - `script` string - `address` string, nullable — Present (null) for coinbase inputs; coin omitted in that case. - `coin` object — Spent output info (if available). - `version` integer - `height` integer - `value` union — Value in satoshis (number) or decimal string. - integer - string - `script` string - `address` string - `type` string — Script type (e.g. witness_v0_keyhash, pubkeyhash). - `reqSigs` integer, nullable - `coinbase` boolean - `locktime` integer - `outputs` object[] — Transaction outputs. - `value` union — Value in satoshis (number) or decimal string. - integer - string - `script` string - `address` string, nullable - `scriptPubKey` object - `type` string — Script type (e.g. witness_v0_keyhash, scripthash). - `reqSigs` integer, nullable - `size` integer — Transaction size in bytes. - `time` integer — Block timestamp (Unix seconds). - `version` integer - `vsize` integer — Virtual size in bytes. - `weight` integer — Transaction weight. - `witnessHash` string — Witness data hash (SegWit). - UtxoRawBlock — Raw node (bitcoind-style RPC) block object. Returned by Bitcoin Cash (bch-mainnet, bch-testnet) instead of the normalized UTXO format. Fields mirror the node's verbose getblock response; tx contains full raw transactions (see UtxoRawTransaction). - `hash` string - `confirmations` integer - `size` integer - `height` integer - `version` integer - `versionHex` string - `merkleroot` string - `tx` UtxoRawTransaction[] — Full raw transactions included in the block (node RPC format). - `txid` string - `hash` string - `version` integer - `size` integer - `locktime` integer - `vin` object[] — Transaction inputs (node RPC format). - `txid` string — Previous output transaction id (absent for coinbase inputs). - `vout` integer — Previous output index (absent for coinbase inputs). - `scriptSig` object - `asm` string - `hex` string - `coinbase` string — Present only on coinbase inputs. - `sequence` integer - `vout` object[] — Transaction outputs (node RPC format). - `value` number — Output value in whole coins (BCH), as returned by the node. - `n` integer - `scriptPubKey` object - `asm` string - `hex` string - `reqSigs` integer - `type` string - `addresses` string[] - `hex` string — Raw transaction hex. - `blockhash` string - `confirmations` integer - `time` integer - `blocktime` integer - `time` integer - `mediantime` integer - `nonce` integer - `bits` string - `difficulty` number - `chainwork` string - `nTx` integer - `previousblockhash` string - `nextblockhash` string - `ablastate` object — BCH ABLA (Adaptive Blocksize Limit Algorithm) state. - `epsilon` integer - `beta` integer - `blocksize` integer - `blocksizelimit` integer - `nextblocksizelimit` integer ## Other responses - `400` — Bad Request - `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header. - `403` — Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions. - `500` — Internal server error. There was an error on the server during the processing of the request. --- [API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)