getSignatureStatuses RPC Method

Please note that for this RPC method, the array size is limited to 5 for free accounts and 1005 for all paid accounts, subject to the method's maximum array size restrictions.

Parameters

tx signatures

string

An array of transaction signatures to confirm encoded as base-58 strings

object

array

The configuration object with the following fields:

searchTransactionHistory

boolean

(default: false) If true, the search includes the entire transaction history. If false, the search only includes recent transactions in the latest confirmed block

Returns

result

An object with the following fields:

context

The information about the current state of the program

apiVersion

The version of the Solana RPC API to use

slot

An integer representing the slot for which to retrieve the fee calculator

value

A JSON object with the following fields:

confirmationStatus

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

confirmations

The number of confirmations a transaction has received. If the transaction is finalized (i.e., confirmed at the highest level of commitment), the value will be null

err

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

slot

The slot number in which the transaction was confirmed

status

The processing status of the transaction. It returns Ok if the transaction was successful and Err if the transaction failed with TransactionError

Request

curl https://docs-demo.solana-mainnet.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc": "2.0","id": 1,"method": "getSignatureStatuses","params": [["5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS","D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff"],{"searchTransactionHistory": true}]}'

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": "getSignatureStatuses",
  "params": [
    [
      "5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS",
      "D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff"
    ],
    {
      "searchTransactionHistory": true
    }
  ]
})

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

const web3 = require("@solana/web3.js");
(async () => {
  const accountOne =
    "5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS";
  const accountTwo =
    "D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff";
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
  console.log(
    await solana.getSignatureStatuses([accountOne, accountTwo], {
      searchTransactionHistory: true,
    })
  );
})();

import { createSolanaRpc, signature } from "@solana/web3.js";

(async () => {
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");

  const signatureOne = "5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS";
  const signatureTwo = "D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff";

  try {
    const signatureStatuses = await solanaRpc.getSignatureStatuses([
      signature(signatureOne),
      signature(signatureTwo)
    ], {
      searchTransactionHistory: true
    }).send();
    
    console.log(signatureStatuses);
  } catch (error) {
    console.error("Error fetching signature statuses:", error);
  }
})();

from solana.rpc.api import Client
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
signatures = [
    "5tGfZLNDxtCtWsW1BJoeTyHvnfGqpADDfBkUgkKENQJ8iz5yTN3ae51j8m8GRFevJx82gyuKnEX7iexFsqf7X2vS",
    "D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff"
]
print(solana_client.get_signature_statuses(signatures,search_transaction_history=True))

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": "getSignaturesForAddress",
        "params": [
            "Vote111111111111111111111111111111111111111",
            {
                "limit": 1
            }
        ]
    }
    "#;
    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(())
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free