getTokenAccountsByDelegateV2

Paginated version of getTokenAccountsByDelegate with cursor-based navigation and total count.

Note: Large V1 getTokenAccountsByDelegate queries are automatically rejected and redirected here. If you received a -32600 error from V1, switch to this method with limit and paginationKey parameters.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTokenAccountsByDelegateV2",
  "params": [
    "<delegatePubkey>",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    {
      "encoding": "base64",
      "limit": 200,
      "paginationKey": null
    }
  ]
}

Parameters

Parameter	Type	Required	Description
delegatePubkey	string	Yes	Base58-encoded delegate wallet public key
filter	object	Yes	One of { "mint": "..." } or { "programId": "..." }
encoding	string	No	"base64" (default), "base58", or "base64+zstd"
dataSlice	object	No	{ offset, length } — limit returned data bytes
limit	integer	No	Page size, 1–10,000 (default 1,000)
paginationKey	string	No	Cursor from previous response to fetch the next page
changedSinceSlot	integer	No	Only return accounts updated after this slot

Filter Options

By Mint:

{ "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" }

By Program:

{ "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" }

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "context": { "slot": 123456789 },
    "value": [
      {
        "pubkey": "TokenAccountPubkey...",
        "account": {
          "data": ["base64-data...", "base64"],
          "executable": false,
          "lamports": 2039280,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "rentEpoch": 361,
          "space": 165
        }
      }
    ],
    "paginationKey": "LastPubkeyInPage...",
    "totalResults": 14
  }
}

Field	Type	Description
value	array	Token account objects for this page
paginationKey	string or null	Cursor for next page. null means this is the last page
totalResults	integer	Total number of matching token accounts

Pagination Example

Page 1:

{
  "method": "getTokenAccountsByDelegateV2",
  "params": [
    "DelegatePubkey...",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    { "encoding": "base64", "limit": 200 }
  ]
}

Page 2 (using paginationKey from page 1):

{
  "method": "getTokenAccountsByDelegateV2",
  "params": [
    "DelegatePubkey...",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    { "encoding": "base64", "limit": 200, "paginationKey": "LastPubkeyFromPage1..." }
  ]
}