Parameters

address

string

REQUIRED

The account address encoded as base-58 string to retrieve transaction history for

object

object

(Optional) The configuration object with the following fields:

transactionDetails

string

(Default: signatures) The level of transaction detail to return. It can be one of signatures or full. When set to full, each item includes the complete transaction and metadata objects

sortOrder

string

(Default: desc) The order in which results are sorted by slot and transaction index. It can be one of desc (newest first) or asc (oldest first)

limit

integer

(Default: 1000) The maximum number of transactions to return (between 1 and 1000). Values above 1000 are capped at 1000

paginationToken

string

The token returned as paginationToken in a previous response, used to fetch the next page of results. The value is formatted as slot:transactionIndex

commitment

string

The level of commitment required for the query. This method does not support commitment levels below confirmed. The options include:

finalized

string

The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized

confirmed

string

The node will query the most recent block that has been voted on by the supermajority of the cluster

minContextSlot

integer

The minimum slot at which the request can be evaluated

encoding

string

(Default: json) The encoding format for the transaction data. It can be one of json, jsonParsed, base58, or base64. This field only applies when transactionDetails is set to full

maxSupportedTransactionVersion

integer

The maximum transaction version to return, as a JSON integer. Set it to 1 to receive legacy, version 0, and version 1 transactions. This field only applies when transactionDetails is set to full

filters

object

(Optional) The filter object used to narrow the returned transactions with the following fields:

slot

object

Filters transactions by slot using any combination of the comparison fields below

gte

integer

Matches transactions in slots greater than or equal to this value

gt

integer

Matches transactions in slots greater than this value

lte

integer

Matches transactions in slots less than or equal to this value

lt

integer

Matches transactions in slots less than this value

blockTime

object

Filters transactions by block time, as a Unix timestamp in seconds, using any combination of the comparison fields below

gte

integer

Matches transactions with a block time greater than or equal to this value

gt

integer

Matches transactions with a block time greater than this value

lte

integer

Matches transactions with a block time less than or equal to this value

lt

integer

Matches transactions with a block time less than this value

eq

integer

Matches transactions with a block time equal to this value

signature

object

Filters transactions by their position relative to a base-58 encoded transaction signature, using any combination of the comparison fields below

gte

string

Matches transactions positioned at or after this signature

gt

string

Matches transactions positioned after this signature

lte

string

Matches transactions positioned at or before this signature

lt

string

Matches transactions positioned before this signature

status

string

(Default: any) Filters transactions by execution status. It can be one of any, succeeded, or failed

tokenAccounts

string

(Default: none) Controls whether transactions involving token accounts owned by the address are included. It can be one of none (only the address itself), balanceChanged (also include token accounts whose balance changed), or all (also include all token accounts owned by the address)

Returns

result

object

A JSON object with the following fields:

data

array

An array of transaction objects. The fields present in each object depend on transactionDetails, as noted below:

signature

string

Only present when transactionDetails is signatures. The base-58 encoded signature of the transaction. When transactionDetails is full, the signature is available in transaction.signatures[0] for the json and jsonParsed encodings

slot

integer

The slot number in which the transaction was confirmed

transactionIndex

integer

The position of the transaction within its block

err

object

Only present when transactionDetails is signatures. Error object if the transaction failed or null if the transaction succeeded. When transactionDetails is full, the error is available in meta.err

memo

string

Only present when transactionDetails is signatures. The memo associated with the transaction and null if no memo is present

blockTime

integer

The estimated production time, as Unix timestamp (seconds since the Unix epoch). Null if not available

confirmationStatus

string

Only present when transactionDetails is signatures. The transaction's cluster confirmation status. The status can either be confirmed or finalized

transaction

object

Only present when transactionDetails is full. The transaction object, either in JSON format or encoded binary data depending on the encoding parameter. Version 1 transactions carry their compute and fee settings in the message's transactionConfig object

meta

object

Only present when transactionDetails is full. The transaction status metadata object, containing fields such as err, fee, preBalances, postBalances, preTokenBalances, postTokenBalances, innerInstructions, logMessages, rewards, loadedAddresses, status, computeUnitsConsumed, and costUnits. The loadedAddresses field holds the addresses resolved from address lookup tables as writable and readonly arrays, both empty for legacy and version 1 transactions, and is omitted when encoding is jsonParsed, where those addresses appear in accountKeys with a source of lookupTable

version

string|integer

Only present when transactionDetails is full. The transaction version, one of "legacy", 0, or 1

paginationToken

string

The token used to fetch the next page of results, formatted as slot:transactionIndex. Null when there are no further results

Request

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc":"2.0","id":1,"method":"getTransactionsForAddress","params":["Vote111111111111111111111111111111111111111",{"limit":2,"transactionDetails":"full","maxSupportedTransactionVersion":1}]}'
5

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc":"2.0","id":1,"method":"getTransactionsForAddress","params":["Vote111111111111111111111111111111111111111",{"limit":2,"transactionDetails":"full","maxSupportedTransactionVersion":1}]}'
5

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

