Skip to main content

qn_getWalletTokenTransactions (v2) RPC Method - Token and NFT API

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

Updated on
Aug 09, 2026
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

object
object
REQUIRED

A custom object with the following fields:

address
string
REQUIRED

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
integer

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
integer

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
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
object

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

paginatedItems
array

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
integer

The page number of results that was returned with this response

totalItems
integer

The total number of results

totalPages
integer

The total number of results pages available

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 67,
4
"result": {
5
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
"ensName": "vitalik.eth",
7
"paginatedItems": [
8
{
9
"timestamp": "2024-11-24T16:42:59.000Z",
10
"blockNumber": "21258873",
11
"transactionHash": "0xca57c78b32f9512bde35dfd1621ccd7e758b679ce0264e4d9f5494d1b09d8bce",
12
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
13
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
14
"receivedTokenContractAddress": null,
15
"fromAddress": "0xdd4c573e3b8f0b7db5a88b9b49a40105e10120e6",
16
"logIndex": 68,
17
"type": "TRANSFER",
18
"sentAmount": "1111000000000000000000",
19
"decimalSentAmount": "1111",
20
"receivedAmount": "0",
21
"decimalReceivedAmount": "0"
22
},
23
{
24
"timestamp": "2024-11-17T11:17:59.000Z",
25
"blockNumber": "21207077",
26
"transactionHash": "0x520bc0cecd9f028428967e39349c16a7e7ba3768517042926c26672224ee3d5f",
27
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
28
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
29
"receivedTokenContractAddress": null,
30
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
31
"logIndex": 157,
32
"type": "TRANSFER",
33
"sentAmount": "355586633038473906",
34
"decimalSentAmount": "0.355586633038473906",
35
"receivedAmount": "0",
36
"decimalReceivedAmount": "0"
37
},
38
{
39
"timestamp": "2024-11-17T11:08:23.000Z",
40
"blockNumber": "21207029",
41
"transactionHash": "0xf1d53afb9e4c3570468e72cfab93c90cd675bbe1c2a30e7c8539fd3289f3b2f9",
42
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
43
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
44
"receivedTokenContractAddress": null,
45
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
46
"logIndex": 164,
47
"type": "TRANSFER",
48
"sentAmount": "59301010914155328",
49
"decimalSentAmount": "0.059301010914155328",
50
"receivedAmount": "0",
51
"decimalReceivedAmount": "0"
52
},
53
{
54
"timestamp": "2024-11-17T11:00:11.000Z",
55
"blockNumber": "21206988",
56
"transactionHash": "0x7a9b44d0e9da74fc638c5a364801a854093b9bf6765e0e6d69b4eb062868e176",
57
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
58
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
59
"receivedTokenContractAddress": null,
60
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
61
"logIndex": 411,
62
"type": "TRANSFER",
63
"sentAmount": "1233878940411409023",
64
"decimalSentAmount": "1.233878940411409023",
65
"receivedAmount": "0",
66
"decimalReceivedAmount": "0"
67
},
68
{
69
"timestamp": "2024-11-17T10:54:23.000Z",
70
"blockNumber": "21206959",
71
"transactionHash": "0x1107bec3c2db1f2135a73ef644e770227a7da4a0792832b52d1e97fabf705238",
72
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
73
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
74
"receivedTokenContractAddress": null,
75
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
76
"logIndex": 313,
77
"type": "TRANSFER",
78
"sentAmount": "299099136108710103",
79
"decimalSentAmount": "0.299099136108710103",
80
"receivedAmount": "0",
81
"decimalReceivedAmount": "0"
82
},
83
{
84
"timestamp": "2024-11-17T03:42:59.000Z",
85
"blockNumber": "21204813",
86
"transactionHash": "0x06313ccaf1928b4aaff4cde80d154d0ea1a296fb9d102fec329bda5d23389b49",
87
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
88
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
89
"receivedTokenContractAddress": null,
90
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
91
"logIndex": 225,
92
"type": "TRANSFER",
93
"sentAmount": "2990999973161757",
94
"decimalSentAmount": "0.002990999973161757",
95
"receivedAmount": "0",
96
"decimalReceivedAmount": "0"
97
},
98
{
99
"timestamp": "2024-03-18T21:07:47.000Z",
100
"blockNumber": "19464244",
101
"transactionHash": "0x42476f2d6e533200e24c2b3a7a3baec149d2147e03e9be45b4ce03159bf7e919",
102
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
103
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
104
"receivedTokenContractAddress": null,
105
"fromAddress": "0xbc3ce21e97c337c007766088465e8b6ba203d550",
106
"logIndex": 200,
107
"type": "TRANSFER",
108
"sentAmount": "5289872835320060000000000",
109
"decimalSentAmount": "5289872.83532006",
110
"receivedAmount": "0",
111
"decimalReceivedAmount": "0"
112
},
113
{
114
"timestamp": "2024-01-16T21:07:11.000Z",
115
"blockNumber": "19022031",
116
"transactionHash": "0x7ff66afcb0ad08cd4b5d52142ba82bafa776d911b50b3ec5dffbd5f3de422992",
117
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
118
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
119
"receivedTokenContractAddress": null,
120
"fromAddress": "0x4293e4e33767c7cca80b7557c71e0420b8a197ec",
121
"logIndex": 168,
122
"type": "TRANSFER",
123
"sentAmount": "100000000000000000000000",
124
"decimalSentAmount": "100000",
125
"receivedAmount": "0",
126
"decimalReceivedAmount": "0"
127
},
128
{
129
"timestamp": "2022-11-30T04:47:47.000Z",
130
"blockNumber": "16080515",
131
"transactionHash": "0xe3a7b7b1169a1193400b1afb17b45e9f85679c0fdb2ad7c8b55918167aaabd1c",
132
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
133
"toAddress": "0x2234b808ec694608470259f72b5e32104a77078d",
134
"receivedTokenContractAddress": null,
135
"fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
136
"logIndex": 228,
137
"type": "TRANSFER",
138
"sentAmount": "0",
139
"decimalSentAmount": "0",
140
"receivedAmount": "0",
141
"decimalReceivedAmount": "0"
142
},
143
{
144
"timestamp": "2021-12-11T12:15:03.000Z",
145
"blockNumber": "13783791",
146
"transactionHash": "0x5e0e2f294a3fb39bfc392417acaf0de7729bd7825f6b048ef6cef9006d59e49c",
147
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
148
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
149
"receivedTokenContractAddress": null,
150
"fromAddress": "0x36c1625e5ee6fbfa9fadd4f75790275e5eab7107",
151
"logIndex": 310,
152
"type": "TRANSFER",
153
"sentAmount": "15418468200123",
154
"decimalSentAmount": "0.000015418468200123",
155
"receivedAmount": "0",
156
"decimalReceivedAmount": "0"
157
}
158
],
159
"token": {
160
"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
161
"genesisBlock": "10569013",
162
"genesisTransaction": "0x0a4022e61c49c59b2538b78a6c7c9a0e4bb8c8fce2d1b4a725baef3c55fb7363",
163
"name": "SHIBA INU",
164
"symbol": "SHIB",
165
"decimals": "18",
166
"contractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"
167
},
168
"totalPages": 2,
169
"totalItems": 11,
170
"pageNumber": 1
171
}
172
}
1
{
2
"jsonrpc": "2.0",
3
"id": 67,
4
"result": {
5
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
"ensName": "vitalik.eth",
7
"paginatedItems": [
8
{
9
"timestamp": "2024-11-24T16:42:59.000Z",
10
"blockNumber": "21258873",
11
"transactionHash": "0xca57c78b32f9512bde35dfd1621ccd7e758b679ce0264e4d9f5494d1b09d8bce",
12
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
13
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
14
"receivedTokenContractAddress": null,
15
"fromAddress": "0xdd4c573e3b8f0b7db5a88b9b49a40105e10120e6",
16
"logIndex": 68,
17
"type": "TRANSFER",
18
"sentAmount": "1111000000000000000000",
19
"decimalSentAmount": "1111",
20
"receivedAmount": "0",
21
"decimalReceivedAmount": "0"
22
},
23
{
24
"timestamp": "2024-11-17T11:17:59.000Z",
25
"blockNumber": "21207077",
26
"transactionHash": "0x520bc0cecd9f028428967e39349c16a7e7ba3768517042926c26672224ee3d5f",
27
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
28
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
29
"receivedTokenContractAddress": null,
30
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
31
"logIndex": 157,
32
"type": "TRANSFER",
33
"sentAmount": "355586633038473906",
34
"decimalSentAmount": "0.355586633038473906",
35
"receivedAmount": "0",
36
"decimalReceivedAmount": "0"
37
},
38
{
39
"timestamp": "2024-11-17T11:08:23.000Z",
40
"blockNumber": "21207029",
41
"transactionHash": "0xf1d53afb9e4c3570468e72cfab93c90cd675bbe1c2a30e7c8539fd3289f3b2f9",
42
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
43
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
44
"receivedTokenContractAddress": null,
45
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
46
"logIndex": 164,
47
"type": "TRANSFER",
48
"sentAmount": "59301010914155328",
49
"decimalSentAmount": "0.059301010914155328",
50
"receivedAmount": "0",
51
"decimalReceivedAmount": "0"
52
},
53
{
54
"timestamp": "2024-11-17T11:00:11.000Z",
55
"blockNumber": "21206988",
56
"transactionHash": "0x7a9b44d0e9da74fc638c5a364801a854093b9bf6765e0e6d69b4eb062868e176",
57
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
58
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
59
"receivedTokenContractAddress": null,
60
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
61
"logIndex": 411,
62
"type": "TRANSFER",
63
"sentAmount": "1233878940411409023",
64
"decimalSentAmount": "1.233878940411409023",
65
"receivedAmount": "0",
66
"decimalReceivedAmount": "0"
67
},
68
{
69
"timestamp": "2024-11-17T10:54:23.000Z",
70
"blockNumber": "21206959",
71
"transactionHash": "0x1107bec3c2db1f2135a73ef644e770227a7da4a0792832b52d1e97fabf705238",
72
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
73
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
74
"receivedTokenContractAddress": null,
75
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
76
"logIndex": 313,
77
"type": "TRANSFER",
78
"sentAmount": "299099136108710103",
79
"decimalSentAmount": "0.299099136108710103",
80
"receivedAmount": "0",
81
"decimalReceivedAmount": "0"
82
},
83
{
84
"timestamp": "2024-11-17T03:42:59.000Z",
85
"blockNumber": "21204813",
86
"transactionHash": "0x06313ccaf1928b4aaff4cde80d154d0ea1a296fb9d102fec329bda5d23389b49",
87
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
88
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
89
"receivedTokenContractAddress": null,
90
"fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
91
"logIndex": 225,
92
"type": "TRANSFER",
93
"sentAmount": "2990999973161757",
94
"decimalSentAmount": "0.002990999973161757",
95
"receivedAmount": "0",
96
"decimalReceivedAmount": "0"
97
},
98
{
99
"timestamp": "2024-03-18T21:07:47.000Z",
100
"blockNumber": "19464244",
101
"transactionHash": "0x42476f2d6e533200e24c2b3a7a3baec149d2147e03e9be45b4ce03159bf7e919",
102
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
103
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
104
"receivedTokenContractAddress": null,
105
"fromAddress": "0xbc3ce21e97c337c007766088465e8b6ba203d550",
106
"logIndex": 200,
107
"type": "TRANSFER",
108
"sentAmount": "5289872835320060000000000",
109
"decimalSentAmount": "5289872.83532006",
110
"receivedAmount": "0",
111
"decimalReceivedAmount": "0"
112
},
113
{
114
"timestamp": "2024-01-16T21:07:11.000Z",
115
"blockNumber": "19022031",
116
"transactionHash": "0x7ff66afcb0ad08cd4b5d52142ba82bafa776d911b50b3ec5dffbd5f3de422992",
117
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
118
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
119
"receivedTokenContractAddress": null,
120
"fromAddress": "0x4293e4e33767c7cca80b7557c71e0420b8a197ec",
121
"logIndex": 168,
122
"type": "TRANSFER",
123
"sentAmount": "100000000000000000000000",
124
"decimalSentAmount": "100000",
125
"receivedAmount": "0",
126
"decimalReceivedAmount": "0"
127
},
128
{
129
"timestamp": "2022-11-30T04:47:47.000Z",
130
"blockNumber": "16080515",
131
"transactionHash": "0xe3a7b7b1169a1193400b1afb17b45e9f85679c0fdb2ad7c8b55918167aaabd1c",
132
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
133
"toAddress": "0x2234b808ec694608470259f72b5e32104a77078d",
134
"receivedTokenContractAddress": null,
135
"fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
136
"logIndex": 228,
137
"type": "TRANSFER",
138
"sentAmount": "0",
139
"decimalSentAmount": "0",
140
"receivedAmount": "0",
141
"decimalReceivedAmount": "0"
142
},
143
{
144
"timestamp": "2021-12-11T12:15:03.000Z",
145
"blockNumber": "13783791",
146
"transactionHash": "0x5e0e2f294a3fb39bfc392417acaf0de7729bd7825f6b048ef6cef9006d59e49c",
147
"sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
148
"toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
149
"receivedTokenContractAddress": null,
150
"fromAddress": "0x36c1625e5ee6fbfa9fadd4f75790275e5eab7107",
151
"logIndex": 310,
152
"type": "TRANSFER",
153
"sentAmount": "15418468200123",
154
"decimalSentAmount": "0.000015418468200123",
155
"receivedAmount": "0",
156
"decimalReceivedAmount": "0"
157
}
158
],
159
"token": {
160
"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
161
"genesisBlock": "10569013",
162
"genesisTransaction": "0x0a4022e61c49c59b2538b78a6c7c9a0e4bb8c8fce2d1b4a725baef3c55fb7363",
163
"name": "SHIBA INU",
164
"symbol": "SHIB",
165
"decimals": "18",
166
"contractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"
167
},
168
"totalPages": 2,
169
"totalItems": 11,
170
"pageNumber": 1
171
}
172
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free