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

array

Loading...

object

object

Loading...

address

string

Loading...

fromBlock

string

Loading...

toBlock

string

Loading...

page

string

Loading...

perPage

string

Loading...

Returns

object

object

Loading...

address

string

Loading...

ensName

string

Loading...

paginatedItems

array

Loading...

blockTimestamp

string

Loading...

transactionHash

string

Loading...

blockNumber

string

Loading...

transactionIndex

integer

Loading...

fromAddress

string

Loading...

toAddress

string

Loading...

contractAddress

string

Loading...

value

string

Loading...

status

string

Loading...

pageNumber

integer

Loading...

totalItems

integer

Loading...

totalPages

integer

Loading...

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_getTransactionsByAddress",
8
    "params": [{
9
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
      "page": 1,
11
      "perPage": 10
12
    }]
13
  }'
14

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_getTransactionsByAddress",
8
    "params": [{
9
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
      "page": 1,
11
      "perPage": 10
12
    }]
13
  }'
14

1
require 'eth'
2

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

5
payload = {
6
    "id":67,
7
    "jsonrpc":"2.0",
8
    "method":"qn_getTransactionsByAddress",
9
    "params": [{
10
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
11
      "page": 1,
12
      "perPage": 10
13
    }]
14
 }
15

16
response = client.send(payload.to_json)
17
puts response
18

1
require 'eth'
2

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

5
payload = {
6
    "id":67,
7
    "jsonrpc":"2.0",
8
    "method":"qn_getTransactionsByAddress",
9
    "params": [{
10
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
11
      "page": 1,
12
      "perPage": 10
13
    }]
14
 }
15

16
response = client.send(payload.to_json)
17
puts response
18

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
4
  const heads = await provider.send("qn_getTransactionsByAddress", [
5
    {
6
      address: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
7
      page: 1,
8
      perPage: 10,
9
    },
10
  ]);
11
  console.log(heads);
12
})();
13

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.quiknode.pro/");
4
  const heads = await provider.send("qn_getTransactionsByAddress", [
5
    {
6
      address: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
7
      page: 1,
8
      perPage: 10,
9
    },
10
  ]);
11
  console.log(heads);
12
})();
13

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

4
var raw = JSON.stringify({
5
  "id": 67,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getTransactionsByAddress",
8
  "params": [{
9
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
    "page": 1,
11
    "perPage": 10
12
  }]
13
});
14

15
var requestOptions = {
16
  method: 'POST',
17
  headers: myHeaders,
18
  body: raw,
19
  redirect: 'follow'
20
};
21

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

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

4
var raw = JSON.stringify({
5
  "id": 67,
6
  "jsonrpc": "2.0",
7
  "method": "qn_getTransactionsByAddress",
8
  "params": [{
9
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
10
    "page": 1,
11
    "perPage": 10
12
  }]
13
});
14

15
var requestOptions = {
16
  method: 'POST',
17
  headers: myHeaders,
18
  body: raw,
19
  redirect: 'follow'
20
};
21

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

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 67,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getTransactionsByAddress",
10
  "params": [{
11
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
12
    "page": 1,
13
    "perPage": 10
14
  }]
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

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

22
print(response.text)
23

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "id": 67,
8
  "jsonrpc": "2.0",
9
  "method": "qn_getTransactionsByAddress",
10
  "params": [{
11
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
12
    "page": 1,
13
    "perPage": 10
14
  }]
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

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

22
print(response.text)
23

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "id": 67,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getTransactionsByAddress",
16
  "params": [{
17
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
18
    "page": 1,
19
    "perPage": 10
20
  }]
21
})
22

23
response = https.request(request)
24
puts response.read_body
25

1
require "uri"
2
require "json"
3
require "net/http"
4

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

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

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "id": 67,
14
  "jsonrpc": "2.0",
15
  "method": "qn_getTransactionsByAddress",
16
  "params": [{
17
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
18
    "page": 1,
19
    "perPage": 10
20
  }]
