Please note that, in addition to the plan-level rate limits, the getProgramAccounts method has a specific rate limit of 3 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

address

string

The address of the program encoded as a base-58 string

object

object

The configuration 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 the cluster has recognized 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

minContextSlot

integer

The minimum slot at which the request can be evaluated

withContext

boolean

Wraps the result in a RpcResponse JSON object

filters

array

Filter results using up to 4 filter objects. See Filtering

memcmp

object

Compares a slice of account data at the given offset to the provided bytes

offset

integer

Byte offset into account data to start comparing

bytes

string

Base-58 encoded bytes to match

dataSize

integer

Matches accounts whose data length equals this value in bytes

dataSlice

object

Request a slice of each account's data. Only available for base58, base64, or base64+zstd encodings.

• When using base58, binary, or no encoding (defaults to base58), length must be ≤ 128 bytes. Requests exceeding 128 bytes with these encodings will be rejected with error code -32671. To return more than 128 bytes, use base64, base64+zstd, or jsonParsed encoding.

offset

integer

Byte offset from which to start reading account data

length

integer

Number of bytes to return

encoding

string

(Default: binary) Encoding format for the returned account data. Explicitly setting this field is recommended to avoid size or performance issues. Valid options include 'base58', 'base64', 'binary', 'base64+zstd', and 'jsonParsed' (valid for certain native programs).

Returns

result

array

Array of program accounts. When withContext is true, the RPC returns an RpcResponse object with context and value (this array) instead of the array at the top level.

pubkey

string

The account public key encoded as base-58 string

account

object

Account state for the matching program-owned account

data

string | array | object

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>}.

executable

boolean

A boolean indicating if the account contains a program (and is strictly read-only)

lamports

integer

The number of lamports assigned to this account as u64 (64-bit unsigned integer)

owner

string

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

rentEpoch

integer

The epoch at which this account will next owe rent, as u64 (64-bit unsigned integer)

space

integer

The amount of storage space required to store the account data in bytes

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":"getProgramAccounts", "params": ["ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"]}'

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":"getProgramAccounts", "params": ["ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"]}'

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": "getProgramAccounts",
16
  "params": [
17
    "PROGRAM_TO_SEARCH"
18
  ]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

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": "getProgramAccounts",
16
  "params": [
17
    "PROGRAM_TO_SEARCH"
18
  ]
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const url = "https://docs-demo.solana-mainnet.quiknode.pro/";
4
  const solana = new web3.Connection(url);
5
  console.log(
6
    await solana.getProgramAccounts(new web3.PublicKey("YOUR_PROGRAM_ADDRESS"))
7
  );
8
})();
9

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const url = "https://docs-demo.solana-mainnet.quiknode.pro/";
4
  const solana = new web3.Connection(url);
5
  console.log(
6
    await solana.getProgramAccounts(new web3.PublicKey("YOUR_PROGRAM_ADDRESS"))
7
  );
8
})();
9

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

3
(async () => {
4
  const url = "https://docs-demo.solana-mainnet.quiknode.pro/";
5
  const solanaRpc = createSolanaRpc(url);
6
  
7
  try {
8
    const programAddress = address("YOUR_PROGRAM_ADDRESS");
9
    const programAccounts = await solanaRpc.getProgramAccounts(programAddress).send();
10
    
11
    console.log(JSON.stringify(programAccounts, null, 2));
12
  } catch (error) {
13
    console.error("Error fetching program accounts:", error);
14
  }
15
})();

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

3
(async () => {
4
  const url = "https://docs-demo.solana-mainnet.quiknode.pro/";
5
  const solanaRpc = createSolanaRpc(url);
6
  
7
  try {
8
    const programAddress = address("YOUR_PROGRAM_ADDRESS");
9
    const programAccounts = await solanaRpc.getProgramAccounts(programAddress).send();
10
    
11
    console.log(JSON.stringify(programAccounts, null, 2));
12
  } catch (error) {
13
    console.error("Error fetching program accounts:", error);
14
  }
15
})();

1
from solana.rpc.api import Client
2
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
3
print(solana_client.get_program_accounts("YOUR_PROGRAM_ADDRESS"))

1
from solana.rpc.api import Client
2
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
3
print(solana_client.get_program_accounts("YOUR_PROGRAM_ADDRESS"))

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": "getProgramAccounts",
16
        "params": [
17
            "PROGRAM_TO_SEARCH"
18
        ]
19
    }
20
    "#;
21
    let response = client
22
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
23
        .headers(headers)
24
        .body(json_data)
25
        .send()
26
        .await?; 
27

28
    let body = response.text().await?;
29
    println!("{}", body);
30

31
    Ok(())
32
}

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": "getProgramAccounts",
16
        "params": [
17
            "PROGRAM_TO_SEARCH"
18
        ]
19
    }
20
    "#;
21
    let response = client
22
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
23
        .headers(headers)
24
        .body(json_data)
25
        .send()
26
        .await?; 
27

28
    let body = response.text().await?;
29
    println!("{}", body);
30

31
    Ok(())
32
}

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getProgramAccounts',
7
  [
8
  "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
9
],
10
  undefined,
11
  'https://docs-demo.solana-mainnet.quiknode.pro/'
12
)
13

14
console.log(result)

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getProgramAccounts',
7
  [
8
  "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
9
],
10
  undefined,
11
  'https://docs-demo.solana-mainnet.quiknode.pro/'
12
)
13

14
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
        "getProgramAccounts",
8
        [
9
            "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
10
        ],
11
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
12
    )
13
    print(result)
14

15
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
        "getProgramAccounts",
8
        [
9
            "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
10
        ],
11
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
12
    )
13
    print(result)
14

15
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: "getProgramAccounts",
7
  params: [
8
    "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
9
  ],
10
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
11
)
12

13
puts result

1
require "quicknode_sdk"
2

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

5
result = qn.rpc.call(
6
  method: "getProgramAccounts",
7
  params: [
8
    "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
9
  ],
10
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
11
)
12

13
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
            "getProgramAccounts",
10
            Some(serde_json::json!([
11
    "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
12
])),
13
            None,
14
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

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
            "getProgramAccounts",
10
            Some(serde_json::json!([
11
    "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
12
])),
13
            None,
14
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": [
4
    {
5
      "pubkey": "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY",
6
      "account": {
7
        "data": "2R9jLfiAQ9bgdcw6h8s44439",
8
        "executable": false,
9
        "lamports": 15298080,
10
        "owner": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
11
        "rentEpoch": 28,
12
        "space": 42
13
      }
14
    }
15
  ],
16
  "id": 1
17
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": [
4
    {
5
      "pubkey": "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY",
6
      "account": {
7
        "data": "2R9jLfiAQ9bgdcw6h8s44439",
8
        "executable": false,
9
        "lamports": 15298080,
10
        "owner": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T",
11
        "rentEpoch": 28,
12
        "space": 42
13
      }
14
    }
15
  ],
16
  "id": 1
17
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free