Ethereum Node API v1.0.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

API gateway for interacting with an Ethereum node via standardized JSON-RPC methods

Base URLs:

Authentication

API Key (ApiKeyAuth)
- Parameter Name: X-API-Key, in: header. API key for authentication. Include your API key in the X-API-Key header.

Ethereum

Ethereum JSON-RPC gateway and helper endpoints

Check ETH node health

Code samples

GET /api/v1/eth/health

Performs a lightweight eth_blockNumber JSON-RPC call to the configured ETH node and returns basic health information.

Example responses

200 Response

{
  "status": "ok",
  "time": "2025-07-23T15:16:00Z",
  "blockNumber": "0x1234abcd"
}

Responses

Status	Meaning	Description	Schema
200	OK	ETH node is reachable and responding	Inline
500	Internal Server Error	ETH node URL is not configured or node is not reachable	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» status	string	false	none	none
» time	string(date-time)	false	none	none
» blockNumber	string	false	none	Current block number as hex QUANTITY from `eth_blockNumber`.

Status Code 500

Name	Type	Required	Restrictions	Description
» status	string	false	none	none
» message	string	false	none	none

Get latest Ethereum block

Code samples

GET /api/v1/eth/block/last

Returns the most recent block from the Ethereum blockchain using eth_getBlockByNumber with the latest tag.

Example responses

200 Response