21
})
22

23
response = https.request(request)
24
puts response.read_body
25

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/', request_kwargs=OPTIONS))
3
resp = w3.provider.make_request('qn_getTransactionsByAddress', [{
4
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
5
  "page": 1,
6
  "perPage": 10
7
}])
8
print(resp)
9

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.quiknode.pro/', request_kwargs=OPTIONS))
3
resp = w3.provider.make_request('qn_getTransactionsByAddress', [{
4
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
5
  "page": 1,
6
  "perPage": 10
7
}])
8
print(resp)
9

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.quiknode.pro/",
5
  config: {
6
    addOns: {
7
      nftTokenV2: true,
8
    },
9
  },
10
})
11

12
core.client
13
    .qn_getTransactionsByAddress({
14
      address: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
15
      perPage: 2,
16
    })
17
    .then(res => console.log(res))
18

1
import { Core } from '@quicknode/sdk'
2

3
const core = new Core({
4
  endpointUrl: "https://docs-demo.quiknode.pro/",
5
  config: {
6
    addOns: {
7
      nftTokenV2: true,
8
    },
9
  },
10
})
11

12
core.client
13
    .qn_getTransactionsByAddress({
14
      address: "0xD10E24685c7CDD3cd3BaAA86b09C92Be28c834B6",
15
      perPage: 2,
16
    })
17
    .then(res => console.log(res))
18

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
    "ensName": "vitalik.eth",
7
    "paginatedItems": [
8
      {
9
        "blockTimestamp": "2025-04-27T15:14:59.000Z",
10
        "transactionHash": "0x3e544fb335f8d485a3675191b76522ad50da1b5999cb92c2380e6c2cf0f973e7",
11
        "blockNumber": "22361223",
12
        "transactionIndex": 26,
13
        "fromAddress": "0xf89d7b9c864f589bbf53a82105107622b35eaa40",
14
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
15
        "contractAddress": null,
16
        "value": "9514230000000000",
17
        "status": "success"
18
      },
19
      {
20
        "blockTimestamp": "2025-04-27T05:58:11.000Z",
21
        "transactionHash": "0xea72beb3b0f279f186d290f3098a82c11667099fb66357d6502144d70a5b8eb4",
22
        "blockNumber": "22358445",
23
        "transactionIndex": 31,
24
        "fromAddress": "0x59211a68b6cd420f0b8a4a4d2539c4126a26537e",
25
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
26
        "contractAddress": null,
27
        "value": "100000",
28
        "status": "success"
29
      },
30
      {
31
        "blockTimestamp": "2025-04-27T05:57:23.000Z",
32
        "transactionHash": "0x7614507c34d47b0a6a06aec33f92e57304b632f07c7292a51b0620f70bc74adc",
33
        "blockNumber": "22358441",
34
        "transactionIndex": 52,
35
        "fromAddress": "0x59211a68b6cd420f0b8a4a4d2539c4126a26537e",
36
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
37
        "contractAddress": null,
38
        "value": "100000",
39
        "status": "success"
40
      },
41
      {
42
        "blockTimestamp": "2025-04-26T10:13:35.000Z",
43
        "transactionHash": "0x2c5873bf584ae5c91476d2d2fa7d16fa555de78a928047ee65e77e01c4d892b9",
44
        "blockNumber": "22352538",
45
        "transactionIndex": 108,
46
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
47
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
48
        "contractAddress": null,
49
        "value": "100000000000000",
50
        "status": "success"
51
      },
52
      {
53
        "blockTimestamp": "2025-04-25T19:26:47.000Z",
54
        "transactionHash": "0xe8fbc4f84e0bbb07c930cfe8744b3a6ddf96a0f86080fb6228db6c912a54e599",
55
        "blockNumber": "22348117",
56
        "transactionIndex": 100,
57
        "fromAddress": "0x3f8b06e984eb797234cc9b2f6dc070853ff369c4",
58
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
59
        "contractAddress": null,
60
        "value": "100000000000000",
61
        "status": "success"
62
      },
63
      {
64
        "blockTimestamp": "2025-04-25T16:16:59.000Z",
65
        "transactionHash": "0x89c4b5b5cb70bc51d6194451dfb2bb3c8ecd8a95eb0bdc9c340f804ecd478cee",
66
        "blockNumber": "22347172",
67
        "transactionIndex": 165,
68
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
69
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
70
        "contractAddress": null,
71
        "value": "100000000000000",
72
        "status": "success"
73
      },
74
      {
75
        "blockTimestamp": "2025-04-25T03:20:59.000Z",
76
        "transactionHash": "0xfffbdd065fdff5e41f630967ae46b92aa5236ec9a38d1e7511ef82d5e49a25f5",
77
        "blockNumber": "22343310",
78
        "transactionIndex": 104,
79
        "fromAddress": "0xa7f9bf7a9fba423e42e740eb2883ccf3503ba56b",
80
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
81
        "contractAddress": null,
82
        "value": "100000000000000",
83
        "status": "success"
84
      },
85
      {
86
        "blockTimestamp": "2025-04-24T18:30:47.000Z",
87
        "transactionHash": "0x83a8b8e19995dd88644ac287279d65b716969d71bb4a11df9b14d84a5a8960ac",
88
        "blockNumber": "22340666",
89
        "transactionIndex": 339,
90
        "fromAddress": "0x614168aa18fb121833ec9e55f9a038d4bc2e2dfe",
91
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
92
        "contractAddress": null,
93
        "value": "45356359245043",
94
        "status": "success"
95
      },
96
      {
97
        "blockTimestamp": "2025-04-24T11:15:47.000Z",
98
        "transactionHash": "0xccd7f39a6bec19013e7f8112746a908326457e8bf40e948a7d723cc32d84e298",
99
        "blockNumber": "22338509",
100
        "transactionIndex": 203,
101
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
102
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
103
        "contractAddress": null,
104
        "value": "100000000000000",
105
        "status": "success"
106
      },
107
      {
108
        "blockTimestamp": "2025-04-23T09:55:11.000Z",
109
        "transactionHash": "0x2928a6e7f7e43bf78c893bf1f471fefef22483423c992c39d561666f485df89c",
110
        "blockNumber": "22330938",
111
        "transactionIndex": 141,
112
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
113
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
114
        "contractAddress": null,
115
        "value": "100000000000000",
116
        "status": "success"
117
      }
118
    ],
