Please note that, in addition to the plan-level rate limits, the getTokenAccountsByDelegate method has a specific rate limit of 10 requests per second. This limit may change without notice to ensure system stability. For high-demand use cases, please reach out to discuss potential solutions.

Parameters

pubkey

string

The Pubkey of account delegate to query encoded as base-58 string

object

object

The JSON object with the following fields:

mint

string

The Pubkey of the specific token Mint to limit accounts to, as base-58 encoded string

programId

string

The Pubkey of the Token program ID that owns the accounts, as base-58 encoded string

object

object

The JSON object with the following fields:

commitment

string

The level of commitment required for the query. The options include:

finalized

string

The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized

confirmed

string

The node will query the most recent block that has been voted on by the supermajority of the cluster

processed

string

The node will query its most recent block. Note that the block may not be complete

encoding

string

(Default: binary) The encoding format for account data. It can be one of base58 (slow), base64, binary, base64+zstd or jsonParsed

dataSlice

string

The returned account data using the provided offset: 'usize' and length: 'usize' fields; only available for base58, base64, or base64+zstd encodings

minContextSlot

integer

The minimum slot at which the request can be evaluated

Returns

result

An object with the following fields:

context

The information about the current state of the program

apiVersion

The version of the Solana RPC API to use

slot

An integer representing the slot for which to retrieve the fee calculator

value

A JSON object with the following fields:

account

An address on the Solana blockchain that is used to store assets

data

Token state data associated with the account. Format depends on encoding parameter:

• If the encoding parameter is left as the deprecated default of binary, this will be a string containing encoded binary data.
• If base58, base64, or base64+zstd is specified, this will be an array, where the first element is the encoded data string and the second element is the encoding format.
• If jsonParsed is specified, this will be JSON format {<program>: <state>}.

program

The program that manages the token

parsed

An array of parsed instructions that were executed in the block's transactions

info

An array of information objects that provide additional details about the transactions in the block

tokenAmount

The balance of the token in the token account

amount

The raw total token supply without decimals, a string representation of a u64 integer

decimals

An integer value representing the number of decimal places used by the token

uiAmount

The total token supply using mint-prescribed decimals (DEPRECATED)

uiAmountString

The total token supply as a string using mint-prescribed decimals

delegate

The public address of the delegate from which the account tokens are to be retrieved encoded as base-58 string

delegateAmount

The configuration object with the following fields:

amount

The raw total token supply without decimals, a string representation of a u64 integer

decimals

An integer value representing the number of decimal places used by the token

uiAmount

The total token supply using mint-prescribed decimals (DEPRECATED)

uiAmountString

The total token supply as a string using mint-prescribed decimals

isNative

A boolean value indicating whether the token is a native token of the Solana blockchain

mint

Provides information about the creation of new tokens

owner

The base-58 encoded Pubkey of the program this account has been assigned to

state

The current state of the token account

type

The type of the block. It can be used to differentiate between regular blocks and special blocks such as snapshot or transaction confirmation blocks

space

The amount of storage space required to store the token account

pubkey

The public key associated with the token account

Request

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc": "2.0","id": 1,"method": "getTokenAccountsByDelegate","params": ["FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",{"programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"},{"encoding": "jsonParsed"}]}'

1
curl https://docs-demo.solana-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc": "2.0","id": 1,"method": "getTokenAccountsByDelegate","params": ["FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",{"programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"},{"encoding": "jsonParsed"}]}'

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getTokenAccountsByDelegate",
16
  "params": [
17
    "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
18
    {
19
      "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
20
    },
21
    {
22
      "encoding": "jsonParsed"
23
    }
24
  ]
25
})
26

27
response = https.request(request)
28
puts response.read_body
29

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getTokenAccountsByDelegate",
16
  "params": [
17
    "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
18
    {
19
      "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
20
    },
21
    {
22
      "encoding": "jsonParsed"
23
    }
24
  ]
25
})
26

27
response = https.request(request)
28
puts response.read_body
29

1
import { createSolanaRpc, address } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  const delegateAddress = address("4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T");
7
  const programId = address("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
8

9
  try {
10
    const tokenAccounts = await solanaRpc.getTokenAccountsByDelegate(
11
      delegateAddress,
12
      { programId: programId },
13
      { encoding: "jsonParsed" }
14
    ).send();
15

16
    console.log(tokenAccounts);
17
  } catch (error) {
18
    console.error("Error fetching token accounts by delegate:", error);
19
  }
20
})();

