getSignaturesForAddress

getSignaturesForAddress returns the signatures of transactions that touched a given Solana account — a SOL wallet, an SPL token account, or a program — ordered newest first. Each entry carries the signature, slot, any error, an optional memo, blockTime, and confirmationStatus, giving you a compact activity feed without pulling full transaction bodies. Pass a base-58 address and an optional config to set limit, before, and until for paging. Query it on TheRPC at https://solana.therpc.io/YOUR_API_KEY, then fetch any signature in detail with getTransaction.

Use cases

• List the most recent transactions for a Phantom wallet, a token account, or a program to build an activity tab or audit trail.
• Walk backwards through an account's full history by setting before to the last signature of the previous page and requesting the next batch.
• Detect new activity by polling and treating any signature newer than the last one you saw as a fresh event, useful for deposit or fill notifications.

Parameters

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getSignaturesForAddress",
8  "params": [
9    "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
10    {}
11  ]
12}'

Errors & troubleshooting

Common pitfalls

• A single call returns at most 1000 signatures. To read more history, page with before set to the last signature you received and repeat until the result is empty.
• The commitment option accepts only confirmed or finalized here; processed is not valid for this method.
• Deep history may live outside a pruned node, which only keeps recent slots. For an account with a long history, use an archival endpoint or you will miss older signatures.

Supported networks

• Mainnet
• Devnet

See also

• getSignatureStatuses
• getTransaction