> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# getBalance

> Devuelve el saldo en lamports de la cuenta de la Pubkey proporcionada.

## Parámetros de la solicitud

<ParamField body="address" type="string" required>
  La Pubkey de la cuenta que se consultará (cadena codificada en base 58).
</ParamField>

<ParamField body="commitment" type="string">
  El nivel de confirmación de la solicitud.

  * `processed`
  * `confirmed`
  * `finalized`
</ParamField>

<ParamField body="minContextSlot" type="number">
  El slot mínimo en el que se puede evaluar la solicitud.
</ParamField>


## OpenAPI

````yaml es/openapi/rpc-http/getBalance.yaml POST /
openapi: 3.1.0
info:
  title: API RPC de Solana
  version: 1.0.0
  description: >-
    API rápida y confiable para consultar el saldo de billeteras de Solana y
    obtener saldos de cuentas en SOL con niveles de confirmación configurables
    para distintas garantías de finalidad.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint RPC de Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC de Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getBalance
      description: >
        Consulta saldos nativos en SOL de cualquier dirección de billetera de
        Solana con niveles de finalidad configurables.

        Esta API esencial proporciona acceso rápido a los saldos de las cuentas
        en lamports (1 SOL = 1,000,000,000 lamports)

        y admite distintos niveles de confirmación para equilibrar la velocidad
        y las garantías de finalidad.

        Es fundamental para billeteras, aplicaciones financieras, plataformas de
        trading y cualquier servicio que necesite

        rastrear los saldos de cuentas de Solana en tiempo real.
      operationId: getBalance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  description: La versión del protocolo JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  description: Un identificador único para la solicitud.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  enum:
                    - getBalance
                  description: El nombre del método RPC que se invocará.
                  default: getBalance
                params:
                  type: array
                  description: Parámetros de la solicitud.
                  default:
                    - 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          La Pubkey de la cuenta que se consultará (cadena
                          codificada en base 58).
                        example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
                      - type: object
                        description: >-
                          Opciones de configuración adicionales para la
                          solicitud.
                        properties:
                          commitment:
                            type: string
                            description: El nivel de confirmación de la solicitud.
                            enum:
                              - processed
                              - confirmed
                              - finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              El slot mínimo en el que se puede evaluar la
                              solicitud.
                            example: 1
      responses:
        '200':
          description: El saldo de la cuenta se recuperó correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                  result:
                    type: object
                    properties:
                      context:
                        type: object
                        properties:
                          slot:
                            type: integer
                            description: El slot de la información devuelta.
                            example: 1
                      value:
                        type: integer
                        description: El saldo de la cuenta en lamports.
                        example: 0
        '400':
          description: >-
            Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
            con formato incorrecto.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Parámetros no válidos
                id: '1'
        '401':
          description: 'No autorizado: la clave de API no es válida o no se proporcionó.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: No autorizado
                id: '1'
        '429':
          description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Demasiadas solicitudes
                id: '1'
        '500':
          description: 'Error interno del servidor: se produjo un error en el servidor.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Error interno
                id: '1'
        '503':
          description: >-
            Servicio no disponible: el servicio no está disponible
            temporalmente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Servicio no disponible
                id: '1'
        '504':
          description: >-
            Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
            de espera de la solicitud.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Tiempo de espera de la puerta de enlace agotado
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          enum:
            - '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
        id:
          type: string
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Tu clave de API de Helius. Puedes obtener una gratis en el
        [panel](https://dashboard.helius.dev/api-keys).

````