Register and show off your project at Ethereum QuickPitch and win $10,000. Apply now


qn_getTransactionReceiptsByAddress RPC method

The API credit value for this method is 4 . To learn more about API credits and each method's value, visit the API Credits page.

Available Now! 🎉

This method is enabled on all Ethereum (Mainnet and Goerli) endpoints.
Try it out, and let us know what you think! Share your feedback in our Roadmap.
Learn more about this method in our step-by-step guide.


  1. Object - Custom Object with the following fields:

fromBlock - String or Integer - The hex or integer value of the "from" block.

toBlock - String or Integer (optional) - The hex or integer value of the "to" block.

fromAddresses - Array of Strings (optional) - The sender addresses.

toAddresses - Array of Strings (optional) - The reciever addresses.

accounts - Array of Strings (optional) - Note that if you use accounts, it ignores anything you have in fromAddresses and toAddresses.

hashOnly - Bool (optional) - This field can be used to return only hashes and not the actual transaction data.

ordering - String (optional) - If ordering is not specified, the ordering defaults to "asc".

page - Integer (optional)


  1. Result - Array of objects - An array of transaction receipts in the form of objects. Each object will include the following fields:

blockHash - String - The hash of the block where this transaction was in.

blockNumber - String - The block number where this transaction was in.

chainID - String - The chain id of the transaction, if any.

contractAddress - integer - The contract address.

cumulativeGasUsed - integer - The cumulative gas used.

effectiveGasPrice - String - The most effective gas price.

from - string - The "from" address.

gas - String - The gas provided, encoded as a hexadecimal.

gasPrice - string - The gas price used for each paid gas encoded as a hexadecimal.

gasUsed - string - The total used gas by all transactions in this block encoded as a hexadecimal.

input - array - The data sent along with the transaction.

logs - array - Array of log messages the transaction instructions output during execution.

logsBloom - string - The bloom filter for the logs of the block.

nonce - string - The number of transactions made by the sender before this one, encoded as hexadecimal.

r - string - The R field of the signature.

s - string - The S field of the signature.

status - string - Either 1 (success) or 0 (failure) encoded as a hexadecimal.

to - integer - The address of the receiver.

transactionHash - string - The transaction hash.

transactionIndex - integer - The transaction index.

type - string - The transaction type.

v - string - The standardized V field of the signature.

value - string - The value sent with this transaction, encoded as a hexadecimal.

Code Examples:

curl \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"qn_getTransactionReceiptsByAddress","params":[{"fromAddresses":["0x32135aeaB90aB298642921Fad2069d887349c823"],"hashOnly":false,"page":0}]}'
Ready to get started? Create a free account