getSignaturesForAddress

getSignaturesForAddress returns a list of transaction signatures that reference the given account, ordered from newest to oldest (reverse chronological). It is the primary building block for reconstructing an account's transaction history: page through the signatures here, then fetch the full transactions with getTransaction for each one you care about.

Each entry is a lightweight SignatureInfo record — the signature itself plus the slot, success/failure status, optional memo, block time, and confirmation status. It does not include the transaction payload, so this call stays cheap even on busy accounts.

Results are paginated by signature, not by offset. A single call returns at most limit entries (default and maximum 1000). To walk further back in history, pass the oldest signature you received as before on the next call; to bound a scan to transactions newer than a known point, pass that signature as until.

JSON-RPC params is a positional array: [address, config?].

Response fields

result is an array of SignatureInfo objects, ordered newest-first.

Errors are returned in the standard JSON-RPC error envelope. See the shared errors reference for the full envelope shape and shared codes.

JavaScript (fetch)

const res = await fetch("https://api.triport.io/v1/sol", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "getSignaturesForAddress",
    params: ["Vote111111111111111111111111111111111111111", { limit: 100 }],
  }),
});


const { result } = await res.json();
for (const sig of result) {
  console.log(`${sig.signature} @ slot ${sig.slot}${sig.err ? " (failed)" : ""}`);
}

TypeScript SDK (@triport/sdk)

import { TriportClient } from "@triport/sdk";


const client = new TriportClient({ apiKey: process.env.TRIPORT_API_KEY });


const signatures = await client.solana.getSignaturesForAddress(
  "Vote111111111111111111111111111111111111111",
  { limit: 100, commitment: "finalized" }
);


for (const { signature, slot, err } of signatures) {
  console.log(`${signature} @ slot ${slot}${err ? " (failed)" : ""}`);
}

Python (triport-sdk)

import os
from triport import TriportClient


client = TriportClient(api_key=os.environ["TRIPORT_API_KEY"])


signatures = client.solana.get_signatures_for_address(
    "Vote111111111111111111111111111111111111111",
    limit=100,
    commitment="finalized",
)


for sig in signatures:
    status = " (failed)" if sig["err"] else ""
    print(f"{sig['signature']} @ slot {sig['slot']}{status}")

• Pagination: results never exceed limit (max 1000). To page backwards, take the signature of the last entry returned and pass it as before on the next request. Repeat until you receive fewer than limit entries.
• Bounded scans: pass a previously-seen signature as until to fetch only transactions newer than that point — useful for polling an account for new activity without re-reading old history.
• Failed transactions are included: entries with a non-null err represent transactions that were confirmed on-chain but failed during execution. Check err before treating a signature as a successful action.
• Resolving full transactions: this method returns only signatures and metadata. Pass each signature to getTransaction to retrieve the decoded instructions, balances, and logs.
• Related methods: getSignatureStatuses to check the confirmation state of specific signatures, and getTransaction to fetch transaction bodies.