Wallet API находится на этапе бета-тестирования. Конечные точки и форматы ответов могут измениться.
Обзор
Конечная точка Token Transfers возвращает все операции по переводу токенов для кошелька Solana, включая подробные сведения об отправителях и получателях. В отличие от полной истории транзакций, эта конечная точка предназначена специально для переводов, поэтому она идеально подходит для отслеживания платежей и мониторинга переводов. Конечная точка возвращает до 100 переводов за запрос (по умолчанию — 50). Чтобы получить следующую страницу, используйте параметрcursor со значением pagination.nextCursor. Проверяйте pagination.hasMore, чтобы узнать, доступны ли дополнительные результаты.
Когда это использовать
Используйте Token Transfers API, когда требуется:- Отслеживать платежи: контролировать входящие платежи для платёжных систем.
- Создать ленту переводов: отображать простую ленту операций «отправлено/получено».
- Отслеживать определённые токены: контролировать переводы определённого токена (например, платежи в USDC).
- Определять контрагентов: узнавать, кто отправил или получил токены.
- Создавать квитанции: формировать платёжные квитанции с данными отправителя и получателя.
- Выявлять подозрительную активность: отслеживать необычные схемы переводов.
Быстрый старт
Базовый запрос переводов
Получите последние входящие и исходящие переводы:- JavaScript
- Python
- cURL
Фильтрация по направлению
Отфильтруйте результаты на стороне клиента, чтобы получить только входящие или исходящие переводы:- Incoming Only
- Outgoing Only
Параметры запроса
Формат ответа
Примечания к полям
direction: относительно кошелька, данные которого вы запрашиваете.in— это полученные токены (входящий платёж);out— отправленные токены (исходящий платёж).counterparty: для переводовin— отправитель; для переводовout— получатель.amount: удобочитаемая сумма перевода, уже разделённая наdecimals. Используйте её для отображения (например,1.5SOL или100.0USDC).amountRaw: та же сумма в виде необработанной целочисленной строки до корректировки десятичных знаков (например,"1500000000"для 1,5 SOL). Сериализуется в виде строки, чтобы избежать потери точности чисел с плавающей точкой. Используйте её для ончейн-инструкций или точных вычислений:amount = parseInt(amountRaw) / 10**decimals.mint: адрес минта токена (So11111111111111111111111111111111111111111для нативного SOL).symbol: символ токена. Он есть не у всех токенов; еслиsymbolимеет значениеnull, используйте адрес минта.
Варианты использования
Отслеживание истории платежей продавца
Отслеживайте входящие платежи в USDC:Создание платёжной квитанции
Создайте подробную квитанцию для определённого перевода:Мониторинг подозрительных схем переводов
Выявляйте необычную активность переводов:Создание ленты операций по переводам
Создайте удобную для пользователя ленту операций:Сверка платежей
Сопоставляйте переводы с ожидаемыми платежами:Пагинация
Для кошельков с большим количеством переводов последовательно загружайте страницы результатов с помощью параметраcursor и pagination.hasMore:
Рекомендации
- Фильтруйте определённые токены на стороне клиента. API возвращает все переводы токенов. Фильтруйте по адресу
mint, чтобы отслеживать определённые токены, например USDC или SOL. - Объединяйте с Identity API. Используйте конечную точку Identity, чтобы показывать удобочитаемые названия известных контрагентов, включая биржи, протоколы и другие организации.
- Кешируйте последние переводы. Данные переводов не меняются. Кешируйте результаты и запрашивайте только новые переводы, выполненные после последнего запроса.
- Используйте пагинацию для получения полной истории. Реализуйте пагинацию для эффективной обработки кошельков с тысячами переводов.
- Обрабатывайте отсутствие символа. Поле
symbolесть не у всех токенов. Еслиsymbolимеет значениеnull, используйте адрес минта.
Переводы и история транзакций
Используйте Transfers, если вас интересуют только платежи. Используйте Transaction History, если нужны полные данные об изменениях баланса.
Распространённые ошибки
Дальнейшие действия
Wallet History
Полная история транзакций с изменениями баланса для каждой транзакции.
Wallet API Overview
Все конечные точки Wallet API и общие соглашения.
API Reference
Схемы запросов и ответов для переводов токенов.