Skip to main content
POST
/
getCompressedAccount
cURL
curl --request POST \
  --url 'https://devnet.helius-rpc.com/getCompressedAccount?api-key=%3Capi_key%3E%2FgetCompressedAccount' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "test-account",
  "jsonrpc": "2.0",
  "method": "getCompressedAccount",
  "params": {
    "address": null,
    "hash": "11111111111111111111111111111111"
  }
}
'
{
  "id": "test-account",
  "jsonrpc": "2.0",
  "error": {
    "code": 123,
    "message": "<string>"
  },
  "result": {
    "context": {
      "slot": 100
    },
    "value": {
      "hash": "11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP",
      "lamports": 100,
      "leafIndex": 100,
      "owner": "111111131h1vYVSYuKP6AhS86fbRdMw9XHiZAvAaj",
      "slotCreated": 100,
      "tree": "111111131h1vYVSYuKP6AhS86fbRdMw9XHiZAvAaj",
      "address": "111111131h1vYVSYuKP6AhS86fbRdMw9XHiZAvAaj",
      "data": {
        "data": "SGVsbG8sIFdvcmxkIQ==",
        "dataHash": "11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP",
        "discriminator": 100
      },
      "seq": 100
    }
  }
}
The getCompressedAccount RPC method retrieves information about a specific compressed account using either its address or hash. Information includes the compressed account state, balance, and metadata.
You can test this methods via the OpenAPI example or custom examples below.
Common Use Cases
  • Checking Compressed Account Balance: Retrieve the lamport balance of any compressed account.
  • Verifying Account Existence: Check if a compressed account exists and has been initialized with data or lamports.
  • Inspecting Compressed Account Data: Access the stored data within a compressed account, including program-specific state.
  • Identifying Account Owner: Determine which program owns a compressed account to understand how its data should be interpreted.
  • Merkle Tree Information: Get the merkle tree context including leaf index and sequence number for proof generation.
Parameters
  1. address (string, optional): The base-58 encoded address of the compressed account to query.
  2. hash (string, optional): The base-58 encoded 32-byte hash of the compressed account.
Note: Either address OR hash must be provided, but not both. If neither is provided, the request will fail. Response Returns compressed account information directly, or null if account not found:
  • hash (string): The 32-byte hash of the compressed account as a base-58 string.
  • owner (string): The base-58 encoded public key of the program that owns this account.
  • lamports (number): The number of lamports owned by the account.
  • tree (string): The public key of the merkle tree storing this account.
  • leafIndex (number): The leaf index of this account in the merkle tree.
  • seq (number): The sequence number of this account.
  • slotCreated (number): The slot when this account was created.
  • data (object, optional): The account data object containing:
    • discriminator (BN): The account discriminator as BN object.
    • data (string): Base64 encoded account data.
    • dataHash (string): The 32-byte hash of the account data.
Developer Tips
  • Address vs Hash: Use address when you know the account’s derived address, and hash when you have the specific hash from a previous query or transaction
  • Hash Format: When using the hash parameter, pass the hash value directly as returned from other RPC methods (like getCompressedAccountsByOwner). Hash values must be used immediately after retrieval for accurate results
  • Error Handling: Always check if the returned value is null before accessing account properties, as the account may not exist
  • Merkle Context: The returned leafIndex, tree, and seq fields are crucial for generating merkle proofs when updating or transferring compressed accounts
  • Data Interpretation: The data field contains program-specific information. Use the discriminator to identify the account type and parse the data accordingly
  • Rate Limits: Be mindful of RPC rate limits when making frequent queries. Consider batching requests when possible
  • Hash Verification: The dataHash field allows you to verify the integrity of the account data without storing the full data on-chain
Examples The below examples work - just make sure you installed the dependencies. 
npm install @lightprotocol/stateless.js @solana/web3.js
For Rust examples: Create a Cargo project with these dependencies in Cargo.toml:
[dependencies]
tokio = { version = "1.0", features = ["full"] }
anyhow = "1.0"
solana-sdk = "1.18"
# light-client = "0.1"  # Add when available
serde_json = "1.0"
Example: Fetching Compressed Account by Address Let’s fetch information for a compressed account using its address. 
curl -X POST https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getCompressedAccount",
    "params": {
      "address": "11111113R2cuenjG5nFubqX9Wzuukdin2YfGQVzu5"
    }
  }'
Example: Fetching Compressed Account by Hash You can also query a compressed account using its hash.
TypeScript
import { Rpc, createRpc, bn } from '@lightprotocol/stateless.js';
import { PublicKey } from '@solana/web3.js';

async function getCompressedAccountByHash(): Promise<void> {
  const rpc: Rpc = createRpc(
    'https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY',
    'https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY'
  );

  try {
    // First, get compressed accounts to obtain a real hash
    const owner = new PublicKey('4LhEEtzAhM6wEXJR2YQHPEs79UEx8e6HncmeHbqbW1w1');
    const accounts = await rpc.getCompressedAccountsByOwner(owner);

    if (accounts.items.length === 0) {
      console.log('No compressed accounts found');
      return;
    }

    // Query by hash using a real hash from the first account
    const hash = bn(accounts.items[0].hash);
    const accountInfo = await rpc.getCompressedAccount(undefined, hash);

    if (accountInfo) {
      console.log('Compressed Account Info:', {
        hash: accountInfo.hash,
        owner: accountInfo.owner,
        lamports: accountInfo.lamports,
        tree: accountInfo.tree,
        leafIndex: accountInfo.leafIndex
      });
    } else {
      console.log('Compressed account not found.');
    }
  } catch (error: unknown) {
    console.error('Error:', error);
  }
}

getCompressedAccountByHash();

Body

application/json
​
id
enum<string>
required

An ID to identify the request.

Available options:
test-account
​
jsonrpc
enum<string>
required

The version of the JSON-RPC protocol.

Available options:
2.0
​
method
enum<string>
required

The name of the method to invoke.

Available options:
getCompressedAccount
​
params
object
required

Request for compressed account data

Example:
{
  "address": null,
  "hash": "11111111111111111111111111111111"
}

Response

​
id
enum<string>
required

An ID to identify the response.

Available options:
test-account
​
jsonrpc
enum<string>
required

The version of the JSON-RPC protocol.

Available options:
2.0
​
error
object
​
result
object