> ## 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
> Retourne le solde en lamports du compte du Pubkey fourni.
## Paramètres de la requête
Le Pubkey du compte à interroger (chaîne encodée en base-58).
Le niveau d'engagement pour la requête.
* `processed`
* `confirmed`
* `finalized`
Le slot minimum auquel la requête peut être évaluée.
## OpenAPI
````yaml fr/openapi/rpc-http/getBalance.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API rapide et fiable pour la récupération du solde des portefeuilles Solana,
permettant d'obtenir les soldes SOL des comptes avec des niveaux
d'engagement configurables pour différentes garanties de finalité.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Point de terminaison RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Point de terminaison RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getBalance
description: >
Récupérer les soldes SOL natifs pour toute adresse de portefeuille
Solana avec des niveaux de finalité configurables.
Cette API essentielle offre un accès rapide aux soldes des comptes en
lamports (1 SOL = 1 000 000 000 lamports),
supportant différents niveaux d'engagement pour équilibrer entre vitesse
et garanties de finalité.
Essentiel pour les portefeuilles, les applications financières, les
plateformes de trading et tout service ayant besoin
de suivre les soldes des comptes Solana en temps réel.
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 version du protocole JSON-RPC.
default: '2.0'
id:
type: string
description: Un identifiant unique pour la requête.
example: '1'
default: '1'
method:
type: string
enum:
- getBalance
description: Le nom de la méthode RPC à invoquer.
default: getBalance
params:
type: array
description: Paramètres pour la requête.
default:
- 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
items:
oneOf:
- type: string
description: >-
La clé publique du compte à interroger (chaîne encodée
en base-58).
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- type: object
description: >-
Options de configuration supplémentaires pour la
requête.
properties:
commitment:
type: string
description: Le niveau d'engagement pour la requête.
enum:
- processed
- confirmed
- finalized
example: finalized
minContextSlot:
type: integer
description: >-
La tranche minimale à laquelle la requête peut
être évaluée.
example: 1
responses:
'200':
description: Solde du compte récupéré avec succès.
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: La tranche des informations retournées.
example: 1
value:
type: integer
description: Le solde du compte en lamports.
example: 0
'400':
description: >-
Requête incorrecte - Paramètres de requête invalides ou requête mal
formée.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Paramètres invalides
id: '1'
'401':
description: Non autorisé - Clé API invalide ou manquante.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Non autorisé
id: '1'
'429':
description: Trop de requêtes - Limite de débit dépassée.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Trop de requêtes
id: '1'
'500':
description: Erreur serveur interne - Une erreur est survenue sur le serveur.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Erreur interne
id: '1'
'503':
description: Service indisponible - Le service est temporairement indisponible.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service indisponible
id: '1'
'504':
description: Délai d'attente dépassé - La requête a expiré.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Délai d'attente du portail dépassé
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: >-
Votre clé API Helius. Vous pouvez en obtenir une gratuitement sur le
[tableau de bord](https://dashboard.helius.dev/api-keys).
````