Skip to main content

qn_getWalletTokenTransactions RPC Method

Returns transfers of a specified token within a specified wallet address. The API credit value for this method is 4.

Updated on
Jun 9, 2023

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