getSignaturesForAddress

Returns confirmed transaction signatures for an address, in reverse chronological order.

Returns a list of confirmed transaction signatures involving the given address, ordered from newest to oldest. Use before and until to paginate through transaction history.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignaturesForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    { "limit": 10 }
  ]
}

Parameters

address · string · required

Base-58 encoded account address to fetch transaction history for.

limit · number

Maximum number of signatures to return. Between 1 and 1000. Defaults to 1000.

before · string

Start the search before this transaction signature (exclusive). Returns transactions older than this signature.

until · string

Stop searching at this transaction signature (inclusive). Returns transactions up to and including this signature.

commitment · string

Commitment level for the query. Only confirmed and finalized are supported.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
      "slot": 114,
      "err": null,
      "memo": null,
      "blockTime": 1700000000,
      "confirmationStatus": "finalized"
    }
  ]
}

result · array

Array of signature info objects, ordered from newest to oldest.

result[].signature · string

The transaction signature as a base-58 encoded string.

result[].slot · number

The slot in which the transaction was confirmed.

result[].err · object | null

null if the transaction succeeded. Contains the error object if it failed.

result[].memo · string | null

Memo associated with the transaction, or null.

result[].blockTime · number | null

Unix timestamp (seconds) of the block, or null if not available.

result[].confirmationStatus · string

The transaction’s confirmation status: processed, confirmed, or finalized.

Example

cURL

curl "https://rpc.solami.fast/sol?api_key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "Vote111111111111111111111111111111111111111",
      { "limit": 10 }
    ]
  }'