5
url = URI("https://docs-demo.solana-mainnet.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
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getTransactionsForAddress",
16
  "params": [
17
    "Vote111111111111111111111111111111111111111",
18
    {
19
      "limit": 2,
20
      "transactionDetails": "full",
21
      "maxSupportedTransactionVersion": 1
22
    }
23
  ]
24
})
25

26
response = https.request(request)
27
puts response.read_body
28

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

5
url = URI("https://docs-demo.solana-mainnet.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
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getTransactionsForAddress",
16
  "params": [
17
    "Vote111111111111111111111111111111111111111",
18
    {
19
      "limit": 2,
20
      "transactionDetails": "full",
21
      "maxSupportedTransactionVersion": 1
22
    }
23
  ]
24
})
25

26
response = https.request(request)
27
puts response.read_body
28

1
import { createDefaultRpcTransport, createJsonRpcApi, createRpc } from "@solana/kit";
2

3
// getTransactionsForAddress is not part of the default Solana RPC API,
4
// so build a custom JSON-RPC API to call it.
5
const api = createJsonRpcApi({ responseTransformer: (response) => response.result });
6
const transport = createDefaultRpcTransport({ url: "https://docs-demo.solana-mainnet.quiknode.pro/" });
7
const rpc = createRpc({ api, transport });
8

9
(async () => {
10
  const result = await rpc
11
    .getTransactionsForAddress("Vote111111111111111111111111111111111111111", {
12
      limit: 2,
13
      transactionDetails: "full",
14
      maxSupportedTransactionVersion: 1,
15
    })
16
    .send();
17
  console.log(result);
18
})();
19

1
import { createDefaultRpcTransport, createJsonRpcApi, createRpc } from "@solana/kit";
2

3
// getTransactionsForAddress is not part of the default Solana RPC API,
4
// so build a custom JSON-RPC API to call it.
5
const api = createJsonRpcApi({ responseTransformer: (response) => response.result });
6
const transport = createDefaultRpcTransport({ url: "https://docs-demo.solana-mainnet.quiknode.pro/" });
7
const rpc = createRpc({ api, transport });
8

9
(async () => {
10
  const result = await rpc
11
    .getTransactionsForAddress("Vote111111111111111111111111111111111111111", {
12
      limit: 2,
13
      transactionDetails: "full",
14
      maxSupportedTransactionVersion: 1,
15
    })
16
    .send();
17
  console.log(result);
18
})();
19

1
const { Connection } = require("@solana/web3.js");
2

3
(async () => {
4
  const connection = new Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  const result = await connection._rpcRequest("getTransactionsForAddress", [
7
    "Vote111111111111111111111111111111111111111",
8
    { limit: 2, transactionDetails: "full", maxSupportedTransactionVersion: 1 },
9
  ]);
10

11
  console.log(result);
12
})();
13

1
const { Connection } = require("@solana/web3.js");
2

3
(async () => {
4
  const connection = new Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  const result = await connection._rpcRequest("getTransactionsForAddress", [
7
    "Vote111111111111111111111111111111111111111",
8
    { limit: 2, transactionDetails: "full", maxSupportedTransactionVersion: 1 },
9
  ]);
10

11
  console.log(result);
12
})();
13

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
    "jsonrpc": "2.0",
8
    "id": 1,
9
    "method": "getTransactionsForAddress",
10
    "params": [
11
        "Vote111111111111111111111111111111111111111",
12
        {
13
            "limit": 2,
14
            "transactionDetails": "full",
15
            "maxSupportedTransactionVersion": 1
16
        }
17
    ]
18
})
19
headers = {'Content-Type': 'application/json'}
20

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

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
    "jsonrpc": "2.0",
8
    "id": 1,
9
    "method": "getTransactionsForAddress",
10
    "params": [
11
        "Vote111111111111111111111111111111111111111",
12
        {
13
            "limit": 2,
14
            "transactionDetails": "full",
15
            "maxSupportedTransactionVersion": 1
16
        }
17
    ]
18
})
19
headers = {'Content-Type': 'application/json'}
20

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

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getTransactionsForAddress",
16
        "params": [
17
            "Vote111111111111111111111111111111111111111",
18
            {
19
                "limit": 2,
20
                "transactionDetails": "full",
21
                "maxSupportedTransactionVersion": 1
22
            }
23
        ]
24
    }"#;
25
    let response = client
26
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
27
        .headers(headers)
28
        .body(json_data)
29
        .send()
30
        .await?;
31

32
    let body = response.text().await?;
33
    println!("{}", body);
34

35
    Ok(())
36
}
37

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getTransactionsForAddress",
16
        "params": [
17
            "Vote111111111111111111111111111111111111111",
18
            {
19
                "limit": 2,
20
                "transactionDetails": "full",
21
                "maxSupportedTransactionVersion": 1
22
            }
23
        ]
24
    }"#;
25
    let response = client
26
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
27
        .headers(headers)
28
        .body(json_data)
29
        .send()
30
        .await?;
