getProgramAccountsV2 — Solana JSON-RPC

getProgramAccountsV2 is the paginated form of getProgramAccounts: it returns the accounts owned by a given program Pubkey, with the same filtering and encoding controls, but one page at a time. Pass limit to size the page; each response carries a paginationKey that you send back to get the next page. That makes it the method to use when a program owns more accounts than fit comfortably in one response.

Like its predecessor, this is one of the two heavy Solana read methods (sol_read_rpc_heavy). Scanning all accounts owned by a program is expensive for the node, so it is throttled far more aggressively than ordinary reads — just 2 rps on the Free trial, rising to 80 rps on business. Budget your calls accordingly, cache results where you can, and always narrow the scan with filters (a dataSize and/or memcmp filter) rather than fetching every account a program owns.

Positional params array: [programId, config?]. The config object takes the getProgramAccounts options and adds two V2 fields, limit and paginationKey.

The result is one page: an accounts array, the cursor for the next page and the number of accounts in this page. With withContext: true the same object is returned under result.value, next to result.context.

Errors use the standard JSON-RPC envelope (error.code, error.message, error.data).

Example rate-limit response — HTTP 429 with a plain body, not a JSON-RPC envelope (note the much lower heavy-tier limit):

{
  "error": "rate_limited",
  "message": "Rate limit reached: your free plan allows 2 requests/s for sol_read_rpc_heavy. Retry in 1s (see the Retry-After header) or upgrade for a higher limit at https://triport.io/app/pricing",
  "current_tier": "free",
  "category": "sol_read_rpc_heavy",
  "limit_rps": 2,
  "burst_capacity": 4,
  "retry_after_sec": 1,
  "upgrade_url": "https://triport.io/app/pricing",
  "docs_url": "https://triport.io/errors/http-429-rate-limit"
}

See the shared errors reference for the full envelope and retry guidance.

JavaScript (fetch)

// Walk every page of a filtered scan. Stay under your heavy-read RPS.
async function page(paginationKey) {
  const res = await fetch("https://triport.io/sol", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 1,
      method: "getProgramAccountsV2",
      params: [
        "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        {
          encoding: "base64",
          limit: 1000,
          filters: [
            { dataSize: 165 },
            { memcmp: { offset: 0, bytes: "So11111111111111111111111111111111111111112" } },
          ],
          ...(paginationKey ? { paginationKey } : {}),
        },
      ],
    }),
  });
  const { result } = await res.json();
  return result;
}


let key;
do {
  const { accounts, paginationKey, count } = await page(key);
  console.log(`${count} accounts`, accounts[0]?.pubkey);
  key = paginationKey; // null on the last page
} while (key);

• Beta: published schema not final. The endpoint serves V2 today and the fields above are what it returns; the OpenRPC schema still types the result as an open object until spec api.2.2+. Re-check this page when that spec ships. getProgramAccounts is the stable, unpaginated contract.
• Paging. Keep sending the returned paginationKey until it comes back null — that page is the last one. Each page is a separate heavy read and counts against your RPS budget.
• Heavy rate limits. getProgramAccountsV2 shares the sol_read_rpc_heavy budget with getProgramAccounts — only 2 / 5 / 20 / 80 rps by tier. These are an order of magnitude lower than standard reads (20 / 60 / 200 / 600 rps); see rate limits and tiers.
• Always filter. Use dataSize and memcmp filters to restrict the scan server-side. Unfiltered scans over large programs are slow and burn through your limited heavy-read budget quickly.
• Related methods: getProgramAccounts (the stable v1), getAccountInfo (single account), and getMultipleAccounts (batch of known addresses).