getSignaturesForAddress RPC Method

Please note that the parameter minContextSlot is not a filter on historical transactions. You can use the before or until parameter to filter historical transactions.

Parameters

account_address

string

REQUIRED

The account address encoded as base-58 string

object

object

(Optional) The configuration object with the following fields:

limit

integer

The maximum number of transaction signatures to return (between 1 and 1000). The default value is 1000

before

string

Start searching backward from this transaction signature. If not provided, the search starts from the top of the highest max confirmed block

until

string

Searches until this transaction signature, if found before limit reached

commitment

string

The level of commitment required for the query. The options include:

minContextSlot

integer

The minimum slot at which the request can be evaluated

Returns

result

A JSON object with the following fields:

blockTime

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

confirmationStatus

The transaction's cluster confirmation status. The status can either be processed, confirmed, or finalized

err

Error code if the transaction failed or null if the transaction succeeds

memo

The memo associated with the transaction and null if no memo is present

signature

The base58-encoded signature of the transaction

slot

The slot number in which the transaction was confirmed

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  -d $'
    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getSignaturesForAddress",
      "params": ["Vote111111111111111111111111111111111111111",{"limit": 1}]
      }
  '

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

url = URI("https://docs-demo.solana-mainnet.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({
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignaturesForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    {
      "limit": 1
    }
  ]
})

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

const web3 = require("@solana/web3.js");
(async () => {
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
  const publicKey = new web3.PublicKey(
    "Vote111111111111111111111111111111111111111"
  );
  console.log(await solana.getSignaturesForAddress(publicKey, { limit: 1 }));
})();

import base58
from solana.rpc.api import Client
from solders.pubkey import Pubkey

solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")

encoded_pubkey = "Vote111111111111111111111111111111111111111"
decoded_pubkey = base58.b58decode(encoded_pubkey)

print(len(decoded_pubkey)) #32 bytes

address = Pubkey(decoded_pubkey)
print(solana_client.get_signatures_for_address(address, limit=1))

use reqwest::header;
use reqwest::Client;
use std::error::Error;

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

    let client = Client::new();
    let json_data = r#"
    {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "getSignatureStatuses",
        "params": [
            [
                "5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS",
                "D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff"
            ],
            {
                "searchTransactionHistory": true
            }
        ]
    }
    "#;
    let response = client
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
        .headers(headers)
        .body(json_data)
        .send()
        .await?; 

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

    Ok(())
}

Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "blockTime": 1745463619,
      "confirmationStatus": "finalized",
      "err": null,
      "memo": null,
      "signature": "2tDqVFnHmfmYsp48dDXcK7V4MycnyvpMKjKLMJ7egRujMNo44fyCnHCyN8MuWuCb2B6kEeMfQmccLzPoSxU9WSiK",
      "slot": 335501813
    }
  ],
  "id": 1
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free