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

Обзор

Конечная точка Token Transfers возвращает все операции по переводу токенов для кошелька Solana, включая подробные сведения об отправителях и получателях. В отличие от полной истории транзакций, эта конечная точка предназначена специально для переводов, поэтому она идеально подходит для отслеживания платежей и мониторинга переводов. Конечная точка возвращает до 100 переводов за запрос (по умолчанию — 50). Чтобы получить следующую страницу, используйте параметр cursor со значением pagination.nextCursor. Проверяйте pagination.hasMore, чтобы узнать, доступны ли дополнительные результаты.

Когда это использовать

Используйте Token Transfers API, когда требуется:
  • Отслеживать платежи: контролировать входящие платежи для платёжных систем.
  • Создать ленту переводов: отображать простую ленту операций «отправлено/получено».
  • Отслеживать определённые токены: контролировать переводы определённого токена (например, платежи в USDC).
  • Определять контрагентов: узнавать, кто отправил или получил токены.
  • Создавать квитанции: формировать платёжные квитанции с данными отправителя и получателя.
  • Выявлять подозрительную активность: отслеживать необычные схемы переводов.

Быстрый старт

Базовый запрос переводов

Получите последние входящие и исходящие переводы:

Фильтрация по направлению

Отфильтруйте результаты на стороне клиента, чтобы получить только входящие или исходящие переводы:

Параметры запроса

Формат ответа

Примечания к полям

  • direction: относительно кошелька, данные которого вы запрашиваете. in — это полученные токены (входящий платёж); out — отправленные токены (исходящий платёж).
  • counterparty: для переводов in — отправитель; для переводов out — получатель.
  • amount: удобочитаемая сумма перевода, уже разделённая на decimals. Используйте её для отображения (например, 1.5 SOL или 100.0 USDC).
  • 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

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