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

object

object

REQUIRED

A custom object with the following fields:

address

string

REQUIRED

The wallet address or ENS name we want to check for transactions

fromBlock

string

The first block number to check for transactions (inclusive). If omitted, will default to the genesis block for the provided address

toBlock

string

The last block number to check for transactions (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 transactions 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 transactions to return on each page. You can request up to 100 transactions per page. If omitted, defaults to 40 transactions per page

Returns

object

object

The custom response object containing transaction details and array of transactions, or an empty array if no transactions are found:

address

string

The wallet address we checked for transactions

ensName

string

The ENS name associated with the wallet address we checked for transactions

paginatedItems

array

An array of objects representing transactions with the following shape:

blockTimestamp

string

The timestamp of the block in which the transaction occurred

transactionHash

string

The hash of the transaction

blockNumber

string

The block number within which this transaction occurred

transactionIndex

integer

The index of the transaction within the block

fromAddress

string

The address from which the transaction was sent

toAddress

string

The address to which the transaction was sent

contractAddress

string

The contract address involved in the transaction (if applicable)

value

string

The value of the transaction (in wei)

status

string

The status of the transaction

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

1
curl -X POST "https://docs-demo.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "qn_getTransactionsByAddress",
6
  "params": [
7
    {
8
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
9
      "page": 1,
10
      "perPage": 3
11
    }
12
  ],
13
  "id": 1
14
}'

1
curl -X POST "https://docs-demo.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "qn_getTransactionsByAddress",
6
  "params": [
7
    {
8
      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
9
      "page": 1,
10
      "perPage": 3
11
    }
12
  ],
13
  "id": 1
14
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getTransactionsByAddress',
4
    params: [{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","page":1,"perPage":3}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getTransactionsByAddress',
4
    params: [{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","page":1,"perPage":3}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

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

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

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

24
print(response.text)

1
import requests
2
import json
3

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

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

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

24
print(response.text)

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

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

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

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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

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

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

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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