Robinhood Chain JSON-RPC API
v1.0.0https://robinhood.nownodes.ioNOWNodes Robinhood Chain JSON-RPC endpoint.https://eth.nownodes.iohttps://optimism-index.nownodes.ioAuthentication
api-keyAuthapiKeyNOWNodes API key passed in the api-key header.
API Key: api-key in header
MAINNET / DEBUG
debug_getBadBlocks
debug_getBadBlocks operations.
debug_getBadBlocks
Get bad blocks.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for debug_getBadBlocks.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<any>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
List of bad blocks
Bad Request
Internal Server Error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
debug_getTrieFlushInterval
debug_getTrieFlushInterval operations.
Get trie flush interval
Retrieves the current value of in-memory trie flush interval.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for Get trie flush interval.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<any>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
Current trie flush interval value
Bad Request
Internal Server Error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
debug_storageRangeAt
debug_storageRangeAt operations.
Get contract storage range
Returns the contract storage for the specified range at a given block and transaction index.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for Get contract storage range.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<string | integer>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
Contract storage range data
Bad Request
Internal Server Error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
debug_traceBlockByHash
debug_traceBlockByHash operations.
Trace block by hash
Returns the possible tracing result number by executing all transactions in the block specified by the block hash with a tracer.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for Trace block by hash.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<string | object>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
Block transaction traces by hash
Bad Request
Internal Server Error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
debug_traceBlockByNumber
debug_traceBlockByNumber operations.
Trace block by number
Returns the tracing result by executing all transactions in the block specified by number with a tracer.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for Trace block by number.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<string | object>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
Block transaction traces by number
Bad Request
Internal Server Error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
debug_traceCall
debug_traceCall operations.
Trace call execution
Returns the number of possible tracing result by executing an eth call within the context of the given block execution.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for Trace call execution.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<object | string>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
Call execution trace
Bad Request
Internal Server Error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
debug_traceTransaction
debug_traceTransaction operations.
Trace transaction execution
Returns all traces of a given transaction.
Body
JSON-RPC 2.0 request to the Robinhood Chain mainnet endpoint.
Request payload for Trace transaction execution.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredJSON-RPC method name.
paramsArray<string | object>requiredJSON-RPC method parameters.
idintegerrequiredClient-provided request identifier echoed in the response.
Response
Successful trace response
Upstream node or gateway error.
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
MAINNET / EVM
eth_accounts
Ethereum method - eth_accounts
Returns an array of addresses controlled by the client.
Body
jsonrpcstringrequiredJSON-RPC version identifier
methodstringrequiredName of the JSON-RPC method
paramsarrayrequiredNo parameters are required for this method. This must be an empty array.
idintegerrequiredUnique identifier for the JSON-RPC request
Response
A list of Ethereum addresses
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_blockNumber
Ethereum method - eth_blockNumber
Returns the number of the latest block on the chain in hexadecimal format.
Body
jsonrpcstringrequiredThe JSON-RPC protocol version
methodstringrequiredName of the method being called
paramsarrayrequiredThis method does not take parameters; always send an empty array.
idintegerrequiredA unique ID for the request
Response
The latest block number
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_call
Ethereum method - eth_call
Executes a call to a contract or address and returns the result without broadcasting a transaction.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object | string>requiredThe first object specifies the call transaction object. The second (optional) parameter specifies the block context.
idintegerrequiredResponse
Result of the call
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_chainId
Ethereum method - eth_chainId
Returns the hexadecimal string of the current chain ID.
Body
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredName of the method to call
paramsarrayrequiredThis method does not require parameters. Use an empty array.
idintegerrequiredUnique identifier for the request
Response
Chain ID response
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_coinbase
eth_coinbase
Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).
Body
jsonrpcstringrequiredmethodstringeth_coinbaserequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC Response with the coinbase address
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_estimateGas
Estimate Gas for Transaction
Simulates a transaction and returns an estimate of how much gas would be used.
Body
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredThe method name
paramsArray<object | string>requiredThe transaction call object and an optional block tag.
idintegerrequiredRequest identifier
Response
Estimated gas amount
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_feeHistory
eth_feeHistory
Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string | integer | Array<number>>requiredParameters:
blockCount— number of blocks in the requested range.newestBlock— highest block number in the requested range (can be "latest").rewardPercentiles— list of percentile values to sample priority fees from each block (optional).
idintegerrequiredResponse
JSON-RPC Response with fee history data
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_gasPrice
Get Suggested Gas Price
Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsarrayrequiredThis method takes an empty array.
idintegerrequiredRequest identifier
Response
Suggested gas price in wei
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getBalance
Get ETH Balance of an Address
Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string | string>requiredArray with 2 parameters:
- Address (20-byte hex string with '0x' prefix)
- Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)
idintegerrequiredRequest ID
Response
Balance (in wei) as hex string
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getBlockByHash
Get Block by Hash
Returns the block information for the specified block hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string | boolean>requiredArray with 2 parameters:
- Block hash (32-byte hex string with '0x' prefix)
- Boolean to specify if full transaction objects are returned (
true) or only transaction hashes (false)
idintegerrequiredRequest ID
Response
Block information
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getBlockByNumber
Get Block by Number
Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string | boolean>requiredArray with 2 parameters:
- Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
- Boolean to specify if full transaction objects are returned (
true) or only transaction hashes (false)
idintegerrequiredRequest ID
Response
Block information
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getBlockReceipts
Get All Transaction Receipts for a Block
Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredOne parameter:
- Block identifier, which can be either:
- block number as hex string (e.g. "0x10d4f")
- or block hash as hex string (0x-prefixed)
idintegerrequiredRequest identifier
Response
Array of transaction receipts in the block
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getBlockTransactionCountByHash
Get Transaction Count by Block Hash
Returns the number of transactions contained in the block with the given hash.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray containing a single parameter:
- Block hash as a hex string (32 bytes with 0x prefix)
idintegerrequiredRequest ID
Response
Number of transactions in the block
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getBlockTransactionCountByNumber
Get Transaction Count by Block Number
Returns the number of transactions contained in the block with the given block number.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray containing a single parameter:
- Block number as a hex string (e.g. "0x10d4f" for block 69007) or
- predefined block tags such as "latest", "earliest", or "pending"
idintegerrequiredRequest ID
Response
Number of transactions in the block
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getCode
Get Contract Bytecode at Address
Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with two elements:
- The address to get the code for (hex string, 0x-prefixed).
- The block number or block tag (e.g., "latest", "earliest", "pending").
idintegerrequiredRequest identifier.
Response
Contract bytecode in hex format
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getFilterChanges
Get Filter Changes
Returns an array of logs that occurred since the last poll for the specified filter ID. The filter must have been previously created with eth_newFilter or eth_newBlockFilter or eth_newPendingTransactionFilter.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with a single element:
- The filter ID (hex string).
idintegerrequiredRequest identifier.
Response
Array of log objects or transaction hashes depending on filter type
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getFilterLogs
Get Filter Logs
Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with one element:
- The filter ID (hex string).
idintegerrequiredRequest identifier.
Response
Array of log objects matching the filter
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getLogs
Get Logs
Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<object>requiredParameters array with one element: the filter object.
idintegerrequiredRequest identifier.
Response
Array of log objects matching the filter
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getStorageAt
Get Storage At
Returns the value stored at position in the storage of the contract at address at the given blockNumber.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array:
- address: string - Contract address to query storage from.
- position: string - Storage slot position (hex string).
- block number: string - Block number or keywords ("latest", "earliest", "pending").
idintegerrequiredRequest identifier.
Response
Storage slot value at the specified position
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getTransactionByBlockHashAndIndex
Get Transaction by Block Hash and Index
Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredParameters:
- blockHash (string): The 32-byte hash of the block.
- transactionIndex (string): The transaction index (hex).
idintegerrequiredResponse
A transaction object or null if no transaction was found.
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getTransactionByBlockNumberAndIndex
Get Transaction by Block Number and Index
Returns the information about a transaction using the block number and the transaction index within the block.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredParameters:
- Block number in hex format (e.g., "0x5daf3b")
- Transaction index in the block (e.g., "0x0")
idintegerrequiredResponse
A transaction object, or null if not found.
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getTransactionByHash
Get transaction by hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredArray containing a single transaction hash
idintegerrequiredResponse
Transaction object or null
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getTransactionCount
Get transaction count (nonce) for address
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>required- address: The address to check for transaction count.
- block: The block parameter (e.g., "latest", "earliest", "pending").
idintegerrequiredResponse
Hex encoded nonce (transaction count)
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getTransactionReceipt
Get transaction receipt by hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredidintegerrequiredResponse
Transaction receipt if mined, otherwise null
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getUncleByBlockHashAndIndex
Get uncle block by block hash and index
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredblockHash: 32-byte block hashindex: the uncle index as hex (e.g., "0x0" for the first uncle)
idintegerrequiredResponse
Uncle block object or null
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getUncleByBlockNumberAndIndex
Get uncle block by block number and index
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredblockNumber: The block number as hex string (e.g., "0x10fb78"), or "latest", "earliest", "pending".index: The uncle index as hex (e.g., "0x0" for the first uncle).
idintegerrequiredResponse
Uncle block object or null
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getUncleCountByBlockHash
Get the number of uncle blocks by block hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredAn array containing the block hash.
idintegerrequiredResponse
Number of uncles in the block
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_getUncleCountByBlockNumber
Get the number of uncle blocks by block number
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredAn array containing the block number as a hex string.
idintegerrequiredResponse
Number of uncle blocks in the block
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_hashrate
eth_hashrate
Returns the current mining hashrate reported by the client.
Body
jsonrpcstringrequiredmethodstringeth_hashraterequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the current mining hashrate
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_maxPriorityFeePerGas
Get recommended maxPriorityFeePerGas value
Body
jsonrpcstringrequiredmethodstringrequiredparamsarrayrequiredNo parameters are required.
idintegerrequiredResponse
Returns the suggested maxPriorityFeePerGas value
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_mining
eth_mining
Checks whether the Ethereum client is actively mining.
Body
jsonrpcstringrequiredmethodstringeth_miningrequiredparamsarrayrequiredThis method does not accept parameters.
idintegerrequiredResponse
JSON-RPC Response indicating mining status
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_newBlockFilter
Create a new block filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<any>requiredThis method does not require any parameters.
idintegerrequiredResponse
Filter ID created successfully
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_newFilter
Create a new log filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object>requiredArray with one object describing the filter options.
idintegerrequiredResponse
Filter ID created successfully
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_newPendingTransactionFilter
Create a filter for pending transactions
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<any>requiredNo parameters required for this method
idintegerrequiredRequest identifier
Response
Filter ID created successfully
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_sendRawTransaction
Send a raw signed transaction
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredMethod name
paramsArray<string>requiredArray containing a single signed transaction data (hex string)
idintegerrequiredRequest ID
Response
Transaction successfully sent
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_sendTransaction
Send a transaction using node-managed account
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object>requiredTransaction object
idintegerrequiredResponse
Transaction successfully sent
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_sign
Sign arbitrary data using eth_sign
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>required[address, data]
- address: The account that will sign the data
- data: The data to be signed (must be a hex string)
idintegerrequiredResponse
Returns the signature of the message
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_signTransaction
eth_signTransaction
Signs a transaction locally with the private key of the specified account.
Body
jsonrpcstringrequiredmethodstringeth_signTransactionrequiredparamsArray<object>requiredArray with a single object representing the transaction to sign.
idintegerrequiredResponse
JSON-RPC response with the signed transaction data
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_syncing
Check if node is syncing
Body
jsonrpcstringrequiredmethodstringrequiredparamsarrayrequiredMust be an empty array.
idintegerrequiredResponse
Returns sync status object or false
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
eth_uninstallFilter
Uninstall an existing filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredidintegerrequiredResponse
Success or failure of the uninstall operation
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
net_listening
net_listening
Checks if the client is listening for network connections.
Body
jsonrpcstringrequiredmethodstringnet_listeningrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with listening status
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
net_peerCount
net_peerCount
Returns the number of peers currently connected to the client.
Body
jsonrpcstringrequiredmethodstringnet_peerCountrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the number of connected peers
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
net_version
net_version
Returns the current network ID of the Ethereum client.
Body
jsonrpcstringrequiredmethodstringnet_versionrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the current network ID
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
web3_clientVersion
web3_clientVersion
Returns the current Ethereum client version.
Body
jsonrpcstringrequiredmethodstringweb3_clientVersionrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the client version string
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
web3_sha3
web3_sha3
Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.
Body
jsonrpcstringrequiredmethodstringweb3_sha3requiredparamsArray<string>requiredArray containing a single hex-encoded data string to hash.
idintegerrequiredResponse
JSON-RPC response with the Keccak-256 hash of the input data
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
MAINNET / Index
Index
Get Blockbook backend info
Returns general metadata and status about the Blockbook service and its connected backend node.
Response
Successfully retrieved Blockbook info
Internal error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get block hash by block height
Returns the block hash corresponding to the specified block height.
Parameters
heightinteger>= 0requiredpathThe height of the block (e.g., 800000)
Response
Successfully retrieved block hash
Block not found at given height
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get specific transaction details
Returns full decoded transaction data for a given transaction ID.
Parameters
txidstringrequiredpathTransaction ID (txid) to look up
Response
Successful response with transaction details
Transaction not found
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get address information
Returns detailed information about a Optimism address such as balance, total received and sent, unconfirmed transactions, list of txids, and more. Supports pagination and filtering by block height and details.
Parameters
addressstringrequiredpathOptimism address to query.
pageinteger1queryPage number for pagination (default is 1).
pageSizeinteger1000queryNumber of items per page (default 1000).
fromintegerqueryStarting block height to filter transactions (optional).
tointegerqueryEnding block height to filter transactions (optional).
detailsstringbasictokenstokenBalancestxidstxsqueryLevel of transaction detail to return. Options:
- basic: Basic transaction info.
- tokens: Include token info.
- tokenBalances: Include token balances.
- txids: Return only transaction IDs.
- txs: Return full transaction details.
contractstringqueryFilter by contract address (optional).
secondarystringqueryInclude secondary currency balances (e.g., USD).
Response
Successful response with address details
Invalid address or bad request
Address not found
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get XPUB or descriptor details
Retrieves detailed information about an XPUB or descriptor including confirmed balance, total received and sent amounts, unconfirmed balances, transaction counts, tokens used, and paginated transaction IDs.
Parameters
xpubOrDescriptorstringrequiredpathXPUB or descriptor to query.
pageinteger1queryPage number for pagination (default is 1).
pageSizeinteger1000queryNumber of items per page (default 1000).
fromintegerqueryStarting block height to filter transactions (optional).
tointegerqueryEnding block height to filter transactions (optional).
detailsstringbasictokenstokenBalancestxidstxsqueryLevel of transaction detail to return. Options:
- basic: Basic transaction info.
- tokens: Include token info.
- tokenBalances: Include token balances.
- txids: Return only transaction IDs.
- txs: Return full transaction details.
tokensstringnonzerousedderivedqueryFilter tokens by usage type:
- nonzero: Tokens with non-zero balances.
- used: Tokens that have been used.
- derived: Tokens derived from this XPUB.
secondarystringqueryInclude secondary currency balances (e.g., EUR).
Response
Successful response with XPUB details
Invalid XPUB or bad request
XPUB not found
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get UTXOs for address, XPUB or descriptor
Retrieves the unspent transaction outputs (UTXOs) associated with a specific address, XPUB, or descriptor. Optionally filter only confirmed UTXOs by using the confirmed query parameter.
Parameters
addressOrXpubOrDescriptorstringrequiredpathAddress, XPUB or descriptor to query UTXOs for.
confirmedbooleanfalsequeryIf true, only return confirmed UTXOs. Defaults to false (returns both confirmed and unconfirmed).
Response
List of UTXOs for the given address, XPUB, or descriptor
Invalid address or parameter error
No UTXOs found for the specified input
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get block details by height or hash
Returns detailed information about a block specified by its height or hash.
Parameters
blockHeightOrHashstringrequiredpathBlock height (integer) or block hash (string) to identify the block.
Response
Block details response
Invalid block height or hash format
Block not found
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Broadcast raw transaction
Sends a raw transaction to the blockchain network. The transaction must be provided as a hex-encoded string in the URL path.
Parameters
hexTxDatastringrequiredpathHex-encoded raw transaction data to be broadcasted.
Response
Transaction broadcast successful
Invalid transaction hex data
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get list of tickers updated since timestamp
Returns an array of ticker objects representing cryptocurrency prices updated since the specified UNIX timestamp (in seconds).
Parameters
timestampintegerqueryUNIX timestamp (in seconds). Only tickers updated after this time are returned.
Response
List of tickers
Invalid timestamp parameter
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.
Get balance history for an address or XPUB
Returns the balance history for the specified address or XPUB between the from and to date parameters. The balances can be optionally converted to a specified fiat currency and grouped by time intervals.
Parameters
accountstringrequiredpathXPUB or address to query balance history for
fromstring<date-time>requiredqueryStart date (ISO 8601 format, e.g. 2023-01-01T00:00:00Z)
tostring<date-time>requiredqueryEnd date (ISO 8601 format, e.g. 2023-01-10T00:00:00Z)
fiatcurrencystringqueryFiat currency code to convert balances (e.g., USD, EUR). Optional.
groupByintegerqueryGroup results by time interval in seconds (e.g., 86400 for daily). Optional.
Response
Balance history retrieved successfully
Invalid or missing parameters
Internal server error
Authorization
api-keyAuthapiKey in headerNOWNodes API key passed in the api-key header.