Inicio rápido para obtener datos

Configuración rápida

Cada ejemplo a continuación solo necesita tu clave de API de Helius de dashboard.helius.dev. Reemplaza YOUR_API_KEY y luego elige la opción que corresponda a los datos que quieres obtener:

Lo que quieres	Usa esto	Devuelve
El historial completo de transacciones de una dirección	getTransactionsForAddress	Transacciones decodificadas de una dirección
El historial completo de transferencias de una dirección	getTransfersByAddress	Transferencias de tokens y SOL nativo de una dirección
Tokens, NFT y activos pertenecientes a una billetera	DAS API — `getAssetsByOwner`	Activos con metadatos, propiedad y saldos
Saldos de una billetera con valores en USD mediante REST	Wallet API — `/balances`	Saldos de tokens y NFT con precios en USD

Opción 1: Recuperar el historial de transacciones (getTransactionsForAddress)

getTransactionsForAddress devuelve el historial completo y decodificado de transacciones de una dirección con un solo método: la forma más rápida de recuperar datos históricos para su indexación. Pasa primero la dirección y luego un objeto de opciones con filtros opcionales.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransactionsForAddress',
    params: [
      '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      {
        transactionDetails: 'full',
        sortOrder: 'desc',
        limit: 100,
      },
    ],
  }),
});

const { result } = await response.json();
console.log(`Fetched ${result.data.length} transactions`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactionsForAddress",
    "params": [
        "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        {"transactionDetails": "full", "sortOrder": "desc", "limit": 100},
    ],
}
result = requests.post(url, json=payload).json()["result"]
print(f"Fetched {len(result['data'])} transactions")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransactionsForAddress",
    "params": [
      "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      { "transactionDetails": "full", "sortOrder": "desc", "limit": 100 }
    ]
  }'

getTransactionsForAddress guide

Filtros, paginación, formato de respuesta y prácticas recomendadas.

Indexing guide

Crea y completa un índice de Solana, y mantenlo actualizado.

Opción 2: Obtener el historial de transferencias (getTransfersByAddress)

getTransfersByAddress devuelve el historial analizado de transferencias de tokens y SOL nativo de una dirección, a nivel de transferencia en lugar de transacción y listo para la conciliación. Pasa la dirección y agrega un objeto de opciones para aplicar filtros.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getTransfersByAddress',
    params: ['86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY'],
  }),
});

const { result } = await response.json();
console.log(`Fetched ${result.data.length} transfers`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransfersByAddress",
    "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"],
}
result = requests.post(url, json=payload).json()["result"]
print(f"Fetched {len(result['data'])} transfers")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTransfersByAddress",
    "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"]
  }'

getTransfersByAddress guide

Tipos de transferencias, filtros, conciliación y formato de respuesta.

getTransfersByAddress reference

Parámetros completos y esquema de respuesta.

Opción 3: Obtener los activos de una billetera (DAS API)

La DAS API devuelve los NFT, los tokens fungibles y los activos comprimidos que posee una billetera en una sola llamada. Es el punto de partida más común para billeteras, vistas de portafolios y análisis.

const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAssetsByOwner',
    params: {
      ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      page: 1,
      limit: 1000,
      options: {
        showFungible: true,
        showNativeBalance: true,
      },
    },
  }),
});

const { result } = await response.json();
console.log(`Found ${result.total} assets`);

import requests

url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getAssetsByOwner",
    "params": {
        "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        "page": 1,
        "limit": 1000,
        "options": {
            "showFungible": True,
            "showNativeBalance": True,
        },
    },
}
result = requests.post(url, json=payload).json()["result"]
print(f"Found {result['total']} assets")

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getAssetsByOwner",
    "params": {
      "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
      "page": 1,
      "limit": 1000,
      "options": {
        "showFungible": true,
        "showNativeBalance": true
      }
    }
  }'

DAS API overview

Todos los métodos de activos, tipos especiales de activos y prácticas recomendadas.

getAssetsByOwner reference

Parámetros completos y esquema de respuesta.

Opción 4: Obtener saldos de billeteras mediante REST (Wallet API)

La Wallet API es una API REST de alto nivel. El endpoint de saldos devuelve las tenencias de tokens y NFT de una billetera con sus valores en USD, sin necesidad de un envoltorio JSON-RPC.

const address = '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY';
const response = await fetch(
  `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`,
);

const data = await response.json();
console.log(`Current page value: $${data.totalUsdValue}`);

import requests

address = "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
url = f"https://api.helius.xyz/v1/wallet/{address}/balances"
data = requests.get(url, headers={"X-Api-Key": "YOUR_API_KEY"}).json()
print(f"Current page value: ${data['totalUsdValue']}")

curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"

Wallet API overview

Todos los endpoints de billeteras, autenticación y unidades.

Wallet Balances reference

Parámetros de consulta y esquema de respuesta completo.

Siguientes pasos

Getting Data overview

Compara todas las API de datos y elige la adecuada para tu caso de uso.

API Reference

Documentación completa de métodos y endpoints.

¿Necesitas ayuda? Únete a nuestro Discord o consulta la documentación de soporte.

Primeros pasos

Streaming de datos y escucha de eventos

API de datos y RPC

Trading

Envío de transacciones

Billetera como servicio

Privacidad

Recursos

Inicio rápido para obtener datos

Configuración rápida

Opción 1: Recuperar el historial de transacciones (getTransactionsForAddress)

getTransactionsForAddress guide

Indexing guide

Opción 2: Obtener el historial de transferencias (getTransfersByAddress)

getTransfersByAddress guide

getTransfersByAddress reference

Opción 3: Obtener los activos de una billetera (DAS API)

DAS API overview

getAssetsByOwner reference

Opción 4: Obtener saldos de billeteras mediante REST (Wallet API)

Wallet API overview

Wallet Balances reference

Siguientes pasos

Getting Data overview

API Reference

​Configuración rápida

​Opción 1: Recuperar el historial de transacciones (getTransactionsForAddress)

getTransactionsForAddress guide

Indexing guide

​Opción 2: Obtener el historial de transferencias (getTransfersByAddress)

getTransfersByAddress guide

getTransfersByAddress reference

​Opción 3: Obtener los activos de una billetera (DAS API)

DAS API overview

getAssetsByOwner reference

​Opción 4: Obtener saldos de billeteras mediante REST (Wallet API)

Wallet API overview

Wallet Balances reference

​Siguientes pasos

Getting Data overview

API Reference

Configuración rápida

Opción 1: Recuperar el historial de transacciones (getTransactionsForAddress)

Opción 2: Obtener el historial de transferencias (getTransfersByAddress)

Opción 3: Obtener los activos de una billetera (DAS API)

Opción 4: Obtener saldos de billeteras mediante REST (Wallet API)

Siguientes pasos