Быстрый старт: получение данных

Быстрая настройка

Для каждого примера ниже нужен только ваш ключ Helius API из dashboard.helius.dev. Замените YOUR_API_KEY, а затем выберите подходящий вариант в зависимости от того, какие данные вы получаете:

Что вам нужно	Что использовать	Что возвращается
Полная история транзакций адреса	getTransactionsForAddress	Декодированные транзакции для одного адреса
Полная история переводов адреса	getTransfersByAddress	Переводы токенов и нативного SOL для одного адреса
Токены, NFT и активы, принадлежащие кошельку	DAS API — `getAssetsByOwner`	Активы с метаданными, сведениями о владении и балансами
Балансы кошелька со стоимостью в USD через REST	Wallet API — `/balances`	Балансы токенов и NFT со стоимостью в USD

Вариант 1: загрузка истории транзакций (getTransactionsForAddress)

getTransactionsForAddress возвращает полную декодированную историю транзакций для адреса одним методом. Это самый быстрый способ загрузить исторические данные для индексации. Сначала передайте адрес, а затем объект параметров с необязательными фильтрами.

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

Фильтры, пагинация, формат ответа и рекомендации.

Indexing guide

Создайте индекс Solana, загрузите исторические данные и поддерживайте его в актуальном состоянии.

Вариант 2: получение истории переводов (getTransfersByAddress)

getTransfersByAddress возвращает обработанную историю переводов токенов и нативного SOL для адреса. Данные предоставляются на уровне переводов, а не транзакций, и готовы к сверке. Передайте адрес и при необходимости добавьте объект параметров с фильтрами.

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

Типы переводов, фильтры, сверка и формат ответа.

getTransfersByAddress reference

Полный список параметров и схема ответа.

Вариант 3: получение активов кошелька (DAS API)

DAS API возвращает принадлежащие кошельку NFT, взаимозаменяемые токены и сжатые активы одним вызовом. Это наиболее распространенная отправная точка для кошельков, представлений портфеля и аналитики.

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

Все методы для работы с активами, специальные типы активов и рекомендации.

getAssetsByOwner reference

Полный список параметров и схема ответа.

Вариант 4: получение балансов кошелька через REST (Wallet API)

Wallet API — это высокоуровневый REST API. Эндпоинт балансов возвращает принадлежащие кошельку токены и NFT со стоимостью в USD. Оболочка 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

Все эндпоинты кошелька, аутентификация и единицы измерения.

Wallet Balances reference

Параметры запроса и полная схема ответа.

Дальнейшие действия

Getting Data overview

Сравните все API для работы с данными и выберите подходящий для вашего сценария.

API Reference

Полная документация по методам и эндпоинтам.

Нужна помощь? Присоединяйтесь к нашему сообществу в Discord или ознакомьтесь с документацией службы поддержки.

Начало работы

Потоковая передача данных и отслеживание событий

API данных и RPC

Торговля

Отправка транзакций

Кошелек как услуга

Конфиденциальность

Ресурсы

Быстрый старт: получение данных

Быстрая настройка

Вариант 1: загрузка истории транзакций (getTransactionsForAddress)

getTransactionsForAddress guide

Indexing guide

Вариант 2: получение истории переводов (getTransfersByAddress)

getTransfersByAddress guide

getTransfersByAddress reference

Вариант 3: получение активов кошелька (DAS API)

DAS API overview

getAssetsByOwner reference

Вариант 4: получение балансов кошелька через REST (Wallet API)

Wallet API overview

Wallet Balances reference

Дальнейшие действия

Getting Data overview

API Reference

​Быстрая настройка

​Вариант 1: загрузка истории транзакций (getTransactionsForAddress)

getTransactionsForAddress guide

Indexing guide

​Вариант 2: получение истории переводов (getTransfersByAddress)

getTransfersByAddress guide

getTransfersByAddress reference

​Вариант 3: получение активов кошелька (DAS API)

DAS API overview

getAssetsByOwner reference

​Вариант 4: получение балансов кошелька через REST (Wallet API)

Wallet API overview

Wallet Balances reference

​Дальнейшие действия

Getting Data overview

API Reference

Быстрая настройка

Вариант 1: загрузка истории транзакций (getTransactionsForAddress)

Вариант 2: получение истории переводов (getTransfersByAddress)

Вариант 3: получение активов кошелька (DAS API)

Вариант 4: получение балансов кошелька через REST (Wallet API)

Дальнейшие действия