Skip to main content
La API de billeteras está en Beta. Los endpoints y los formatos de respuesta pueden cambiar.

​
¿Qué es la API de billeteras?

La API de billeteras proporciona endpoints REST de alto nivel para consultar todos los datos de una billetera de Solana: saldos, historial de transacciones, transferencias de tokens, resolución de identidad, saldos históricos y fuentes de fondos. En lugar de realizar varias llamadas RPC y analizar datos sin procesar de la blockchain, obtienes información estructurada y legible con precios en USD en una sola solicitud. Está diseñada para billeteras, rastreadores de portafolios, exploradores, procesadores de pagos, herramientas fiscales y sistemas de cumplimiento y AML. Todos los endpoints comparten la URL base https://api.helius.xyz y devuelven los importes en unidades legibles (no es necesario convertir lamports).

​
¿Por qué usar Helius para los datos de billeteras?

One REST call

Saldos, historial y transferencias estructurados sin tener que combinar respuestas RPC sin procesar.

USD pricing built in

Los saldos de tokens incluyen valores en USD y totales del portafolio, obtenidos de DAS.

Identity resolution

Más de 32,500 cuentas y programas etiquetados, además de más de 21.5 millones de etiquetas categóricas para exchanges, protocolos e instituciones.

Human-readable output

Datos claros con decimales ajustados, en lugar de lamports e instrucciones sin procesar.

​
Endpoints principales

Wallet Identity

Identifica billeteras conocidas por dirección o dominio SNS/ANS: exchanges, protocolos e instituciones.

Wallet Balances

Todos los saldos de tokens y NFT con valores en USD, logotipos y metadatos.

Historical Balance

El saldo de un token o de SOL en una marca de tiempo, fecha y hora o slot del pasado.

Wallet History

Historial completo de transacciones con los cambios de saldo de cada transacción.

Token Transfers

Todas las transferencias entrantes y salientes con información del remitente y del destinatario.

Funding Source

La fuente de fondos original de una billetera, rastreada hasta su primera recepción de SOL.

​
¿Qué endpoint debo usar?

Referencia rápida de las rutas subyacentes (URL base https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — obtén la identidad de una billetera por dirección o dominio SNS/ANS
  • POST /v1/wallet/batch-identity — consulta identidades por lotes (hasta 100 direcciones o dominios)
  • GET /v1/wallet/{wallet}/balances — obtén todos los saldos de tokens y NFT
  • GET /v1/wallet/{wallet}/balance-at — obtén el saldo de un token o de SOL en una marca de tiempo, fecha y hora o slot del pasado
  • GET /v1/wallet/{wallet}/history — obtén el historial de transacciones con cambios de saldo
  • GET /v1/wallet/{wallet}/transfers — obtén toda la actividad de transferencias de tokens
  • GET /v1/wallet/{wallet}/funded-by — encuentra la fuente de fondos original

​
Autenticación

Todas las solicitudes a la API de billeteras requieren una clave de API. Puedes pasarla como parámetro de consulta o como encabezado:

​
Requisitos del plan

Los endpoints de identidad y fuente de fondos requieren un plan de pago. En el plan gratuito, las solicitudes a estos endpoints devuelven 403 Forbidden. Todos los demás endpoints están disponibles en todos los planes, incluido el gratuito. Cualquier nivel de pago desbloquea los endpoints restringidos: Developer, Business y todos los niveles superiores (como Enterprise). Para habilitar las consultas de identidad y fuente de fondos, mejora tu plan en el panel.

​
Importes y unidades

La API de billeteras es una abstracción de alto nivel de los datos sin procesar de Solana. Todos los campos amount de las respuestas son legibles — ya están divididos por el valor decimals del token — para que puedas mostrarlos directamente sin realizar conversiones. Las llamadas RPC de Solana sin procesar devuelven valores en lamports (la unidad más pequeña, 10⁻⁹ SOL); la API de billeteras no. "amount": 1.5 significa 1.5 SOL, no 1.5 lamports. Cuando se requiere aritmética exacta, algunos endpoints también exponen amountRaw: el mismo valor como entero sin procesar serializado como cadena para evitar la pérdida de precisión de punto flotante. La fórmula de conversión es: amount = parseInt(amountRaw) / 10**decimals Usa amount para mostrar valores. Usa amountRaw cuando pases valores a instrucciones en cadena o a otros sistemas que requieran aritmética exacta con enteros.

​
Comienza

1

Get your API key

Regístrate en dashboard.helius.dev para obtener tu clave de API.
2

Choose your endpoint

Usa la tabla anterior para elegir el endpoint que corresponda a tu caso de uso.
3

Make your first request

Comienza con una consulta de saldo sencilla:
4

Handle the response

Analiza la respuesta JSON y muestra los datos en tu aplicación.

​
Próximos pasos

Getting Data

Explora todas las formas de consultar datos de Solana en Helius.

API Reference

Esquemas de solicitudes y respuestas para todos los endpoints de la API de billeteras.

Contact Support

Obtén ayuda mediante Discord, chat o correo electrónico.