Skip to main content

qn_getWalletTokenTransactions (v2) RPC Method

Returns transfers of a specified token within a specified wallet address.

Updated on
Nov 2, 2023

qn_getWalletTokenTransactions (v2) RPC Method

Please note that this RPC method requires the Token and NFT API v2 bundle add-on enabled on your QuickNode endpoint. This method will return pagination for up to 1000 results. The fromBlock and toBlock parameters can be used for historical data.

Parameters

array
array
An array with the first element being:
object
A custom object with the following fields:
address
string
The wallet address or ENS name 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:
address
string
The address we checked for transfers
ensName
string
The ENS name associated with the address we checked
token
An object containing information about the token with the following shape:
address
string
The address associated with the token
genesisBlock
number
The genesis block for the token
genesisTransaction
string
The genesis transaction for the token
name
string
The name of the token
symbol
string
The symbol of the token
decimals
string
The number of decimals the token uses
contractAddress
string
The contract address of the token
transfers
An array of objects representing token transfers with the following shape:
timestamp
string
The timestamp of the transaction
blockNumber
string
The block number within which this transfer occurred
transactionHash
string
The token transfer transaction hash
sentTokenContractAddress
string
The contract address of the sent token
toAddress
string
The address for the receiver of this transfer
receivedTokenContractAddress
string
The contract address of the received token
fromAddress
string
The address of the sender of this transfer
logIndex
number
The log index for this transfer
type
string
The type of event, i.e., 'MINT', 'SALE', 'TRANSFER'
sentAmount
string
The sent token amount
decimalSentAmount
string
The sent amount in decimals
receivedAmount
string
The received token amount
decimalReceivedAmount
string
The received amount in decimals
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
--data '{
5
"id":67,
6
"jsonrpc":"2.0",
7
"method":"qn_getWalletTokenTransactions",
8
"params": [{
9
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
"contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
11
"page": 1,
12
"perPage": 10
13
}]
14
}'
15
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free