1
import { createSolanaRpc, address } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5

6
  const delegateAddress = address("4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T");
7
  const programId = address("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
8

9
  try {
10
    const tokenAccounts = await solanaRpc.getTokenAccountsByDelegate(
11
      delegateAddress,
12
      { programId: programId },
13
      { encoding: "jsonParsed" }
14
    ).send();
15

16
    console.log(tokenAccounts);
17
  } catch (error) {
18
    console.error("Error fetching token accounts by delegate:", error);
19
  }
20
})();

1
// not currently supported by solanaJS
2
const axios = require("axios");
3
(() => {
4
  const config = {
5
    headers: {
6
      "Content-Type": "application/json",
7
    },
8
  };
9
  const data = {
10
    jsonrpc: "2.0",
11
    id: 1,
12
    method: "getTokenAccountsByDelegate",
13
    params: [
14
      "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
15
      {
16
        programId: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
17
      },
18
      {
19
        encoding: "jsonParsed",
20
      },
21
    ],
22
  };
23
  axios
24
    .post("https://docs-demo.solana-mainnet.quiknode.pro/", data, config)
25
    .then(function (response) {
26
      // handle success
27
      console.log(response.data);
28
    })
29
    .catch((err) => {
30
      // handle error
31
      console.log(err);
32
    });
33
})();
34

1
// not currently supported by solanaJS
2
const axios = require("axios");
3
(() => {
4
  const config = {
5
    headers: {
6
      "Content-Type": "application/json",
7
    },
8
  };
9
  const data = {
10
    jsonrpc: "2.0",
11
    id: 1,
12
    method: "getTokenAccountsByDelegate",
13
    params: [
14
      "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
15
      {
16
        programId: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
17
      },
18
      {
19
        encoding: "jsonParsed",
20
      },
21
    ],
22
  };
23
  axios
24
    .post("https://docs-demo.solana-mainnet.quiknode.pro/", data, config)
25
    .then(function (response) {
26
      // handle success
27
      console.log(response.data);
28
    })
29
    .catch((err) => {
30
      // handle error
31
      console.log(err);
32
    });
33
})();
34

1
from solana.rpc.api import Client
2
from solana.publickey import PublicKey
3
from solana.rpc.types import TokenAccountOpts
4
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
5
pub_key = PublicKey("FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T")
6
token_acc = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" 
7
print(solana_client.get_token_accounts_by_delegate(pub_key,TokenAccountOpts(program_id=token_acc)))

1
from solana.rpc.api import Client
2
from solana.publickey import PublicKey
3
from solana.rpc.types import TokenAccountOpts
4
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
5
pub_key = PublicKey("FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T")
6
token_acc = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" 
7
print(solana_client.get_token_accounts_by_delegate(pub_key,TokenAccountOpts(program_id=token_acc)))

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getTokenAccountsByDelegate",
16
        "params": [
17
            "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
18
            {
19
                "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
20
            },
21
            {
22
                "encoding": "jsonParsed"
23
            }
24
        ]
25
    }
26
    "#;
27
    let response = client
28
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
29
        .headers(headers)
30
        .body(json_data)
31
        .send()
32
        .await?; 
33

34
    let body = response.text().await?;
35
    println!("{}", body);
36

37
    Ok(())
38
}

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getTokenAccountsByDelegate",
16
        "params": [
17
            "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
18
            {
19
                "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
20
            },
21
            {
22
                "encoding": "jsonParsed"
23
            }
24
        ]
25
    }
26
    "#;
27
    let response = client
28
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
29
        .headers(headers)
30
        .body(json_data)
31
        .send()
32
        .await?; 
33

34
    let body = response.text().await?;
35
    println!("{}", body);
36

37
    Ok(())
38
}

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getTokenAccountsByDelegate',
7
  [
8
  "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
9
  {
10
    "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
11
  },
12
  {
13
    "encoding": "jsonParsed"
14
  }
15
],
16
  undefined,
17
  'https://docs-demo.solana-mainnet.quiknode.pro/'
18
)
19

20
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getTokenAccountsByDelegate',
7
  [
8
  "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
9
  {
10
    "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
11
  },
12
  {
13
    "encoding": "jsonParsed"
14
  }
15
],
16
  undefined,
