---
title: getMultipleAccounts
description: >-
Returns account state and metadata for multiple addresses, in request order.
url: /docs/rpc/http/getmultipleaccounts
type: reference
hideTableOfContents: true
---
Returns account state and metadata for multiple addresses, in request order.
[`get_multiple_accounts`](https://github.com/anza-xyz/agave/blob/v3.1.8/rpc/src/rpc.rs#L558)
```jsonc !!request curl
{
"jsonrpc": "2.0",
"id": 1,
"method": "getMultipleAccounts",
"params": [
// !hover(1:4) pubkeys
[
"vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg",
"4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA"
],
// !hover(1:4) config
{
// !hover encoding
"encoding": "base64",
// !hover commitment
"commitment": "finalized"
}
]
}
```
```ts !!request title="Kit"
import { address, createSolanaRpc } from "@solana/kit";
const rpc_url = "https://api.devnet.solana.com";
const rpc = createSolanaRpc(rpc_url);
// !hover(1:4) pubkeys
let addresses = [
address("vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"),
address("4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA")
];
// !hover(1:4) config
let config = {
// !hover encoding
encoding: "base64",
// !hover commitment
commitment: "finalized"
};
let accounts = await rpc.getMultipleAccounts(addresses, config).send();
console.log(accounts);
```
```ts !!request title="web3.js"
import {
Connection,
PublicKey,
clusterApiUrl,
type GetMultipleAccountsConfig
} from "@solana/web3.js";
const connection = new Connection(clusterApiUrl("devnet"), "confirmed");
// !hover(1:4) pubkeys
let addresses = [
new PublicKey("vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"),
new PublicKey("4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA")
];
// !hover(1:3) config
let config: GetMultipleAccountsConfig = {
// !hover commitment
commitment: "finalized"
};
let accounts = await connection.getMultipleAccountsInfo(addresses, config);
console.log(accounts);
```
```rs !!request title="Rust"
use anyhow::Result;
use solana_account_decoder::UiAccountEncoding;
use solana_client::{nonblocking::rpc_client::RpcClient, rpc_config::RpcAccountInfoConfig};
use solana_commitment_config::CommitmentConfig;
use solana_sdk::pubkey;
#[tokio::main]
async fn main() -> Result<()> {
let client = RpcClient::new_with_commitment(
String::from("https://api.devnet.solana.com"),
CommitmentConfig::confirmed(),
);
// !hover(1:4) pubkeys
let addresses = [
pubkey!("vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"),
pubkey!("4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA"),
];
// !hover(1:6) config
let config = RpcAccountInfoConfig {
// !hover encoding
encoding: UiAccountEncoding::Base64.into(),
// !hover dataSlice
data_slice: None,
// !hover commitment
commitment: CommitmentConfig::finalized().into(),
// !hover minContextSlot
min_context_slot: None,
};
let accounts = client
.get_multiple_accounts_with_config(&addresses, config)
.await?;
println!("{:#?}", accounts);
Ok(())
}
```
### !params
#### !! pubkeys
!type array
!required
An array of Pubkeys to query, as base-58 encoded strings (up to a maximum
of 100)
#### !! config
!type object
Configuration object containing the following fields:
##### !! commitment
!type string
!values processed confirmed finalized
!default finalized
Solana RPC uses the following commitment levels:
| Value | Description |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `processed` | Return data from the highest slot this node has processed on the fork it currently considers best. This is the newest view, but it can still change if the cluster switches forks. |
| `confirmed` | Return data from the highest slot that at least two-thirds of active stake has directly voted to confirm. This is more stable than `processed`, but it is still a weaker guarantee than `finalized`. |
| `finalized` | Return data from the highest slot that the cluster recognizes as finalized. In practice, this means the slot has reached maximum vote lockout in validators' vote towers and is recognized by at least two-thirds of active stake. This is the strongest commitment level. |
##### !! minContextSlot
!type number
The minimum slot that the request can be evaluated at
```json title="Example"
{ "minContextSlot": 341197000 }
```
##### !! dataSlice
!type object
Request a slice of the account's data.
| Field | Type | Description |
| -------- | ------- | ----------------------------------------------------- |
| `offset` | `usize` | Byte offset from which to start reading account data. |
| `length` | `usize` | Number of bytes to return. |
```json title="Example"
{ "offset": 0, "length": 32 }
```
Data slicing is only available for `base58`, `base64`, `base64+zstd`, and
`binary` encodings.
##### !! encoding
!type string
!values base58 base64 base64+zstd binary jsonParsed
!default base64
Encoding format for account data.
| Encoding | Data format | Notes |
| ------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `base64` | `[data, "base64"]` | Recommended |
| `base58` | `[data, "base58"]` | Slow. The account's data field must be 128 bytes or fewer |
| `base64+zstd` | `[data, "base64+zstd"]` | [Zstandard](https://facebook.github.io/zstd/) compressed |
| `jsonParsed` | `{program, parsed, space}` | Falls back to `[data, "base64"]` if no parser found |
| `binary` | `string` | Deprecated. Legacy encoding retained for backwards compatibility. Same base58 encoding as `base58` with the same 128-byte data field limit, but returns data as a plain string instead of an array. Use `base64` instead |
If you use `jsonParsed`, each returned account uses the stable wrapper
`{program, parsed, space}`. The `program` field identifies the parser that
produced `parsed`. If no parser is available, the RPC node falls back to
`[data, "base64"]`.
| `program` value | Parsed account type |
| ------------------------ | ---------------------------------------------- |
| `address-lookup-table` | Address lookup table accounts |
| `bpf-upgradeable-loader` | Upgradeable loader program and buffer accounts |
| `config` | Config accounts |
| `nonce` | Durable nonce accounts |
| `spl-token` | SPL Token accounts |
| `spl-token-2022` | SPL Token 2022 accounts |
| `stake` | Stake accounts |
| `sysvar` | Sysvar accounts |
| `vote` | Vote accounts |
The nested `parsed` payload remains program-specific.
For the shared account wrapper returned by this method, see
[Account Data](/docs/rpc/json-structures#account-data).
### !!result
```jsonc !response
{
"jsonrpc": "2.0",
// !hover(1:21) result
"result": {
// !hover context
"context": { "apiVersion": "3.1.8", "slot": 341197247 },
// !hover(1:18) value
"value": [
{
"data": ["", "base64"],
"executable": false,
"lamports": 88849814690250,
"owner": "11111111111111111111111111111111",
"rentEpoch": 18446744073709551615,
"space": 0
},
{
"data": ["", "base64"],
"executable": false,
"lamports": 998763433,
"owner": "2WRuhE4GJFoE23DYzp2ij6ZnuQ8p9mJeU6gDgfsjR4or",
"rentEpoch": 18446744073709551615,
"space": 0
}
]
},
"id": 1
}
```
!type object
RpcResponse object containing:
#### !! context
!type object
Slot and API version the node used to answer this request.
| Field | Type | Description |
| ------------ | -------- | ------------------------------------------------------------------------------- |
| `slot` | `u64` | Slot at which the node evaluated this request. |
| `apiVersion` | `string` | RPC API version reported by the node. This field may be omitted by older nodes. |
#### !! value
!type array
Array containing either:
- `null` - if the account at that Pubkey doesn't exist, or
- an account object with the following fields:
Each non-null element uses the shared
[Account Data](/docs/rpc/json-structures#account-data) structure.
| Field | Type | Description |
| ------------ | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data` | `string \| [string, encoding] \| object` | Account data. If `encoding` is `binary`, this is a plain base-58 string. If `encoding` is `base58`, `base64`, or `base64+zstd`, this is `[data, encoding]`. If `encoding` is `jsonParsed`, this is `{program, parsed, space}`; if no parser is available, the RPC node falls back to `[data, "base64"]`. |
| `executable` | `bool` | Whether the account contains a program and is therefore read-only. |
| `lamports` | `u64` | Lamports assigned to this account. |
| `owner` | `string` | Program owner pubkey, as a base-58 encoded string. |
| `rentEpoch` | `u64` | Epoch at which this account next owes rent. |
| `space` | `u64 \| null` | Account data size in bytes. Current Solana RPC responses populate this field for encoded account responses. |
When `data` is returned as an object, it contains:
| Field | Type | Description |
| --------- | -------- | ------------------------------------------------------------------------------------------- |
| `program` | `string` | Name of the parser that produced the decoded account data. |
| `parsed` | `object` | Parser-specific JSON payload. Its structure depends on the owning program and account type. |
| `space` | `u64` | Account data size in bytes. |