31

32
    let body = response.text().await?;
33
    println!("{}", body);
34

35
    Ok(())
36
}
37

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getTransactionsForAddress',
7
  [
8
  "Vote111111111111111111111111111111111111111",
9
  {
10
    "limit": 2,
11
    "transactionDetails": "full",
12
    "maxSupportedTransactionVersion": 1
13
  }
14
],
15
  undefined,
16
  'https://docs-demo.solana-mainnet.quiknode.pro/'
17
)
18

19
console.log(result)

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getTransactionsForAddress',
7
  [
8
  "Vote111111111111111111111111111111111111111",
9
  {
10
    "limit": 2,
11
    "transactionDetails": "full",
12
    "maxSupportedTransactionVersion": 1
13
  }
14
],
15
  undefined,
16
  'https://docs-demo.solana-mainnet.quiknode.pro/'
17
)
18

19
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getTransactionsForAddress",
8
        [
9
            "Vote111111111111111111111111111111111111111",
10
            {
11
                "limit": 2,
12
                "transactionDetails": "full",
13
                "maxSupportedTransactionVersion": 1
14
            }
15
        ],
16
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
17
    )
18
    print(result)
19

20
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getTransactionsForAddress",
8
        [
9
            "Vote111111111111111111111111111111111111111",
10
            {
11
                "limit": 2,
12
                "transactionDetails": "full",
13
                "maxSupportedTransactionVersion": 1
14
            }
15
        ],
16
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
17
    )
18
    print(result)
19

20
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getTransactionsForAddress",
7
  params: [
8
    "Vote111111111111111111111111111111111111111",
9
    {
10
      "limit" => 2,
11
      "transactionDetails" => "full",
12
      "maxSupportedTransactionVersion" => 1
13
    }
14
  ],
15
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
16
)
17

18
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getTransactionsForAddress",
7
  params: [
8
    "Vote111111111111111111111111111111111111111",
9
    {
10
      "limit" => 2,
11
      "transactionDetails" => "full",
12
      "maxSupportedTransactionVersion" => 1
13
    }
14
  ],
15
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
16
)
17

18
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getTransactionsForAddress",
10
            Some(serde_json::json!([
11
    "Vote111111111111111111111111111111111111111",
12
    {
13
        "limit": 2,
14
        "transactionDetails": "full",
15
        "maxSupportedTransactionVersion": 1
16
    }
17
])),
18
            None,
19
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
20
        )
21
        .await?;
22

23
    println!("{result}");
24
    Ok(())
25
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getTransactionsForAddress",
10
            Some(serde_json::json!([
11
    "Vote111111111111111111111111111111111111111",
12
    {
13
        "limit": 2,
14
        "transactionDetails": "full",
15
        "maxSupportedTransactionVersion": 1
16
    }
17
])),
18
            None,
19
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
20
        )
21
        .await?;
22

23
    println!("{result}");
24
    Ok(())
25
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "data": [
5
      {
6
        "signature": "3xTVgD66gwavvNfMeS6PeQKJYEpSgpSk7DKhQD8oGSGW5vts89xM6mCDckkQZftrQXXyxptBJ2YvbcAb4CFVbEAW",
7
        "slot": 440303193,
8
        "transactionIndex": 1866,
9
        "err": null,
10
        "memo": null,
11
        "blockTime": 1787158280,
12
        "confirmationStatus": "finalized"
13
      },
14
      {
15
        "signature": "5o7p4sFu29mHqdKfPdgzf8kTGJGZ1vRHnJVDMmF1MsPKZBiuKJnJSY4ukoemHAXs58PhMjTZgRfvD4QUmo8EPxF4",
16
        "slot": 440303193,
17
        "transactionIndex": 1865,
18
        "err": null,
19
        "memo": null,
20
        "blockTime": 1787158280,
21
        "confirmationStatus": "finalized"
22
      }
23
    ],
24
    "paginationToken": "440303193:1865"
25
  },
26
  "id": 1
27
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "data": [
5
      {
6
        "signature": "3xTVgD66gwavvNfMeS6PeQKJYEpSgpSk7DKhQD8oGSGW5vts89xM6mCDckkQZftrQXXyxptBJ2YvbcAb4CFVbEAW",
7
        "slot": 440303193,
8
        "transactionIndex": 1866,
9
        "err": null,
10
        "memo": null,
11
        "blockTime": 1787158280,
12
        "confirmationStatus": "finalized"
13
      },
14
      {
15
        "signature": "5o7p4sFu29mHqdKfPdgzf8kTGJGZ1vRHnJVDMmF1MsPKZBiuKJnJSY4ukoemHAXs58PhMjTZgRfvD4QUmo8EPxF4",
16
        "slot": 440303193,
17
        "transactionIndex": 1865,
18
        "err": null,
19
        "memo": null,
20
        "blockTime": 1787158280,
21
        "confirmationStatus": "finalized"
22
      }
23
    ],
24
    "paginationToken": "440303193:1865"
25
  },
26
  "id": 1
27
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free