NEAR RPC API - block method

v1.0.0

Base URL

https://near.nownodes.io

Returns detailed information about a specific block

Authentication

api-keyAuthapiKey

API Key: api-key in header

Block

Blocks

Get block details

POST

https://near.nownodes.io/

Returns information about a specific block. You can specify the block by its hash, height, or finality. Finality options: "optimistic" (latest block) or "final" (block that has been finalized by consensus).

Body

application/json

jsonrpcstring2required

JSON-RPC version specification

idstringrequired

Request identifier for matching responses

methodstringblockrequired

RPC method name

paramsobject | objectrequired

Block identification parameters

Response

200OK

Successful block information response

Authorization

api-keyAuthapiKey in header

Get block details

curl -X POST 'https://near.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "block-query-1",
    "method": "block",
    "params": {
      "finality": "final"
    }
  }'

const response = await fetch('https://near.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "block-query-1",
      "method": "block",
      "params": {
        "finality": "final"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "block-query-1",
  "method": "block",
  "params": {
    "finality": "final"
  }
}

response = requests.post('https://near.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": "block-query-1",
  "method": "block",
  "params": {
    "finality": "final"
  }
}

200

{
  "jsonrpc": "2.0",
  "id": "block-query-1",
  "result": {
    "author": "builder.near",
    "header": {
      "height": 178092345,
      "hash": "9RX6hTf8j8Q4q4L7z4L8q4L7z4L8q4L7z4L8q4L7z4L8",
      "prev_hash": "8QX5gSe7i7P3p3K6y3K7p3K6y3K7p3K6y3K7p3K6y3K7",
      "timestamp": 1704067200000000000,
      "epoch_id": "7QX6hTf8j8Q4q4L7z4L8q4L7z4L8q4L7z4L8q4L7z4L8",
      "next_epoch_id": "8RX6hTf8j8Q4q4L7z4L8q4L7z4L8q4L7z4L8q4L7z4L9",
      "chunks_included": 4
    },
    "chunks": [
      {
        "chunk_hash": "Chunk1Hash1234567890abcdef"
      },
      {
        "chunk_hash": "Chunk2Hash1234567890abcdef"
      }
    ]
  }
}

Receipt To Tx

EXPERIMENTAL_receipt_to_tx

Map receipt ID to originating transaction (EXPERIMENTAL)

POST

https://near.nownodes.io/

NEAR JSON-RPC call that returns the sender account and transaction hash for a given receipt ID.

Body

application/json

JSON-RPC 2.0 request envelope.

jsonrpcstringrequired

JSON-RPC protocol version. Must be "2.0".

idstring | integerrequired

Client-provided identifier to correlate request and response.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Method parameters.

Show child attributes

receipt_idstringrequired

Receipt identifier (base58-encoded) to be resolved to the originating transaction.

Response

200OK

Successful JSON-RPC response containing transaction information.

Authorization

api-keyAuthapiKey in header

Map receipt ID to originating transaction (EXPERIMENTAL)

curl -X POST 'https://near.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "EXPERIMENTAL_receipt_to_tx",
    "params": {
      "receipt_id": "2EK23qATK3XSXVrqxLLgqK7PHnwVKSPnbY6EdFGMQYcC"
    }
  }'

const response = await fetch('https://near.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "test",
      "method": "EXPERIMENTAL_receipt_to_tx",
      "params": {
        "receipt_id": "2EK23qATK3XSXVrqxLLgqK7PHnwVKSPnbY6EdFGMQYcC"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "EXPERIMENTAL_receipt_to_tx",
  "params": {
    "receipt_id": "2EK23qATK3XSXVrqxLLgqK7PHnwVKSPnbY6EdFGMQYcC"
  }
}

response = requests.post('https://near.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "EXPERIMENTAL_receipt_to_tx",
  "params": {
    "receipt_id": "2EK23qATK3XSXVrqxLLgqK7PHnwVKSPnbY6EdFGMQYcC"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "sender_account_id": "relay.aurora",
    "transaction_hash": "G3egSa6zdg2GtSGf5bkKtbFx4gFau1WkvJdxPNDntvUV"
  },
  "id": "test"
}

Documentation

Authentication

Block

Blocks

Body

Response

Authorization

Receipt To Tx

EXPERIMENTAL_receipt_to_tx

Body

Response

Authorization