17
  'https://docs-demo.solana-mainnet.quiknode.pro/'
18
)
19

20
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getTokenAccountsByDelegate",
8
        [
9
            "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
10
            {
11
                "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
12
            },
13
            {
14
                "encoding": "jsonParsed"
15
            }
16
        ],
17
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
18
    )
19
    print(result)
20

21
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getTokenAccountsByDelegate",
8
        [
9
            "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
10
            {
11
                "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
12
            },
13
            {
14
                "encoding": "jsonParsed"
15
            }
16
        ],
17
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
18
    )
19
    print(result)
20

21
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getTokenAccountsByDelegate",
7
  params: [
8
    "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
9
    {
10
      "programId" => "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
11
    },
12
    {
13
      "encoding" => "jsonParsed"
14
    }
15
  ],
16
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
17
)
18

19
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getTokenAccountsByDelegate",
7
  params: [
8
    "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
9
    {
10
      "programId" => "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
11
    },
12
    {
13
      "encoding" => "jsonParsed"
14
    }
15
  ],
16
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
17
)
18

19
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getTokenAccountsByDelegate",
10
            Some(serde_json::json!([
11
    "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
12
    {
13
        "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
14
    },
15
    {
16
        "encoding": "jsonParsed"
17
    }
18
])),
19
            None,
20
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
21
        )
22
        .await?;
23

24
    println!("{result}");
25
    Ok(())
26
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getTokenAccountsByDelegate",
10
            Some(serde_json::json!([
11
    "FriELggez2Dy3phZeHHAdpcoEXkKQVkv6tx3zDtCVP8T",
12
    {
13
        "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
14
    },
15
    {
16
        "encoding": "jsonParsed"
17
    }
18
])),
19
            None,
20
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
21
        )
22
        .await?;
23

24
    println!("{result}");
25
    Ok(())
26
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "context": {
5
      "slot": 1114
6
    },
7
    "value": [
8
      {
9
        "pubkey": "28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp",
10
        "account": {
11
          "data": {
12
            "program": "spl-token",
13
            "parsed": {
14
              "info": {
15
                "tokenAmount": {
16
                  "amount": "1",
17
                  "decimals": 1,
18
                  "uiAmount": 0.1,
19
                  "uiAmountString": "0.1"
20
                },
21
                "delegate": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
22
                "delegatedAmount": {
23
                  "amount": "1",
24
                  "decimals": 1,
25
                  "uiAmount": 0.1,
26
                  "uiAmountString": "0.1"
27
                },
28
                "state": "initialized",
29
                "isNative": false,
30
                "mint": "3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E",
31
                "owner": "CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD"
32
              },
33
              "type": "account"
34
            },
35
            "space": 165
36
          },
37
          "executable": false,
38
          "lamports": 1726080,
39
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
40
          "rentEpoch": 4,
41
          "space": 165
42
        }
43
      }
44
    ]
45
  },
46
  "id": 1
47
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "context": {
5
      "slot": 1114
6
    },
7
    "value": [
8
      {
9
        "pubkey": "28YTZEwqtMHWrhWcvv34se7pjS7wctgqzCPB3gReCFKp",
10
        "account": {
11
          "data": {
12
            "program": "spl-token",
13
            "parsed": {
14
              "info": {
15
                "tokenAmount": {
16
                  "amount": "1",
17
                  "decimals": 1,
18
                  "uiAmount": 0.1,
19
                  "uiAmountString": "0.1"
20
                },
21
                "delegate": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
22
                "delegatedAmount": {
23
                  "amount": "1",
24
                  "decimals": 1,
25
                  "uiAmount": 0.1,
26
                  "uiAmountString": "0.1"
27
                },
28
                "state": "initialized",
29
                "isNative": false,
30
                "mint": "3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E",
31
                "owner": "CnPoSPKXu7wJqxe59Fs72tkBeALovhsCxYeFwPCQH9TD"
32
              },
33
              "type": "account"
34
            },
35
            "space": 165
36
          },
37
          "executable": false,
38
          "lamports": 1726080,
39
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
40
          "rentEpoch": 4,
41
          "space": 165
42
        }
43
      }
44
    ]
45
  },
46
  "id": 1
47
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free