/v1/blocks/by_height/{block_height}

1 curl https://aptos-mainnet.alchemy-blast.com/v2/:apiKey/v1/blocks/by_height/3700145

1 { 2 "block_height": "32425224034", 3 "block_hash": "string", 4 "block_timestamp": "32425224034", 5 "first_version": "32425224034", 6 "last_version": "32425224034", 7 "transactions": [ 8 { 9 "type": "pending_transaction", 10 "hash": "string", 11 "sender": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1", 12 "sequence_number": "32425224034", 13 "max_gas_amount": "32425224034", 14 "gas_unit_price": "32425224034", 15 "expiration_timestamp_secs": "32425224034", 16 "payload": { 17 "type": "entry_function_payload", 18 "function": "0x1::aptos_coin::transfer", 19 "type_arguments": [ 20 "string" 21 ], 22 "arguments": [ 23 null 24 ] 25 }, 26 "signature": { 27 "type": "ed25519_signature", 28 "public_key": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1", 29 "signature": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1" 30 } 31 } 32 ] 33 }

Retrieves block metadata and optionally the transactions contained in the block. If the block is pruned, the server will return a 410 error. To avoid partial results when with_transactions=true, consider checking the total number of transactions expected.

⚠ This endpoint is only available with Blast access.

Path parameters

block_heightintegerRequired

Block height to look up. Starts at 0.

Query parameters

with_transactionsbooleanOptional

If set to true, includes all transactions in the block. May be limited by max transaction size.

Response

Block data with or without transactions.

block_heightstring or null

block_hashstring or null

block_timestampstring or null

first_versionstring or null

last_versionstring or null

transactionslist of objects or null