qn_getWalletTokenTransactions RPC Method

Please note that this RPC method supports ERC-20 compliant contracts (on Ethereum mainnet). We are in the process of deprecating V1 and strongly encourage all developers to migrate to our NFT and Token API v2 bundle for improved functionalities and broader chain compatibility.

Parameters

object

array

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

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

page

string

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

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

Returns

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

Request

1
curl https://docs-demo.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  -H "x-qn-api-version: 1" \
5
  --data '{
6
    "id":67,
7
    "jsonrpc":"2.0",
8
    "method":"qn_getWalletTokenTransactions",
9
    "params":{
10
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
11
      "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
12
      "page": 1,
13
      "perPage": 10
14
    }
15
  }'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free