getProgramAccountsV2

getProgramAccountsV2 returns accounts owned by programId in ascending pubkey order, one page at a time. Use it instead of getProgramAccounts when a program can have more than 10,000 accounts, or when you only want accounts that changed after a known slot. Send it to the complete ThorEdge RPC URL like any other method.

Parameters

string

required

Program pubkey as a base-58 string.

object

Options for the query. All fields are optional.

Show properties

string

default:"base64"

base64, base58, base64+zstd, or jsonParsed. jsonParsed decodes token accounts and mints; other accounts fall back to base64.

object

{ "offset": <int>, "length": <int> }. Returns only that slice of data. Ignored with jsonParsed.

array

Filter objects that must all match. Each object is one of:

{ "dataSize": <int> }: account data length in bytes.
{ "memcmp": { "offset": <int>, "bytes": "<string>", "encoding": "base58" | "base64" } }: byte comparison at offset. bytes is base-58 unless encoding is "base64".

An offset-0 memcmp of 32 bytes on a token program, or of 8 bytes on any other program, is served from an index and is the fastest way to narrow a large program.

integer

default:"1000"

Accounts per page, from 1 through 10000. Values outside the range are clamped, not rejected.

string

The paginationKey returned by the previous page. Omit it for the first page.

integer

Return only accounts updated after this slot.

string

Accepted and ignored. Results reflect FastGate’s indexed slot.

Response

The result is a top-level object; there is no context wrapper.

array

Matching accounts for this page, ordered by pubkey.

Show item

string

Account pubkey, base-58.

object

lamports, data, owner, executable, rentEpoch, space. data is [<encoded>, <encoding>], or a parsed object with jsonParsed.

integer

Number of accounts in this page. It is not the total across pages.

string | null

Cursor for the next page. null when this page was shorter than limit. A page that exactly fills limit still returns a key; the following request then returns an empty accounts array and null.

Paginate

Repeat the same request with paginationKey set to the value you received, keeping filters, encoding, and limit unchanged, until paginationKey is null. Each page reflects the indexed state at the time it is served; accounts that change between pages can appear in a later page.

Errors

Code	Message	Cause
`-32602`	`Invalid param: could not decode pubkey <value>` / `Invalid param: WrongSize`	`programId` or `paginationKey` is not a valid 32-byte base-58 key.
`-32602`	`Invalid param: limit must be a number`	`limit` is not an integer.
`-32602`	`Invalid param: filter must be dataSize or memcmp`	A filter object has an unknown shape.
`-32602`	`Invalid param: memcmp bytes (base58)` / `(base64)`	`memcmp.bytes` failed to decode.
`-32602`	`unsupported encoding: <value>`	Unknown `encoding`.
`-32003`	`Query exceeded the read budget; narrow the filters or use pagination`	The scan ran past its time budget. Add a `dataSize` or offset-0 `memcmp` filter, or lower `limit`.

curl --fail-with-body "$THORNODE_RPC_URL" \
  --header 'content-type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getProgramAccountsV2",
    "params": [
      "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      {
        "encoding": "base64",
        "filters": [{ "dataSize": 82 }],
        "dataSlice": { "offset": 0, "length": 0 },
        "limit": 2
      }
    ]
  }'

const response = await fetch(process.env.THORNODE_RPC_URL, {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "getProgramAccountsV2",
    params: [
      "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      {
        encoding: "base64",
        filters: [{ dataSize: 82 }],
        dataSlice: { offset: 0, length: 0 },
        limit: 2,
      },
    ],
  }),
});
const { result } = await response.json();
console.log(result.count, result.paginationKey);

{
  "jsonrpc": "2.0",
  "result": {
    "accounts": [
      {
        "pubkey": "11111ZSvet4hKEYUAETZWELHgkeYjyNZovzcypyAWs",
        "account": {
          "lamports": 1461600,
          "data": ["", "base64"],
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "executable": false,
          "rentEpoch": 18446744073709551615,
          "space": 82
        }
      },
      {
        "pubkey": "1111iH2XXowNevv9LrNNZvBDqZHqTn78dBUWnsx6dy",
        "account": {
          "lamports": 1461600,
          "data": ["", "base64"],
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "executable": false,
          "rentEpoch": 18446744073709551615,
          "space": 82
        }
      }
    ],
    "count": 2,
    "paginationKey": "1111iH2XXowNevv9LrNNZvBDqZHqTn78dBUWnsx6dz"
  },
  "id": 1
}

API reference

ThorEdge RPC

FastGate RPC

Yellowstone gRPC

Bifrost

Hofund

Parameters

Response

Paginate

Errors

​Parameters

​Response

​Paginate

​Errors

Parameters

Response

Paginate

Errors