getSignaturesForAddress

Returns signatures for confirmed transactions that include the given address in their accountKeys list. Returns signatures backwards in time from the provided signature or most recent confirmed block.

Parameters

addressstring required

Account address as base-58 encoded string.

configobject optional

Configuration object.

commitmentstring

Commitment level.

limitnumber

Maximum transaction signatures to return (1-1000, default: 1000).

beforestring

Start searching backwards from this signature.

untilstring

Search until this transaction signature.

minContextSlotnumber

The minimum slot.

Result

array

Array of transaction signature information objects with signature, slot, err, memo, and blockTime.

Solana

As we don't yet store historical data on Solana, if you select a slot range outside of our cache, we will return an error message with the range of slots in our cache. getSignaturesForAddress will return an empty set "[]" (no error) when no "before" parameter is supplied, or when "before" resolves to a slot within the cache window.

Example

JSON

{

"jsonrpc": "2.0",

"id": 1,

"error": {

"code": -32017,

"message": "Requested range predates cache window",

"data": {

"oldestSlot": 938489449,

"latestSlot": 938490157

}

Fogo

On Fogo Mainnet (not Testnet), we have historical data available and this method will query it normally.

Example

Request

JSON

curl "https://eu.fluxrpc.com?key=<your-API-key>" -s -X POST -H "Content-Type: application/json" -d '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignaturesForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    { "commitment": "finalized", "limit": 1 }
  ]
}'

Response

JSON

{

"jsonrpc": "2.0",

"result": [

{

"blockTime": 1654173549,

"confirmationStatus": "finalized",

"err": null,

"memo": null,

"signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",

"slot": 114

}

"id": 1

}

getTransactionCount

getTransactionsForAddress