{
  "number": "0x1234abcd",
  "hash": 0,
  "parentHash": "string",
  "nonce": "string",
  "sha3Uncles": "string",
  "logsBloom": "string",
  "transactionsRoot": "string",
  "stateRoot": "string",
  "receiptsRoot": "string",
  "miner": "string",
  "difficulty": "string",
  "totalDifficulty": "string",
  "extraData": "string",
  "size": "string",
  "gasLimit": "string",
  "gasUsed": "string",
  "timestamp": "string",
  "baseFeePerGas": "string",
  "transactions": [
    "string"
  ],
  "uncles": [
    "string"
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	Latest Ethereum block	EthBlock
500	Internal Server Error	Could not connect to ETH node	None

Get Ethereum block by number or tag

Code samples

GET /api/v1/eth/block/{blockNumber}

Returns a specific block by its number (decimal or hex QUANTITY) or by tag (latest, earliest, pending) using eth_getBlockByNumber.

Parameters

Name	In	Type	Required	Description
blockNumber	path	string	true	Block identifier: decimal height (e.g. `21000000`), hex QUANTITY (e.g. `0x1406f40`), or one of the tags `latest`, `earliest`, `pending`.

Example responses

200 Response

{
  "number": "0x1234abcd",
  "hash": 0,
  "parentHash": "string",
  "nonce": "string",
  "sha3Uncles": "string",
  "logsBloom": "string",
  "transactionsRoot": "string",
  "stateRoot": "string",
  "receiptsRoot": "string",
  "miner": "string",
  "difficulty": "string",
  "totalDifficulty": "string",
  "extraData": "string",
  "size": "string",
  "gasLimit": "string",
  "gasUsed": "string",
  "timestamp": "string",
  "baseFeePerGas": "string",
  "transactions": [
    "string"
  ],
  "uncles": [
    "string"
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	Ethereum block	EthBlock
500	Internal Server Error	Could not connect to ETH node	None

Get Ethereum block by hash

Code samples

GET /api/v1/eth/block/hash/{blockHash}

Returns a block by its hash using eth_getBlockByHash.

Parameters

Name	In	Type	Required	Description
blockHash	path	string	true	Ethereum block hash.

Example responses

200 Response

{
  "number": "0x1234abcd",
  "hash": 0,
  "parentHash": "string",
  "nonce": "string",
  "sha3Uncles": "string",
  "logsBloom": "string",
  "transactionsRoot": "string",
  "stateRoot": "string",
  "receiptsRoot": "string",
  "miner": "string",
  "difficulty": "string",
  "totalDifficulty": "string",
  "extraData": "string",
  "size": "string",
  "gasLimit": "string",
  "gasUsed": "string",
  "timestamp": "string",
  "baseFeePerGas": "string",
  "transactions": [
    "string"
  ],
  "uncles": [
    "string"
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	Ethereum block	EthBlock
500	Internal Server Error	Could not connect to ETH node	None

Get transaction count in block by number

Code samples

GET /api/v1/eth/block/{blockNumber}/transactions/count

Returns the number of transactions in a block identified by number or tag using eth_getBlockTransactionCountByNumber.

Parameters

Name	In	Type	Required	Description
blockNumber	path	string	true	Block number or tag (`latest`, `earliest`, `pending`).

Example responses

200 Response

{
  "transactionCount": "0x10"
}

Responses

Status	Meaning	Description	Schema
200	OK	Number of transactions in the block	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» transactionCount	string	false	none	Transaction count as hex QUANTITY.

Get transaction count in block by hash

Code samples

GET /api/v1/eth/block/hash/{blockHash}/transactions/count

Returns the number of transactions in a block identified by hash using eth_getBlockTransactionCountByHash.

Parameters

Name	In	Type	Required	Description
blockHash	path	string	true	Ethereum block hash.

Example responses

200 Response

{
  "transactionCount": "0x10"
}

Responses

Status	Meaning	Description	Schema
200	OK	Number of transactions in the block	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» transactionCount	string	false	none	Transaction count as hex QUANTITY.

List ETH accounts managed by node

Code samples

GET /api/v1/eth/account

Returns a list of addresses owned by the client using eth_accounts.

Example responses

200 Response

[
  9.743344248872686e+46
]

Responses

Status	Meaning	Description	Schema
200	OK	Array of Ethereum addresses	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Get ETH balance for address

Code samples

GET /api/v1/eth/account/{address}/balance

Returns the balance of an account at a given address using eth_getBalance.

Parameters

Name	In	Type	Required	Description
address	path	string	true	Ethereum address (0x-prefixed).
block	query	string	false	Block number as hex QUANTITY, or tag (`latest`, `earliest`, `pending`).

Example responses

200 Response

{
  "address": 9.743344248872686e+46,
  "block": "latest",
  "balance": "0x2386f26fc10000"
}

Responses

Status	Meaning	Description	Schema
200	OK	ETH balance information	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» address	string	false	none	none
» block	string	false	none	none
» balance	string	false	none	Balance in wei as hex QUANTITY from `eth_getBalance`.

Get transaction count (nonce) for address

Code samples

GET /api/v1/eth/account/{address}/nonce

Returns the transaction count (nonce) for an address using eth_getTransactionCount.

Parameters

Name	In	Type	Required	Description
address	path	string	true	Ethereum address (0x-prefixed).
block	query	string	false	Block number as hex QUANTITY, or tag (`latest`, `earliest`, `pending`).

Example responses

200 Response

{
  "address": "string",
  "block": "string",
  "transactionCount": "0x10"
}

Responses

Status	Meaning	Description	Schema
200	OK	Nonce information	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» address	string	false	none	none
» block	string	false	none	none
» transactionCount	string	false	none	Nonce as hex QUANTITY from `eth_getTransactionCount`.

Estimate gas for transaction

Code samples

POST /api/v1/eth/account/estimate-gas

Estimates the gas required for a transaction using eth_estimateGas.

Body parameter

{
  "transaction": {
    "from": "string",
    "to": "string",
    "gas": "string",
    "gasPrice": "string",
    "maxFeePerGas": "string",
    "maxPriorityFeePerGas": "string",
    "value": "string",
    "data": "string",
    "nonce": "string"
  },
  "block": "latest"
}

Parameters

Name	In	Type	Required	Description
body	body	object	true	none
» transaction	body	EthTransactionRequest	true	Ethereum transaction parameters used with `eth_call`, `eth_estimateGas` and `eth_sendTransaction`.
»» from	body	string	false	Sender address.
»» to	body	string¦null	false	Recipient address, or null for contract creation.
»» gas	body	string	false	Gas limit as hex QUANTITY.
»» gasPrice	body	string	false	Legacy gas price as hex QUANTITY.
»» maxFeePerGas	body	string	false	EIP-1559 max fee per gas as hex QUANTITY.
»» maxPriorityFeePerGas	body	string	false	EIP-1559 priority fee per gas as hex QUANTITY.
»» value	body	string	false	Amount of wei to send as hex QUANTITY.
»» data	body	string	false	Call data or contract deployment bytecode.
»» nonce	body	string	false	Nonce as hex QUANTITY.
» block	body	string	false	Optional block number or tag; defaults to `latest`.

Example responses

200 Response

{
  "gas": "0x5208"
}

Responses

Status	Meaning	Description	Schema
200	OK	Estimated gas	Inline
422	Unprocessable Entity	Invalid request body (missing or invalid `transaction`)	None
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» gas	string	false	none	Gas estimate as hex QUANTITY from `eth_estimateGas`.

Read-only contract call (eth_call)

Code samples

POST /api/v1/eth/account/call

Executes a read-only call to a contract using eth_call without creating a transaction.

Body parameter

{
  "transaction": {
    "from": "string",
    "to": "string",
    "gas": "string",
    "gasPrice": "string",
    "maxFeePerGas": "string",
    "maxPriorityFeePerGas": "string",
    "value": "string",
    "data": "string",
    "nonce": "string"
  },
  "block": "latest"
}

Parameters

Name	In	Type	Required	Description
body	body	object	true	none
» transaction	body	EthTransactionRequest	true	Ethereum transaction parameters used with `eth_call`, `eth_estimateGas` and `eth_sendTransaction`.
»» from	body	string	false	Sender address.
»» to	body	string¦null	false	Recipient address, or null for contract creation.
»» gas	body	string	false	Gas limit as hex QUANTITY.
»» gasPrice	body	string	false	Legacy gas price as hex QUANTITY.
»» maxFeePerGas	body	string	false	EIP-1559 max fee per gas as hex QUANTITY.
»» maxPriorityFeePerGas	body	string	false	EIP-1559 priority fee per gas as hex QUANTITY.
»» value	body	string	false	Amount of wei to send as hex QUANTITY.
»» data	body	string	false	Call data or contract deployment bytecode.
»» nonce	body	string	false	Nonce as hex QUANTITY.
» block	body	string	false	Optional block number or tag; defaults to `latest`.

Example responses

200 Response

{
  "result": "0x0000000000000000000000000000000000000000000000000000000000000001"
}

Responses

Status	Meaning	Description	Schema
200	OK	Raw return data from contract	Inline
422	Unprocessable Entity	Invalid request body (missing or invalid `transaction`)	None
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» result	string	false	none	Hex-encoded return data from `eth_call`.

Send transaction from node-managed account

Code samples

POST /api/v1/eth/account/send

Sends a transaction using eth_sendTransaction. The from account must be unlocked on the ETH node.

Body parameter

{
  "transaction": {
    "from": "string",
    "to": "string",
    "gas": "string",
    "gasPrice": "string",
    "maxFeePerGas": "string",
    "maxPriorityFeePerGas": "string",
    "value": "string",
    "data": "string",
    "nonce": "string"
  }
}

Parameters

Name	In	Type	Required	Description
body	body	object	true	none
» transaction	body	EthTransactionRequest	true	Ethereum transaction parameters used with `eth_call`, `eth_estimateGas` and `eth_sendTransaction`.
»» from	body	string	false	Sender address.
»» to	body	string¦null	false	Recipient address, or null for contract creation.
»» gas	body	string	false	Gas limit as hex QUANTITY.
»» gasPrice	body	string	false	Legacy gas price as hex QUANTITY.
»» maxFeePerGas	body	string	false	EIP-1559 max fee per gas as hex QUANTITY.
»» maxPriorityFeePerGas	body	string	false	EIP-1559 priority fee per gas as hex QUANTITY.
»» value	body	string	false	Amount of wei to send as hex QUANTITY.
»» data	body	string	false	Call data or contract deployment bytecode.
»» nonce	body	string	false	Nonce as hex QUANTITY.

Example responses

200 Response

{
  "transactionHash": 7.719472615821079e+76
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction accepted by node	Inline
422	Unprocessable Entity	Invalid request body (missing or invalid `transaction`)	None
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» transactionHash	string	false	none	Transaction hash returned by `eth_sendTransaction`.

Get Ethereum transaction by hash

Code samples

GET /api/v1/eth/transactions/{hash}

Returns transaction details using eth_getTransactionByHash.

Parameters

Name	In	Type	Required	Description
hash	path	string	true	Ethereum transaction hash.

Example responses

200 Response

{
  "hash": "string",
  "nonce": "string",
  "blockHash": "string",
  "blockNumber": "string",
  "transactionIndex": "string",
  "from": "string",
  "to": "string",
  "value": "string",
  "gas": "string",
  "gasPrice": "string",
  "maxFeePerGas": "string",
  "maxPriorityFeePerGas": "string",
  "input": "string",
  "type": "string",
  "chainId": "string",
  "v": "string",
  "r": "string",
  "s": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Ethereum transaction	EthTransaction
404	Not Found	Transaction not found	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 404

Name	Type	Required	Restrictions	Description
» error	string	false	none	none

Get Ethereum transaction receipt by hash

Code samples

GET /api/v1/eth/transactions/{hash}/receipt

Returns transaction receipt using eth_getTransactionReceipt.

Parameters

Name	In	Type	Required	Description
hash	path	string	true	Ethereum transaction hash.

Example responses

200 Response

{
  "transactionHash": "string",
  "transactionIndex": "string",
  "blockHash": "string",
  "blockNumber": "string",
  "from": "string",
  "to": "string",
  "cumulativeGasUsed": "string",
  "effectiveGasPrice": "string",
  "gasUsed": "string",
  "contractAddress": "string",
  "logs": [
    {
      "address": "string",
      "topics": [
        "string"
      ],
      "data": "string",
      "blockNumber": "string",
      "transactionHash": "string",
      "transactionIndex": "string",
      "blockHash": "string",
      "logIndex": "string",
      "removed": true
    }
  ],
  "logsBloom": "string",
  "status": "string",
  "type": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Ethereum transaction receipt	EthTransactionReceipt
404	Not Found	Transaction receipt not found	Inline
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 404

Name	Type	Required	Restrictions	Description
» error	string	false	none	none

Send pre-signed raw Ethereum transaction

Code samples

POST /api/v1/eth/transactions/send-raw

Sends a signed, RLP-encoded transaction using eth_sendRawTransaction.

Body parameter

{
  "rawTransaction": "0x..."
}

Parameters

Name	In	Type	Required	Description
body	body	object	true	none
» rawTransaction	body	string	true	Signed and RLP-encoded transaction.

Example responses

200 Response

{
  "transactionHash": 8.491419877403187e+76
}

Responses

Status	Meaning	Description	Schema
200	OK	Transaction hash returned by node	Inline
422	Unprocessable Entity	Invalid request body (missing `rawTransaction`)	None
500	Internal Server Error	Could not connect to ETH node	None

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» transactionHash	string	false	none	none

Generic JSON-RPC proxy to ETH node

Code samples

POST /api/v1/eth/jsonrpc

Proxies any valid Ethereum JSON-RPC 2.0 request to the configured ETH node. The request body is forwarded as-is and the node's response is returned.

Body parameter

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [
    null
  ],
  "id": null
}

Parameters

Name	In	Type	Required	Description
body	body	any	true	none

Example responses

200 Response

{}

Responses

Status	Meaning	Description	Schema
200	OK	JSON-RPC response from ETH node	Inline
500	Internal Server Error	ETH node URL is not configured or node is not reachable	EthJsonRpcError

Response Schema

Schemas

EthBlock

{
  "number": "0x1234abcd",
  "hash": 0,
  "parentHash": "string",
  "nonce": "string",
  "sha3Uncles": "string",
  "logsBloom": "string",
  "transactionsRoot": "string",
  "stateRoot": "string",
  "receiptsRoot": "string",
  "miner": "string",
  "difficulty": "string",
  "totalDifficulty": "string",
  "extraData": "string",
  "size": "string",
  "gasLimit": "string",
  "gasUsed": "string",
  "timestamp": "string",
  "baseFeePerGas": "string",
  "transactions": [
    "string"
  ],
  "uncles": [
    "string"
  ]
}

Ethereum block object as returned by eth_getBlockByNumber / eth_getBlockByHash. All numeric quantities are hex strings (QUANTITY).

Properties

Name	Type	Required	Restrictions	Description
number	string¦null	false	none	Block number as hex QUANTITY, or null for pending blocks.
hash	string¦null	false	none	Hash of the block, or null for pending blocks.
parentHash	string	false	none	Hash of the parent block.
nonce	string¦null	false	none	none
sha3Uncles	string	false	none	none
logsBloom	string¦null	false	none	none
transactionsRoot	string	false	none	none
stateRoot	string	false	none	none
receiptsRoot	string	false	none	none
miner	string	false	none	Address of the block proposer/miner.
difficulty	string	false	none	none
totalDifficulty	string	false	none	none
extraData	string	false	none	none
size	string	false	none	none
gasLimit	string	false	none	none
gasUsed	string	false	none	none
timestamp	string	false	none	Block timestamp as hex QUANTITY.
baseFeePerGas	string¦null	false	none	none
transactions	[oneOf]	false	none	Array of transaction hashes or transaction objects.

oneOf

Name	Type	Required	Restrictions	Description
» anonymous	string	false	none	none

xor

Name	Type	Required	Restrictions	Description
» anonymous	EthTransaction	false	none	Ethereum transaction object as returned by `eth_getTransactionByHash`.

continued

Name	Type	Required	Restrictions	Description
uncles	[string]	false	none	none

EthTransaction

{
  "hash": "string",
  "nonce": "string",
  "blockHash": "string",
  "blockNumber": "string",
  "transactionIndex": "string",
  "from": "string",
  "to": "string",
  "value": "string",
  "gas": "string",
  "gasPrice": "string",
  "maxFeePerGas": "string",
  "maxPriorityFeePerGas": "string",
  "input": "string",
  "type": "string",
  "chainId": "string",
  "v": "string",
  "r": "string",
  "s": "string"
}

Ethereum transaction object as returned by eth_getTransactionByHash.

Properties

Name	Type	Required	Restrictions	Description
hash	string	false	none	Transaction hash.
nonce	string	false	none	Nonce as hex QUANTITY.
blockHash	string¦null	false	none	none
blockNumber	string¦null	false	none	none
transactionIndex	string¦null	false	none	none
from	string	false	none	Sender address.
to	string¦null	false	none	Recipient address, or null for contract creation.
value	string	false	none	Amount of wei sent, as hex QUANTITY.
gas	string	false	none	none
gasPrice	string¦null	false	none	none
maxFeePerGas	string¦null	false	none	none
maxPriorityFeePerGas	string¦null	false	none	none
input	string	false	none	Input data (call data) as hex string.
type	string	false	none	Transaction type (0x0 legacy, 0x1, 0x2, 0x3...)
chainId	string¦null	false	none	none
v	string	false	none	none
r	string	false	none	none
s	string	false	none	none

EthLog

{
  "address": "string",
  "topics": [
    "string"
  ],
  "data": "string",
  "blockNumber": "string",
  "transactionHash": "string",
  "transactionIndex": "string",
  "blockHash": "string",
  "logIndex": "string",
  "removed": true
}

Ethereum log object from transaction receipt.

Properties

Name	Type	Required	Restrictions	Description
address	string	false	none	none
topics	[string]	false	none	none
data	string	false	none	none
blockNumber	string	false	none	none
transactionHash	string	false	none	none
transactionIndex	string	false	none	none
blockHash	string	false	none	none
logIndex	string	false	none	none
removed	boolean	false	none	none

EthTransactionReceipt

{
  "transactionHash": "string",
  "transactionIndex": "string",
  "blockHash": "string",
  "blockNumber": "string",
  "from": "string",
  "to": "string",
  "cumulativeGasUsed": "string",
  "effectiveGasPrice": "string",
  "gasUsed": "string",
  "contractAddress": "string",
  "logs": [
    {
      "address": "string",
      "topics": [
        "string"
      ],
      "data": "string",
      "blockNumber": "string",
      "transactionHash": "string",
      "transactionIndex": "string",
      "blockHash": "string",
      "logIndex": "string",
      "removed": true
    }
  ],
  "logsBloom": "string",
  "status": "string",
  "type": "string"
}

Ethereum transaction receipt object from eth_getTransactionReceipt.

Properties

Name	Type	Required	Restrictions	Description
transactionHash	string	false	none	none
transactionIndex	string	false	none	none
blockHash	string	false	none	none
blockNumber	string	false	none	none
from	string	false	none	none
to	string¦null	false	none	none
cumulativeGasUsed	string	false	none	none
effectiveGasPrice	string	false	none	none
gasUsed	string	false	none	none
contractAddress	string¦null	false	none	none
logs	[EthLog]	false	none	[Ethereum log object from transaction receipt.]
logsBloom	string	false	none	none
status	string	false	none	0x1 for success, 0x0 for failure.
type	string	false	none	none

EthTransactionRequest

{
  "from": "string",
  "to": "string",
  "gas": "string",
  "gasPrice": "string",
  "maxFeePerGas": "string",
  "maxPriorityFeePerGas": "string",
  "value": "string",
  "data": "string",
  "nonce": "string"
}

Ethereum transaction parameters used with eth_call, eth_estimateGas and eth_sendTransaction.

Properties

Name	Type	Required	Restrictions	Description
from	string	false	none	Sender address.
to	string¦null	false	none	Recipient address, or null for contract creation.
gas	string	false	none	Gas limit as hex QUANTITY.
gasPrice	string	false	none	Legacy gas price as hex QUANTITY.
maxFeePerGas	string	false	none	EIP-1559 max fee per gas as hex QUANTITY.
maxPriorityFeePerGas	string	false	none	EIP-1559 priority fee per gas as hex QUANTITY.
value	string	false	none	Amount of wei to send as hex QUANTITY.
data	string	false	none	Call data or contract deployment bytecode.
nonce	string	false	none	Nonce as hex QUANTITY.

EthJsonRpcRequest

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [
    null
  ],
  "id": null
}

Generic Ethereum JSON-RPC 2.0 request.

Properties

Name	Type	Required	Restrictions	Description
jsonrpc	string	true	none	none
method	string	true	none	Ethereum JSON-RPC method name (e.g. `eth_blockNumber`).
params	[any]	true	none	Positional parameters for the method.
id	any	false	none	Request identifier (string, number, or null).

Enumerated Values

Property	Value
jsonrpc	2.0

EthJsonRpcError

{
  "error": {
    "code": -32603,
    "message": "Failed to connect to ETH node"
  }
}

Error response used when ETH JSON-RPC proxy fails.

Properties

Name	Type	Required	Restrictions	Description
error	object	false	none	none
» code	integer	false	none	none
» message	string	false	none	none