qn_getWalletTokenTransactions (v2) RPC Method - Token and NFT API

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

Loading...

object

Loading...

address

string

Loading...

contract

string

Loading...

fromBlock

string

Loading...

toBlock

string

Loading...

page

string

Loading...

perPage

string

Loading...

Returns

object

Loading...

address

string

Loading...

ensName

string

Loading...

token

Loading...

address

string

Loading...

genesisBlock

number

Loading...

genesisTransaction

string

Loading...

name

string

Loading...

symbol

string

Loading...

decimals

string

Loading...

contractAddress

string

Loading...

transfers

Loading...

timestamp

string

Loading...

blockNumber

string

Loading...

transactionHash

string

Loading...

sentTokenContractAddress

string

Loading...

toAddress

string

Loading...

receivedTokenContractAddress

string

Loading...

fromAddress

string

Loading...

logIndex

number

Loading...

type

string

Loading...

sentAmount

string

Loading...

decimalSentAmount

string

Loading...

receivedAmount

string

Loading...

decimalReceivedAmount

string

Loading...

pageNumber

Loading...

totalItems

Loading...

totalPages

Loading...

Request

curl https://docs-demo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_getWalletTokenTransactions",
    "params": [{
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
      "page": 1,
      "perPage": 10
    }]
  }'

require 'eth'

client = Eth::Client.create 'https://docs-demo.quiknode.pro/'

payload = {
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_getWalletTokenTransactions",
    "params": [{
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
      "page": 1,
      "perPage": 10
    }]
 }

response = client.send(payload.to_json)
puts response

