How to Use getSignaturesForAddress

​

Common Use Cases

• Account Transaction History: Displaying the past transactions for a user’s wallet. For more advanced parsing of transaction history, consider using Helius’s Enhanced Transactions API.
• Activity Auditing: Reviewing all transactions associated with a particular smart contract or account.
• Specific Transaction Lookup: Finding a specific transaction by iterating through an account’s history if only the involved address is known.
• Data Indexing: Building a localized index of transactions for faster querying and analysis.

​

Request Parameters

1. address (string): (Required) The base-58 encoded public key of the account for which to retrieve transaction signatures.
2. options (object, optional): An optional configuration object with the following fields:
   • limit (number, optional): The maximum number of signatures to return. The default is 1000, and the maximum allowed is 1000.
   • before (string, optional): A base-58 encoded transaction signature. If provided, the query will start searching for transactions before this signature.
   • until (string, optional): A base-58 encoded transaction signature. If provided, the query will search for transactions until this signature is reached (exclusive).
   • commitment (string, optional): Specifies the commitment level to use for the query. Supported values are finalized, confirmed, or processed. If omitted, the default commitment of the RPC node is used (usually finalized).
   • minContextSlot (number, optional): The minimum slot that the request can be evaluated at. This is not a filter on historical transactions but sets the minimum slot for the node’s context.

​

Response Structure

• signature (string): The base-58 encoded transaction signature.
• slot (u64): The slot in which the transaction was processed.
• err (object | null): An error object if the transaction failed, or null if it succeeded.
• memo (string | null): The memo associated with the transaction, if any.
• blockTime (i64 | null): The estimated production time of the block containing the transaction, as a Unix timestamp (seconds since epoch). null if not available.
• confirmationStatus (string | null): The confirmation status of the transaction (e.g., processed, confirmed, finalized). null if not available (e.g., for older Helius responses).

​

Examples

​

1. Get the Latest Signatures for an Address

# Replace <api-key> with your Helius API key
# Replace SYSTEM_PROGRAM_ID with the address you want to query
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "11111111111111111111111111111111" 
    ]
  }'

​

2. Get Signatures with a Limit

# Replace <api-key> with your Helius API key
# Replace TARGET_ACCOUNT_ADDRESS with the address you want to query
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "TARGET_ACCOUNT_ADDRESS",
      {
        "limit": 5 
      }
    ]
  }'

​

3. Paginating Through Transaction History

# Initial request (get the latest 2)
# Replace <api-key> with your Helius API key
# Replace TARGET_ACCOUNT_ADDRESS with the address you want to query
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "TARGET_ACCOUNT_ADDRESS",
      { "limit": 2 }
    ]
  }'

# Suppose the last signature from the above response was LAST_SIGNATURE_FROM_PREVIOUS_BATCH
# Fetch the next 2 transactions before that one
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "TARGET_ACCOUNT_ADDRESS",
      { 
        "limit": 2,
        "before": "LAST_SIGNATURE_FROM_PREVIOUS_BATCH" 
      }
    ]
  }'

​

Developer Tips

• Pagination: To get a complete transaction history for an active account, you’ll likely need to make multiple requests, using the before parameter with the last signature received in the previous batch and a limit.
• Rate Limits: Be mindful of RPC node rate limits when fetching extensive transaction histories.
• Order: Signatures are always returned from newest to oldest.
• limit Parameter: The limit parameter can be between 1 and 1000. If not specified, it defaults to 1000.
• until Parameter: This parameter can be used to stop fetching signatures if a known older signature is reached, which can be useful if you only need transactions up to a certain point.
• minContextSlot: This parameter does not filter historical transactions. It specifies the minimum slot the RPC node should use for its context when evaluating the request. If the node’s state is older than this slot, it may return an error.
• Transaction Details: This method only returns signatures and basic information. To get full transaction details, you would use the getTransaction method with each signature.