Get blocks by height

get https://api.shinami.com/aptos/node/v1/blocks/by_height/{block_height}

Description

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

Transactions are limited by max default transactions 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.

Authentication

Authentication is via an 'Authorization: Bearer YOUR_API_ACCESS_KEY' header (which you must add to the sample requests).

Responses

Response body

object

block_height

string

required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such
as JavaScript that do not parse u64s in JSON natively.

block_hash

string

required

block_timestamp

string

required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such
as JavaScript that do not parse u64s in JSON natively.

first_version

string

required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such
as JavaScript that do not parse u64s in JSON natively.

last_version

string

required

A string containing a 64-bit unsigned integer.

We represent u64 values as a string to ensure compatibility with languages such
as JavaScript that do not parse u64s in JSON natively.

transactions

array of objects

The transactions in the block in sequential order

transactions

Headers

object

X-APTOS-CHAIN-ID

uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

uint64

Current timestamp of the chain

X-APTOS-EPOCH

uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

uint64

The cost of the call in terms of gas

X-APTOS-CURSOR

string

Cursor to be used for endpoints that support cursor-based
pagination. Pass this to the start field of the endpoint
on the next call to get the next page of results.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.shinami.com/aptos/node/v1/blocks/by_height/block_height \
3
     --header 'accept: application/json'


xxxxxxxxxx
939
}
1
{
2
  "block_height": "32425224034",
3
  "block_hash": "0xfa518597d5527bb3240524c47c6afbfc1f52c665bc35616f7eddf72b56bb778e",
4
  "block_timestamp": "32425224034",
5
  "first_version": "32425224034",
6
  "last_version": "32425224034",
7
  "transactions": [
8
    {
9
      "type": "pending_transaction",
10
      "hash": "0xfa518597d5527bb3240524c47c6afbfc1f52c665bc35616f7eddf72b56bb778e",
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
      },
24
      "signature": {
25
        "type": "ed25519_signature",

200

400

403

404

410

500

503