Skip to main content
Wallet API находится на этапе бета-тестирования. Эндпоинты и форматы ответов могут измениться.

​
Что такое Wallet API?

Wallet API предоставляет высокоуровневые REST-эндпоинты для запроса полных данных кошельков Solana: балансов, истории транзакций, переводов токенов, идентификационных данных, исторических балансов и источников финансирования. Вместо нескольких вызовов RPC и разбора необработанных данных блокчейна вы получаете структурированную и понятную информацию с ценами в USD в одном запросе. Он предназначен для кошельков, трекеров портфелей, обозревателей, платежных систем, налоговых инструментов, а также систем комплаенса и противодействия отмыванию денег (AML). Все эндпоинты используют базовый URL https://api.helius.xyz и возвращают суммы в удобных для чтения единицах без необходимости преобразования лампортов.

​
Почему стоит выбрать Helius для работы с данными кошельков?

One REST call

Структурированные балансы, история и переводы без необходимости объединять необработанные ответы RPC.

USD pricing built in

Балансы токенов содержат значения в USD и общую стоимость портфеля, полученные из DAS.

Identity resolution

Более 32 500 размеченных аккаунтов и программ, а также более 21,5 млн категориальных тегов для бирж, протоколов и организаций.

Human-readable output

Понятные данные с учетом десятичных разрядов вместо необработанных лампортов и инструкций.

​
Основные эндпоинты

Wallet Identity

Определяйте известные кошельки по адресу или домену SNS/ANS: биржи, протоколы, организации.

Wallet Balances

Балансы всех токенов и NFT со значениями в USD, логотипами и метаданными.

Historical Balance

Баланс токена или SOL на момент прошлой временной метки, даты и времени либо слота.

Wallet History

Полная история транзакций с изменениями баланса для каждой транзакции.

Token Transfers

Все входящие и исходящие переводы со сведениями об отправителе и получателе.

Funding Source

Исходный источник финансирования кошелька, определенный по первому входящему переводу SOL.

​
Какой эндпоинт использовать?

Краткий справочник по базовым маршрутам (базовый URL: https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — получить идентификационные данные кошелька по адресу или домену SNS/ANS
  • POST /v1/wallet/batch-identity — пакетный поиск идентификационных данных (до 100 адресов и/или доменов)
  • GET /v1/wallet/{wallet}/balances — получить балансы всех токенов и NFT
  • GET /v1/wallet/{wallet}/balance-at — получить баланс токена или SOL на момент прошлой временной метки, даты и времени либо слота
  • GET /v1/wallet/{wallet}/history — получить историю транзакций с изменениями баланса
  • GET /v1/wallet/{wallet}/transfers — получить данные обо всех переводах токенов
  • GET /v1/wallet/{wallet}/funded-by — найти исходный источник финансирования

​
Аутентификация

Для всех запросов Wallet API требуется ключ API. Его можно передать как параметр запроса или заголовок:

​
Требования к тарифному плану

Для эндпоинтов идентификации и источника финансирования требуется платный тарифный план. На бесплатном тарифе запросы к этим эндпоинтам возвращают 403 Forbidden. Все остальные эндпоинты доступны на всех тарифах, включая бесплатный. Любой платный тариф открывает доступ к закрытым эндпоинтам: Developer, Business и всем более высоким тарифам, например Enterprise. Чтобы включить поиск идентификационных данных и источников финансирования, повысьте тарифный план в панели управления.

​
Суммы и единицы измерения

Wallet API — это высокоуровневая абстракция над необработанными данными Solana. Все поля amount в ответах представлены в удобном для чтения виде: они уже разделены на decimals токена, поэтому их можно отображать напрямую без преобразования. Необработанные вызовы Solana RPC возвращают значения в лампортах (минимальных единицах, 10⁻⁹ SOL), а Wallet API — нет. "amount": 1.5 означает 1,5 SOL, а не 1,5 лампорта. Если требуются точные вычисления, некоторые эндпоинты также предоставляют amountRaw: то же значение в виде необработанного целого числа, сериализованного как строка во избежание потери точности при вычислениях с плавающей запятой. Формула преобразования: amount = parseInt(amountRaw) / 10**decimals Используйте amount для отображения. Используйте amountRaw при передаче значений в ончейн-инструкции или другие системы, которым требуются точные целочисленные вычисления.

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

1

Get your API key

Зарегистрируйтесь на dashboard.helius.dev, чтобы получить ключ API.
2

Choose your endpoint

Используйте приведенную выше таблицу, чтобы выбрать эндпоинт для своего сценария использования.
3

Make your first request

Начните с простого запроса баланса:
4

Handle the response

Разберите ответ JSON и отобразите данные в своем приложении.

​
Следующие шаги

Getting Data

Изучите все способы запроса данных Solana в Helius.

API Reference

Схемы запросов и ответов для всех эндпоинтов Wallet API.

Contact Support

Получите помощь через Discord, чат или электронную почту.