We're now supporting Polygon zkEVM!
Learn more here.


qn_getWalletTokenTransactions 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.

Please note that this RPC method requires the Token API add-on enabled on your QuickNode endpoint. Also, it supports ERC-20 compliant contracts (on Ethereum mainnet).


  1. object - The custom object with the following fields:

    address - string - The wallet address we want to check for transfers

    contract - string - The ERC-20 contract we want to check for transfers

    fromBlock - string - The first block number to check for transfers (inclusive). If omitted, will default to the genesis block for the provided token contract address

    toBlock - string - (optional) The last block number to check for transfers (inclusive). If omitted, will default to the latest block

    page - string - (optional) The page number you would like returned. The page numbers start at 1 and end at totalPages. If omitted, defaults to the first page (page 1). If the page number requested is higher than totalPages, an empty assets array will be returned. If the page number requested is less than 1, an invalid params response will be returned

    perPage - string - (optional) The maximum amount of transfers to return on each page. You can request up to 100 transfers per page. If omitted, defaults to 40 transfers per page


  1. object - The custom response object containing token details and array of transfers, or an empty array if no transfers are found:

    token - An object containing information about the token with the following shape:

    address - The contract address of the token

    decimals - The number of decimals this token supports

    genesisBlock - The block number in which this contract was deployed

    genesisTransaction - The hash of the transaction in which this contract was deployed

    name - The name of this token

    symbol - The symbol for this token

    transfers - An array of objects representing token transfers with the following shape:

    amount - The raw amount of token transferred

    blockNumber - The block number within which this transfer occurred

    date - The date that this transfer occurred

    from - The address for the sender of this transfer

    logIndex - The log index of this transfer within the transaction in which it occurred

    to - The address for the receiver of this transfer

    txHash - The token transfer transaction hash

    valueSent - The amount of Ethereum send within the underlying transaction

    pageNumber - The page number of results that was returned with this response

    totalItems - The total number of results

    totalPages - The total number of results pages available

Code Examples:

# The eth.rb library does not support including additional request headers, so you won't be able to add the x-qn-api-version header.

require 'eth'

client = Eth::Client.create 'http://sample-endpoint-name.network.quiknode.pro/token-goes-here/'

payload = {
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
      "page": 1,
      "perPage": 10

response = client.send(payload.to_json)
puts response
Ready to get started? Create a free account