Datos de billeteras Solana sin complicaciones
Una API REST para obtener saldos, historial, identidad y fuentes de fondos de billeteras Solana. Sin memorizar métodos JSON-RPC de Solana ni hacer cálculos con lamports.
Descubre a quién pertenece una billetera
Vincula una dirección o un nombre de dominio de Solana con una identidad. Admite más de 32,500 etiquetas de identidad y 21.5 millones de etiquetas descriptivas.
- Consulta una dirección o procesa lotes de hasta 100 direcciones
- Resuelve TLD personalizados de SNS y ANS en mainnet
- Admite etiquetas para direcciones de exchanges, billeteras de protocolos, instituciones y direcciones marcadas
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
- Consulta una dirección o procesa lotes de hasta 100 direcciones
- Resuelve TLD personalizados de SNS y ANS en mainnet
- Admite etiquetas para direcciones de exchanges, billeteras de protocolos, instituciones y direcciones marcadas
{
"address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
"type": "exchange",
"name": "Binance 1",
"category": "Centralized Exchange",
"tags": ["Centralized Exchange"]
}
Rastrea quién financió una billetera
Obtén la fuente de fondos original de una billetera: quién envió el primer SOL, cuánto envió y cuándo. El nombre y el tipo del financiador provienen del mismo sistema de identidad.
- Dirección del financiador inmediato, monto, slot y firma
- Exchange, protocolo o desconocido, con etiqueta si lo conocemos
- Guarda los datos en caché para siempre. El primer financiador de una billetera nunca cambia
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
- Dirección del financiador inmediato, monto, slot y firma
- Exchange, protocolo o desconocido, con etiqueta si lo conocemos
- Guarda los datos en caché para siempre. El primer financiador de una billetera nunca cambia
{
"funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba",
"funderName": null,
"funderType": null,
"mint": "So11111111111111111111111111111111111111111",
"symbol": "SOL",
"amount": 0.09811972,
"amountRaw": "98119720",
"decimals": 9,
"date": "2022-01-19T20:46:34.000Z",
"signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG",
"timestamp": 1642625194,
"slot": 116984883,
"explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary"
}
Actividad de la billetera completamente analizada
Historial de transacciones con cambios de saldo por transacción en lenguaje legible.
- Primero las más recientes, hasta 100 transacciones por página
tokenAccounts=balanceChangedpara obtener solo actualizacionesamountya está ajustado a decimales; no necesitas hacer cálculos con lamports
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
- Primero las más recientes, hasta 100 transacciones por página
tokenAccounts=balanceChangedpara obtener solo actualizacionesamountya está ajustado a decimales; no necesitas hacer cálculos con lamports
{
"data": [
{
"signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
"timestamp": 1704067200,
"slot": 250000000,
"fee": 0.000005,
"feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
"error": null,
"balanceChanges": [
{
"mint": "So11111111111111111111111111111111111111111",
"amount": -0.05,
"decimals": 9
}
]
}
],
"pagination": {
"hasMore": true,
"nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
}
}
Lanza la billetera y la capa de datos juntas
Agrega billeteras integradas sin custodia a tu aplicación con opciones de inicio de sesión mediante passkeys, correo electrónico y billeteras existentes a través de helius-wallet-kit
Casos de uso de Wallet API
Paneles de billeteras
Saldos, valores en USD y metadatos en una sola llamada REST. Sin combinar datos de DAS ni hacer cálculos con lamports
Rastreadores de portafolios
Usa el historial y balance-at para reconstruir tenencias y calcular pérdidas y ganancias a lo largo del tiempo
Procesadores de pagos
Registra transacciones y transferencias con contraparte, monto, mint y dirección
Impuestos y contabilidad
Obtén un historial legible con tenencias y cambios de saldo por transacción
Cumplimiento y prevención del lavado de dinero
Consulta exchanges y billeteras de tesorería conocidos, y descubre cómo se financiaron las billeteras
Exploradores y analítica
Obtén etiquetas para más de 21 millones de billeteras y agrégalas a las cuentas de tu aplicación
Una API REST para todos los datos de billeteras Solana
1. Obtén una clave de API
Regístrate, obtén tu clave de API de Helius y pasa api-key en la cadena de consulta o como encabezado X-Api-Key
2. Llama a una ruta REST
GET /v1/wallet/{wallet}/balances, identity, history o cualquier otro endpoint de Wallet API
3. Intégrala en tu aplicación
Los montos están ajustados a decimales, las identidades están etiquetadas y los datos tienen el formato correcto. No necesitas pasos adicionales
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");1. Obtén una clave de API
Regístrate, obtén tu clave de API de Helius y pasa api-key en la cadena de consulta o como encabezado X-Api-Key
2. Llama a una ruta REST
GET /v1/wallet/{wallet}/balances, identity, history o cualquier otro endpoint de Wallet API
3. Intégrala en tu aplicación
Los montos están ajustados a decimales, las identidades están etiquetadas y los datos tienen el formato correcto. No necesitas pasos adicionales
const getWalletBalances = async (address) => {
const url = `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`;
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
const solBalance = data.balances[0]; // SOL is always first when showNative=true
console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
console.log(`Token Count (this page): ${data.balances.length}`);
// Display top holdings
data.balances.slice(0, 5).forEach(token => {
console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
});
return data;
};
getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");Preguntas frecuentes
Encuentra respuestas a preguntas frecuentes. ¿Necesitas ayuda o un plan personalizado? Contacta a nuestro equipo.
Los saldos, el saldo histórico (balance-at), el historial y las transferencias están disponibles en todos los planes, incluido Free. Identity (individual y por lotes) y funded-by requieren cualquier plan de pago (Developer o superior) y devuelven 403 en Free.
Cada solicitud de Wallet API cuesta 100 créditos, incluida la consulta de identidad por lotes (hasta 100 direcciones en una llamada). Consulta la tabla completa de créditos.
Usa balances para el portafolio actual, balance-at para consultar una tenencia en un slot o marca de tiempo anterior, history para obtener un feed completo de actividad con cambios de saldo por transacción y transfers cuando solo necesites los pagos enviados o recibidos con una contraparte. Usa identity para etiquetar un exchange, protocolo o institución conocidos, y funded-by para encontrar la billetera que envió el primer SOL.
Wallet API es la ruta de lectura: obtén mediante REST los saldos, el historial, la identidad y la información de la billetera financiadora. WaaS ofrece billeteras integradas: crea y firma transacciones mediante helius-wallet-kit.
WaaS está en beta y disponible en todos los planes de pago (Developer, Business, Professional y Enterprise). No está disponible en Free.
No hay una suscripción independiente ni una tarifa por usuario. Cada firma cuesta 200 créditos ($0.001 con la tarifa de crédito estándar). Crear billeteras es gratis. signMessage, signTransaction y signAndSendTransaction cuentan cada uno como una firma. La firma se cobra incluso si la transacción falla posteriormente onchain. Una solicitud cancelada es gratuita. Consulta el uso en el panel, en WaaS → Analytics. Revisa los créditos de WaaS.
Cambia a un plan de pago, crea una clave de API e instala helius-wallet-kit. Envuelve tu aplicación en HeliusWalletProvider y sigue la guía de inicio rápido de WaaS.
Para comenzar, explora estos recursos:
Datos de billeteras sin complicaciones
Evita los métodos JSON-RPC básicos de Solana y comienza a consultar datos onchain de billeteras en minutos