Skip to main content
POST
getTransfersByAddress

Обзор

getTransfersByAddress возвращает разобранные, удобочитаемые объекты переводов токенов и нативного SOL, в которых участвует адрес кошелька. Используйте фильтры, чтобы ограничить результаты по минту, времени блока, сумме, слоту, направлению или контрагенту. Ответ предназначен для точного отображения активности кошелька, отслеживания платежей и сверки баланса без повторной реализации разбора переводов Solana.
Переводы при выпуске и сжигании являются односторонними. Операции выпуска имеют fromUserAccount: null и могут возвращаться только как входящие переводы для получателя. Операции сжигания имеют toUserAccount: null и могут возвращаться только как исходящие переводы для владельца, выполняющего сжигание.

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

string
обязательно
Закодированный в Base58 адрес кошелька владельца, для которого запрашиваются переводы. Передайте адрес владельца кошелька, а не связанного токен-аккаунта (ATA).
string
Фильтр по адресу контрагента. Возвращает только переводы на этот адрес или с него.
string
по умолчанию:"any"
Фильтр по направлению перевода относительно запрашиваемого адреса.
  • in
  • out
  • any
string
Адрес минта токена. Используйте So11111111111111111111111111111111111111111 для нативного SOL и So11111111111111111111111111111111111111112 для WSOL.
string
по умолчанию:"merged"
Режим отображения SOL/WSOL. Режим merged обрабатывает WSOL как нативный SOL и исключает строки обёртывания и развёртывания, упрощая сверку истории в SOL; режим separate сохраняет WSOL как отдельный минт SPL-токена и включает строки обёртывания и развёртывания.
  • merged
  • separate
object
Дополнительные фильтры по сумме, времени блока и слоту.
object
Фильтр сравнения диапазона. Все поля необязательны и могут использоваться совместно.
number
Больше.
number
Больше или равно.
number
Меньше.
number
Меньше или равно.
object
Фильтр сравнения диапазона. Все поля необязательны и могут использоваться совместно.
number
Больше.
number
Больше или равно.
number
Меньше.
number
Меньше или равно.
object
Фильтр сравнения диапазона. Все поля необязательны и могут использоваться совместно.
number
Больше.
number
Больше или равно.
number
Меньше.
number
Меньше или равно.
number
по умолчанию:"100"
Максимальное количество возвращаемых переводов. Диапазон: от 1 до 100.
string
Курсор из предыдущего ответа для пагинации.
string
по умолчанию:"finalized"
Уровень подтверждения данных.
  • finalized
  • confirmed
number
Минимальный слот контекста для запроса (необязательно).
string
по умолчанию:"desc"
Порядок результатов.
  • asc
  • desc

Авторизации

api-key
string
query
обязательно

Ваш ключ API Helius. Его можно бесплатно получить в панели управления.

Тело

application/json
jsonrpc
enum<string>
по умолчанию:2.0
обязательно

Версия протокола JSON-RPC.

Доступные опции:
2.0
Пример:

"2.0"

id
string
по умолчанию:1
обязательно

Уникальный идентификатор запроса.

Пример:

"1"

method
enum<string>
по умолчанию:getTransfersByAddress
обязательно

Имя вызываемого метода RPC.

Доступные опции:
getTransfersByAddress
Пример:

"getTransfersByAddress"

params
(string | object)[]
обязательно

Массив, содержащий обязательный адрес кошелька и необязательный объект конфигурации.

Required array length: 1 - 2 elements

Адрес кошелька владельца в кодировке Base58, для которого нужно запросить переводы. Передайте адрес владельца кошелька, а не связанный токен-аккаунт (ATA).

Пример:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

Ответ

Переводы для указанного адреса успешно получены.

jsonrpc
enum<string>

Версия протокола JSON-RPC.

Доступные опции:
2.0
Пример:

"2.0"

id
string

Идентификатор, соответствующий запросу.

Пример:

"1"

result
object

Данные переводов и сведения о постраничном выводе.