> ## Documentation Index > Fetch the complete documentation index at: https://docs.sonarx.com/llms.txt > Use this file to discover all available pages before exploring further. # Current Token Balances by Owner > Get current real-time SPL token balances for a wallet owner from Solana RPC This endpoint returns live data from the Solana blockchain. For historical balances, use the standard historical endpoint. ## OpenAPI ````yaml GET /api/v1/customer/solana/token-balances/account-owner/{account_owner}/current openapi: 3.1.0 info: title: SonarX Solana API - Balances description: >- Query SOL and SPL token balances for Solana accounts. Supports both historical point-in-time queries and current real-time balances. version: 1.0.0 servers: - url: https://api-gateway.sonarx.com description: Production API security: - apiKey: [] tags: - name: Historical Balances description: Query historical balances at specific timestamps - name: 1-Second Balances description: Query SOL balances at 1-second resolution (2026+ data) - name: Current Balances description: Query current real-time balances from Solana RPC paths: /api/v1/customer/solana/token-balances/account-owner/{account_owner}/current: get: tags: - Current Balances summary: Current Token Balances by Owner description: >- Get all current SPL token balances for a wallet owner in real-time directly from Solana RPC. operationId: getCurrentTokenBalancesByOwner parameters: - name: account_owner in: path description: The Solana wallet owner address (base58 encoded, 32-44 characters) required: true schema: type: string example: 4G1mhdPXaUUf2yvCHnZSejDCpPxS7ymPzjYHNfzJqdE9 - name: offset in: query description: Number of results to skip for pagination (0-indexed) required: false schema: type: integer minimum: 0 default: 0 - name: limit in: query description: 'Number of results per page (minimum: 1, maximum: 1000)' required: false schema: type: integer minimum: 1 maximum: 1000 default: 10 responses: '200': description: Current token balances for the wallet owner content: application/json: schema: $ref: '#/components/schemas/CurrentTokenBalancesByOwnerResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' components: schemas: CurrentTokenBalancesByOwnerResponse: type: object properties: offset: type: integer description: Number of results skipped limit: type: integer description: Results per page result: type: array items: $ref: '#/components/schemas/TokenBalance' count: type: integer description: Total number of token accounts found example: offset: 0 limit: 5 result: - as_of_datetime: '2025-12-11 20:24:50.914' account_owner: 4G1mhdPXaUUf2yvCHnZSejDCpPxS7ymPzjYHNfzJqdE9 token_address: EWM4k1APF9T3w4jmYM9PcCGbLgQHPKoECeg9azrnwm6A token_account: D3jScakVydRU6GvvHa87giakZjdAv7XscjvAV31tyUVW balance: 85000103 balance_source: 85000103 datetime_last_updated: '2025-12-11 20:24:50.914' block_slot_last_updated: 386046164 - as_of_datetime: '2025-12-11 20:24:50.914' account_owner: 4G1mhdPXaUUf2yvCHnZSejDCpPxS7ymPzjYHNfzJqdE9 token_address: orcaEKTdK7LKz57vaAYr9QeNsVEPfiu6QeMU1kektZE token_account: 12QCfo5SdFuyC9P5oioken91gCYK5vnRbXaDVuV5KLpZ balance: 12.956933 balance_source: 12956933 datetime_last_updated: '2025-12-11 20:24:50.914' block_slot_last_updated: 386046164 count: 7 TokenBalance: type: object properties: as_of_datetime: type: string description: The datetime of the balance snapshot account_owner: type: string description: The wallet owner address token_address: type: string description: The SPL token mint address token_account: type: string description: The associated token account address token_name: type: string nullable: true description: Token name (only if include_metadata=true) token_symbol: type: string nullable: true description: Token symbol (only if include_metadata=true) balance: type: number description: >- The token balance in human-readable format (converted using token decimals) balance_source: type: integer description: >- Raw balance in smallest units (lamports for SOL, raw token units for SPL tokens) before decimal conversion datetime_last_updated: type: string description: When this balance was last updated block_slot_last_updated: type: integer description: The block slot when this balance was last updated example: as_of_datetime: '2024-06-01 12:00:00.000' account_owner: 4G1mhdPXaUUf2yvCHnZSejDCpPxS7ymPzjYHNfzJqdE9 token_address: 6kFRCohSxmsXyMYV2uax57BQo224rPaBAf2CpqgduWRn token_account: 35hadxsTpn1xxovQReWeD5jskRdYWBjBEo1tD4pqgTh3 balance: 86000119 balance_source: 86000119 datetime_last_updated: '2024-04-08 07:59:49.000' block_slot_last_updated: 258979466 ErrorResponse: type: object properties: detail: type: string required: - detail responses: BadRequest: description: Bad Request - Invalid parameters provided content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: datetime_too_recent: summary: Datetime filter too recent value: detail: >- datetime_filter cannot exceed 2024-06-01T11:00. Data is only available up to this time. invalid_datetime_format: summary: Invalid datetime format value: detail: >- datetime_filter must include timezone (e.g., 2024-01-15T10:30:00Z or 2024-01-15T10:30:00+00:00) invalid_seconds: summary: Invalid seconds value value: detail: >- datetime_filter seconds must be 00. Received UTC time: 2024-06-01T12:00:30 invalid_token_account: summary: Invalid token account value: detail: >- ABC123 is not a valid token account: account does not exist on Solana or has no data Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_key: summary: Missing API key value: detail: API key is required invalid_key: summary: Invalid API key value: detail: Invalid API key NotFound: description: Not Found - Resource does not exist content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: account_not_found: summary: Account not found value: detail: No balance data found for the specified account InternalError: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: server_error: summary: Server error value: detail: An unexpected error occurred securitySchemes: apiKey: type: apiKey in: header name: apikey description: API key for authentication ````