> ## 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 SOL Balance

> Get the current real-time SOL balance directly from Solana RPC

<Info>
  This endpoint returns live data from the Solana blockchain. For historical balances, use the standard historical endpoint.
</Info>


## OpenAPI

````yaml GET /api/v1/customer/solana/balances/account/{account_address}/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/balances/account/{account_address}/current:
    get:
      tags:
        - Current Balances
      summary: Current SOL Balance
      description: >-
        Get the current SOL balance for a Solana account in real-time directly
        from Solana RPC.
      operationId: getCurrentSolBalance
      parameters:
        - name: account_address
          in: path
          description: The Solana account address (base58 encoded, 32-44 characters)
          required: true
          schema:
            type: string
            example: AUqnU3dfXdcnSuaZCnaEC7FfWjR1x8VGdphaA12wqJ6i
      responses:
        '200':
          description: Current SOL balance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SolBalanceResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    SolBalanceResponse:
      type: object
      description: SOL balance for the account
      properties:
        as_of_datetime:
          type: string
          description: The datetime of the balance snapshot
        account:
          type: string
          description: The Solana account address
        balance:
          type: number
          description: The SOL balance in human-readable format (converted from lamports)
        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: GWmnqn5hHeDos73XhP6rZ4ejQPnqSSocxyZwzxjyeJCi
        balance: 2322.966374739
        balance_source: 2322966374739
        datetime_last_updated: '2024-06-01 00:31:18.000'
        block_slot_last_updated: 269136004
    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

````