getSignatureStatuses

Returns the statuses of a list of signatures.

Parameters


  • <array of base-58 encoded string> - An array of transaction signatures to confirm
  • <object> - (optional) Configuration object containing the following field:
    • searchTransactionHistory: <bool> - if true, a Solana node will search its ledger cache for any signatures not found in the recent status cache

Results


Known Tx


  • <object>
    • slot: <u64> - The slot the transaction was processed
    • confirmations: <usize | null> - Number of blocks since signature confirmation, null if rooted, as well as finalized by a supermajority of the cluster
    • err: <object | null> - Error if transaction failed, null if transaction succeeded.
    • confirmationStatus: <string | null> - The transaction's cluster confirmation status; either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.

Unknown Tx


  • <null> - Unknown transaction

Example


Request


curl --location --request POST 'https://solana-mainnet.g.alchemy.com/v2/demo/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "getSignatureStatuses",
    "jsonrpc": "2.0",
    "params": [
        [
            "28P1gdVq52uEbCHns4EL5DCMjU5PtcBo5M3Gju4FX8DLwjLPDchudttnQapAxYy5dkdVZ6sqa6pvtgC5mbKLqfQA"
        ],
        {
            "searchTransactionHistory": true
        }
    ]
}'

Response


{
    "jsonrpc": "2.0",
    "result": {
        "context": {
            "slot": 137569378
        },
        "value": [
            {
                "confirmationStatus": "finalized",
                "confirmations": null,
                "err": null,
                "slot": 137529522,
                "status": {
                    "Ok": null
                }
            }
        ]
    }
}
Language
URL