> ## 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.

# SOL Balance (1-Second)

> Get SOL balance at 1-second resolution for a Solana account (2026+ data)



## OpenAPI

````yaml GET /api/v1/customer/solana/1s/balances/account/{account_address}
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/1s/balances/account/{account_address}:
    get:
      tags:
        - 1-Second Balances
      summary: SOL Balance (1-Second)
      description: >-
        Get the SOL balance for a Solana account at 1-second resolution. Returns
        the most recent balance recorded **before** the specified
        `datetime_filter`. Data is available from 2026-01-01 onwards.
      operationId: getSolBalance1s
      parameters:
        - name: account_address
          in: path
          description: The Solana account address (base58 encoded, 32-44 characters)
          required: true
          schema:
            type: string
            example: 116HTnNMXBLL6LCQ1qAQEZ7E9bDXSJjV6hnZsziospk
        - name: datetime_filter
          in: query
          description: >-
            Point-in-time datetime with timezone. Returns the most recent
            balance before this time. Any second-level value is valid (no
            10-minute interval restriction). Must be ≥ 2026-01-01T00:00:00Z and
            ≤ UTC now − 5 minutes. Format: YYYY-MM-DDTHH:MM:SSZ or
            YYYY-MM-DDTHH:MM:SS+00:00.
          required: true
          schema:
            type: string
            example: '2026-02-15T01:23:45Z'
      responses:
        '200':
          description: SOL balance at the specified point-in-time
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SolBalanceResponse'
              example:
                as_of_datetime: '2026-02-15 01:23:45.000'
                account: 116HTnNMXBLL6LCQ1qAQEZ7E9bDXSJjV6hnZsziospk
                balance: 123.456789012
                balance_source: 123456789012
                datetime_last_updated: '2026-02-15 01:23:44'
                block_slot_last_updated: 318472910
        '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

````