Skip to main content
Esta guía consulta el saldo SOL de una cuenta por HTTP. Necesitas un script de servidor y una clave RPC del panel.

Llama a getBalance

Configura la clave y ejecuta:
Sustituye la dirección por la clave pública de una wallet o cuenta. La respuesta contiene result.context.slot y result.value. El saldo está en lamports: 1 SOL equivale a 1.000.000.000 lamports. Este método no devuelve posiciones en tokens SPL.

Usa Node.js

Usa Node.js 20 o posterior. Guarda el código como balance.mjs y ejecútalo con la misma variable de entorno. La función comprueba los errores HTTP y JSON-RPC; estos últimos también pueden aparecer con HTTP 200.
balance.mjs
Guarda las claves en variables de entorno del servidor. Evita incluir la URL con la clave en el código del navegador o en los registros.

Elige el nivel de confirmación

  • processed: el estado más reciente procesado por el nodo; puede revertirse.
  • confirmed: estado votado por una supermayoría del stake. Este ejemplo lo usa para lecturas actuales.
  • finalized: el nivel de confirmación más fuerte, más alejado del último estado de la cadena.
Usa el mismo nivel al comparar lecturas relacionadas. Las llamadas independientes pueden devolver distintos slots de contexto. Usa getMultipleAccounts para consultar varias cuentas en una respuesta.

Gestiona los errores

Ante HTTP 429, reduce la concurrencia y reintenta las lecturas con espera incremental, variación aleatoria y un límite de intentos. Los errores de parámetros o autenticación requieren corregir la petición o configuración. Si el envío de una transacción agota el tiempo de espera, comprueba su firma antes de decidir cómo reintentar: reconstruirla y firmarla crea otra transacción.

Siguientes pasos