119
    "totalPages": 7254,
120
    "totalItems": 72537,
121
    "pageNumber": 1
122
  }
123
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 67,
4
  "result": {
5
    "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
6
    "ensName": "vitalik.eth",
7
    "paginatedItems": [
8
      {
9
        "blockTimestamp": "2025-04-27T15:14:59.000Z",
10
        "transactionHash": "0x3e544fb335f8d485a3675191b76522ad50da1b5999cb92c2380e6c2cf0f973e7",
11
        "blockNumber": "22361223",
12
        "transactionIndex": 26,
13
        "fromAddress": "0xf89d7b9c864f589bbf53a82105107622b35eaa40",
14
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
15
        "contractAddress": null,
16
        "value": "9514230000000000",
17
        "status": "success"
18
      },
19
      {
20
        "blockTimestamp": "2025-04-27T05:58:11.000Z",
21
        "transactionHash": "0xea72beb3b0f279f186d290f3098a82c11667099fb66357d6502144d70a5b8eb4",
22
        "blockNumber": "22358445",
23
        "transactionIndex": 31,
24
        "fromAddress": "0x59211a68b6cd420f0b8a4a4d2539c4126a26537e",
25
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
26
        "contractAddress": null,
27
        "value": "100000",
28
        "status": "success"
29
      },
30
      {
31
        "blockTimestamp": "2025-04-27T05:57:23.000Z",
32
        "transactionHash": "0x7614507c34d47b0a6a06aec33f92e57304b632f07c7292a51b0620f70bc74adc",
33
        "blockNumber": "22358441",
34
        "transactionIndex": 52,
35
        "fromAddress": "0x59211a68b6cd420f0b8a4a4d2539c4126a26537e",
36
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
37
        "contractAddress": null,
38
        "value": "100000",
39
        "status": "success"
40
      },
41
      {
42
        "blockTimestamp": "2025-04-26T10:13:35.000Z",
43
        "transactionHash": "0x2c5873bf584ae5c91476d2d2fa7d16fa555de78a928047ee65e77e01c4d892b9",
44
        "blockNumber": "22352538",
45
        "transactionIndex": 108,
46
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
47
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
48
        "contractAddress": null,
49
        "value": "100000000000000",
50
        "status": "success"
51
      },
52
      {
53
        "blockTimestamp": "2025-04-25T19:26:47.000Z",
54
        "transactionHash": "0xe8fbc4f84e0bbb07c930cfe8744b3a6ddf96a0f86080fb6228db6c912a54e599",
55
        "blockNumber": "22348117",
56
        "transactionIndex": 100,
57
        "fromAddress": "0x3f8b06e984eb797234cc9b2f6dc070853ff369c4",
58
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
59
        "contractAddress": null,
60
        "value": "100000000000000",
61
        "status": "success"
62
      },
63
      {
64
        "blockTimestamp": "2025-04-25T16:16:59.000Z",
65
        "transactionHash": "0x89c4b5b5cb70bc51d6194451dfb2bb3c8ecd8a95eb0bdc9c340f804ecd478cee",
66
        "blockNumber": "22347172",
67
        "transactionIndex": 165,
68
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
69
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
70
        "contractAddress": null,
71
        "value": "100000000000000",
72
        "status": "success"
73
      },
74
      {
75
        "blockTimestamp": "2025-04-25T03:20:59.000Z",
76
        "transactionHash": "0xfffbdd065fdff5e41f630967ae46b92aa5236ec9a38d1e7511ef82d5e49a25f5",
77
        "blockNumber": "22343310",
78
        "transactionIndex": 104,
79
        "fromAddress": "0xa7f9bf7a9fba423e42e740eb2883ccf3503ba56b",
80
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
81
        "contractAddress": null,
82
        "value": "100000000000000",
83
        "status": "success"
84
      },
85
      {
86
        "blockTimestamp": "2025-04-24T18:30:47.000Z",
87
        "transactionHash": "0x83a8b8e19995dd88644ac287279d65b716969d71bb4a11df9b14d84a5a8960ac",
88
        "blockNumber": "22340666",
89
        "transactionIndex": 339,
90
        "fromAddress": "0x614168aa18fb121833ec9e55f9a038d4bc2e2dfe",
91
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
92
        "contractAddress": null,
93
        "value": "45356359245043",
94
        "status": "success"
95
      },
96
      {
97
        "blockTimestamp": "2025-04-24T11:15:47.000Z",
98
        "transactionHash": "0xccd7f39a6bec19013e7f8112746a908326457e8bf40e948a7d723cc32d84e298",
99
        "blockNumber": "22338509",
100
        "transactionIndex": 203,
101
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
102
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
103
        "contractAddress": null,
104
        "value": "100000000000000",
105
        "status": "success"
106
      },
107
      {
108
        "blockTimestamp": "2025-04-23T09:55:11.000Z",
109
        "transactionHash": "0x2928a6e7f7e43bf78c893bf1f471fefef22483423c992c39d561666f485df89c",
110
        "blockNumber": "22330938",
111
        "transactionIndex": 141,
112
        "fromAddress": "0x8eb368b95f2bb8fcbb15c8e6a028785563e9ad27",
113
        "toAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
114
        "contractAddress": null,
115
        "value": "100000000000000",
116
        "status": "success"
117
      }
118
    ],
119
    "totalPages": 7254,
120
    "totalItems": 72537,
121
    "pageNumber": 1
122
  }
123
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free