qn_getTransactionsByAddress (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 100,000 results. The fromBlock and toBlock parameters can be used for historical data.

Parameters

array

object

address

string

fromBlock

string

toBlock

string

page

string

perPage

string

Returns

object

address

string

ensName

string

transactions

blockTimestamp

transactionHash

blockNumber

transactionIndex

fromAddress

toAddress

contractAddress

value

status

pageNumber

totalItems

totalPages

Request

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

require 'eth'

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

payload = {
    "id":67,
    "jsonrpc":"2.0",
    "method":"qn_getTransactionsByAddress",
    "params": [{
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "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_getTransactionsByAddress", [
    {
      address: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      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_getTransactionsByAddress",
  "params": [{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "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_getTransactionsByAddress",
  "params": [{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "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_getTransactionsByAddress",
  "params": [{
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "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_getTransactionsByAddress', [{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "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_getTransactionsByAddress({
      address: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
      perPage: 2,
    })
    .then(res => console.log(res))

Response

{
  "jsonrpc": "2.0",
  "id": 67,
  "result": {
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "ensName": "vitalik.eth",
    "paginatedItems": [
      {
        "blockTimestamp": "2025-04-27T15:14:59.000Z",
        "transactionHash": "0x3e544fb335f8d485a3675191b76522ad50da1b5999cb92c2380e6c2cf0f973e7",
        "blockNumber": "22361223",
        "transactionIndex": 26,
        "fromAddress": "0xf89d7b9c864f589bbf53a82105107622b35eaa40",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "9514230000000000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-27T05:58:11.000Z",
        "transactionHash": "0xea72beb3b0f279f186d290f3098a82c11667099fb66357d6502144d70a5b8eb4",
        "blockNumber": "22358445",
        "transactionIndex": 31,
        "fromAddress": "0x59211a68b6cd420f0b8a4a4d2539c4126a26537e",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-27T05:57:23.000Z",
        "transactionHash": "0x7614507c34d47b0a6a06aec33f92e57304b632f07c7292a51b0620f70bc74adc",
        "blockNumber": "22358441",
        "transactionIndex": 52,
        "fromAddress": "0x59211a68b6cd420f0b8a4a4d2539c4126a26537e",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-26T10:13:35.000Z",
        "transactionHash": "0x2c5873bf584ae5c91476d2d2fa7d16fa555de78a928047ee65e77e01c4d892b9",
        "blockNumber": "22352538",
        "transactionIndex": 108,
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000000000000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-25T19:26:47.000Z",
        "transactionHash": "0xe8fbc4f84e0bbb07c930cfe8744b3a6ddf96a0f86080fb6228db6c912a54e599",
        "blockNumber": "22348117",
        "transactionIndex": 100,
        "fromAddress": "0x3f8b06e984eb797234cc9b2f6dc070853ff369c4",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000000000000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-25T16:16:59.000Z",
        "transactionHash": "0x89c4b5b5cb70bc51d6194451dfb2bb3c8ecd8a95eb0bdc9c340f804ecd478cee",
        "blockNumber": "22347172",
        "transactionIndex": 165,
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000000000000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-25T03:20:59.000Z",
        "transactionHash": "0xfffbdd065fdff5e41f630967ae46b92aa5236ec9a38d1e7511ef82d5e49a25f5",
        "blockNumber": "22343310",
        "transactionIndex": 104,
        "fromAddress": "0xa7f9bf7a9fba423e42e740eb2883ccf3503ba56b",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000000000000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-24T18:30:47.000Z",
        "transactionHash": "0x83a8b8e19995dd88644ac287279d65b716969d71bb4a11df9b14d84a5a8960ac",
        "blockNumber": "22340666",
        "transactionIndex": 339,
        "fromAddress": "0x614168aa18fb121833ec9e55f9a038d4bc2e2dfe",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "45356359245043",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-24T11:15:47.000Z",
        "transactionHash": "0xccd7f39a6bec19013e7f8112746a908326457e8bf40e948a7d723cc32d84e298",
        "blockNumber": "22338509",
        "transactionIndex": 203,
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000000000000",
        "status": "success"
      },
      {
        "blockTimestamp": "2025-04-23T09:55:11.000Z",
        "transactionHash": "0x2928a6e7f7e43bf78c893bf1f471fefef22483423c992c39d561666f485df89c",
        "blockNumber": "22330938",
        "transactionIndex": 141,
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "contractAddress": null,
        "value": "100000000000000",
        "status": "success"
      }
    ],
    "totalPages": 7254,
    "totalItems": 72537,
    "pageNumber": 1
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

qn_getTransactionsByAddress (v2) RPC Method - Token and NFT API

Loading...

Parameters

Returns