import { ethers } from "ethers";
(async () => {
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
  const heads = await provider.send("qn_getWalletTokenTransactions", [
    {
      address: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      contract: "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
      page: 1,
      perPage: 10,
    },
  ]);
  console.log(heads);
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getWalletTokenTransactions",
  "params": [{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
    "page": 1,
    "perPage": 10
  }]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.quiknode.pro/"

payload = json.dumps({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getWalletTokenTransactions",
  "params": [{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
    "page": 1,
    "perPage": 10
  }]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "id": 67,
  "jsonrpc": "2.0",
  "method": "qn_getWalletTokenTransactions",
  "params": [{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
    "page": 1,
    "perPage": 10
  }]
})

response = https.request(request)
puts response.read_body

from web3 import Web3, HTTPProvider
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/', request_kwargs=OPTIONS))
resp = w3.provider.make_request('qn_getWalletTokenTransactions', [{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "contract": "0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE",
  "page": 1,
  "perPage": 10
}])
print(resp)

import { Core } from '@quicknode/sdk'

const core = new Core({
  endpointUrl: "https://docs-demo.quiknode.pro/",
  config: {
    addOns: {
      nftTokenV2: true,
    },
  },
})

core.client
    .qn_getWalletTokenTransactions({
      address: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
      contract: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    })
    .then(res => console.log(res))

Response

{
  "jsonrpc": "2.0",
  "id": 67,
  "result": {
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "ensName": "vitalik.eth",
    "paginatedItems": [
      {
        "timestamp": "2024-11-24T16:42:59.000Z",
        "blockNumber": "21258873",
        "transactionHash": "0xca57c78b32f9512bde35dfd1621ccd7e758b679ce0264e4d9f5494d1b09d8bce",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0xdd4c573e3b8f0b7db5a88b9b49a40105e10120e6",
        "logIndex": 68,
        "type": "TRANSFER",
        "sentAmount": "1111000000000000000000",
        "decimalSentAmount": "1111",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-11-17T11:17:59.000Z",
        "blockNumber": "21207077",
        "transactionHash": "0x520bc0cecd9f028428967e39349c16a7e7ba3768517042926c26672224ee3d5f",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
        "logIndex": 157,
        "type": "TRANSFER",
        "sentAmount": "355586633038473906",
        "decimalSentAmount": "0.355586633038473906",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-11-17T11:08:23.000Z",
        "blockNumber": "21207029",
        "transactionHash": "0xf1d53afb9e4c3570468e72cfab93c90cd675bbe1c2a30e7c8539fd3289f3b2f9",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
        "logIndex": 164,
        "type": "TRANSFER",
        "sentAmount": "59301010914155328",
        "decimalSentAmount": "0.059301010914155328",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-11-17T11:00:11.000Z",
        "blockNumber": "21206988",
        "transactionHash": "0x7a9b44d0e9da74fc638c5a364801a854093b9bf6765e0e6d69b4eb062868e176",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
        "logIndex": 411,
        "type": "TRANSFER",
        "sentAmount": "1233878940411409023",
        "decimalSentAmount": "1.233878940411409023",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-11-17T10:54:23.000Z",
        "blockNumber": "21206959",
        "transactionHash": "0x1107bec3c2db1f2135a73ef644e770227a7da4a0792832b52d1e97fabf705238",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
        "logIndex": 313,
        "type": "TRANSFER",
        "sentAmount": "299099136108710103",
        "decimalSentAmount": "0.299099136108710103",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-11-17T03:42:59.000Z",
        "blockNumber": "21204813",
        "transactionHash": "0x06313ccaf1928b4aaff4cde80d154d0ea1a296fb9d102fec329bda5d23389b49",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x7e33f072f85eac70eb7c914b418adada9d4ea4a3",
        "logIndex": 225,
        "type": "TRANSFER",
        "sentAmount": "2990999973161757",
        "decimalSentAmount": "0.002990999973161757",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-03-18T21:07:47.000Z",
        "blockNumber": "19464244",
        "transactionHash": "0x42476f2d6e533200e24c2b3a7a3baec149d2147e03e9be45b4ce03159bf7e919",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0xbc3ce21e97c337c007766088465e8b6ba203d550",
        "logIndex": 200,
        "type": "TRANSFER",
        "sentAmount": "5289872835320060000000000",
        "decimalSentAmount": "5289872.83532006",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2024-01-16T21:07:11.000Z",
        "blockNumber": "19022031",
        "transactionHash": "0x7ff66afcb0ad08cd4b5d52142ba82bafa776d911b50b3ec5dffbd5f3de422992",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x4293e4e33767c7cca80b7557c71e0420b8a197ec",
        "logIndex": 168,
        "type": "TRANSFER",
        "sentAmount": "100000000000000000000000",
        "decimalSentAmount": "100000",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2022-11-30T04:47:47.000Z",
        "blockNumber": "16080515",
        "transactionHash": "0xe3a7b7b1169a1193400b1afb17b45e9f85679c0fdb2ad7c8b55918167aaabd1c",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0x2234b808ec694608470259f72b5e32104a77078d",
        "receivedTokenContractAddress": null,
        "fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "logIndex": 228,
        "type": "TRANSFER",
        "sentAmount": "0",
        "decimalSentAmount": "0",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      },
      {
        "timestamp": "2021-12-11T12:15:03.000Z",
        "blockNumber": "13783791",
        "transactionHash": "0x5e0e2f294a3fb39bfc392417acaf0de7729bd7825f6b048ef6cef9006d59e49c",
        "sentTokenContractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "receivedTokenContractAddress": null,
        "fromAddress": "0x36c1625e5ee6fbfa9fadd4f75790275e5eab7107",
        "logIndex": 310,
        "type": "TRANSFER",
        "sentAmount": "15418468200123",
        "decimalSentAmount": "0.000015418468200123",
        "receivedAmount": "0",
        "decimalReceivedAmount": "0"
      }
    ],
    "token": {
      "address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
      "genesisBlock": "10569013",
      "genesisTransaction": "0x0a4022e61c49c59b2538b78a6c7c9a0e4bb8c8fce2d1b4a725baef3c55fb7363",
      "name": "SHIBA INU",
      "symbol": "SHIB",
      "decimals": "18",
      "contractAddress": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"
    },
    "totalPages": 2,
    "totalItems": 11,
    "pageNumber": 1
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free