Skip to main content

/v1/blocks/by_height/:block_height:

This endpoint allows you to get the transactions in a block and the corresponding block information.

Transactions are limited by max default transaction size. If not all transactions are present, the user will need to query for the rest of the transactions via the get transactions API.

If the block is pruned, it will return a 410

Parameters​

  • block_height REQUIRED: (integer) - Block height to lookup. Starts at 0
  • with_transactions OPTIONAL: (boolean)- If set to true, include all transactions in the block

Returns​

  • A Block with or without transactions

Example​

Request

curl --request GET \
  --url https://aptos-mainnet.blastapi.io/<project-id>/v1/blocks/by_height/3700145 \
  --header 'Content-Type: application/json'

Result

{
  "block_height": "32425224034",
  "block_hash": "string",
  "block_timestamp": "32425224034",
  "first_version": "32425224034",
  "last_version": "32425224034",
  "transactions": [
    {
      "type": "pending_transaction",
      "hash": "string",
      "sender": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 ",
      "sequence_number": "32425224034",
      "max_gas_amount": "32425224034",
      "gas_unit_price": "32425224034",
      "expiration_timestamp_secs": "32425224034",
      "payload": {
        "type": "entry_function_payload",
        "function": "0x1::aptos_coin::transfer",
        "type_arguments": [
          "string"
        ],
        "arguments": [
          null
        ]
      },
      "signature": {
        "type": "ed25519_signature",
        "public_key": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 ",
        "signature": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "
      }
    }
  ]
}