---
title: "Get Solana subaccount balances for entities"
method: POST
path: "/balances/solana/subaccounts/entity"
tags: ["Balances"]
---

# Get Solana subaccount balances for entities

`POST /balances/solana/subaccounts/entity`

## Request

- Base URL: `https://api.arkm.com/x402`
- URL: `https://api.arkm.com/x402/balances/solana/subaccounts/entity`
- Auth: none required

Get Solana subaccount balances for entities. $0.60 per call.

## Request body

- object
  - `entities` union, required: Comma-separated list of entity IDs to query subaccount balances for. IDs are case-sensitive; look one up with GET /inte…
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `limit` union: Maximum number of subaccount balance entries to return. Default: 1000. Max: 1000.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean
  - `pricingID` union, required: The CoinGecko pricing ID of the token to query subaccount balances for. Filters results to balances of this token.
    - string
    - number
    - boolean
    - union[]
      - union
        - string
        - number
        - boolean

## Response `200`

Successful response

- unknown[]
  - unknown

## Other responses

- `400`: Fatal for the request as written: validation failed or required JSON body fields are missing. Fix the request; do not retry it unchanged. Payment is not settled.
- `402`: Payment challenge, not an application error. Read the base64 x402 v2 challenge from PAYMENT-REQUIRED, sign it, and retry the same request with PAYMENT-SIGNATURE. If a post-payment 402 omits PAYMENT-REQUIRED, verification failed: read the new challenge, re-sign, and retry once.
- `404`: The upstream Arkham resource does not exist. Fatal for the same input. Payment is not settled.
- `429`: Per-wallet endpoint rate limit exceeded. Retry with at least 1 second of backoff; keep heavy endpoints at no more than 5 requests per second.
- `5XX`: Arkham failed or timed out, including 502 and 504 responses. Retry with backoff. x402 payments and MPP transaction credentials are not settled for failed requests; MPP hash credits are redeemed at admission and are not refunded automatically.

## Changes

- **2026-10-27** `60e4a5fdbecc`: 4 breaking
  - request property `additionalProperties/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - request property `entities/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - request property `limit/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`
  - request property `pricingID/anyOf[subschema #4]/items/` list-of-types was narrowed by removing types `boolean and number` from media type `application/json`

[Operation history](https://skmtc.dev/arkm/apis/arkham-x402/changes/balances/solana/subaccounts/entity/post.md)

---

[API](https://skmtc.dev/arkm/apis/arkham-x402.md) - [All operations](https://skmtc.dev/arkm/apis/arkham-x402/llms.txt) - [OpenAPI document](https://skmtc.dev/arkm/apis/arkham-x402/revisions/60e4a5fdbecc?raw)