> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getTransactionsForAddress
> getTransactionsForAddress возвращает полную историю транзакций Solana для адреса за один вызов — с фильтрами по времени, слоту и статусу, сортировкой и пагинацией по ключу.
## Параметры запроса
Адрес аккаунта Solana, для которого нужно получить историю транзакций (кошелек, токен, программа, NFT и т. д.).
Уровень детализации возвращаемых транзакций.
* `signatures`
* `full`
Порядок сортировки возвращаемых транзакций.
* `asc`
* `desc`
Уровень подтверждения для запроса. Уровень подтверждения `processed` не поддерживается.
* `confirmed`
* `finalized`
Минимальный слот контекста для запроса (необязательно).
Максимальное количество транзакций на запрос. Используйте значения от 1 до 1000 для transactionDetails:"signatures" и от 1 до 1000 для transactionDetails:"full".
Токен пагинации из предыдущего ответа для получения следующей страницы результатов (формат "slot:position").
Формат кодирования данных транзакции (применяется только при transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Максимальная возвращаемая версия транзакции (применяется только при transactionDetails=full). Укажите 1, чтобы получать устаревшие транзакции, а также транзакции версий v0 и v1.
Расширенные фильтры для сужения результатов поиска транзакций.
Фильтр по номеру слота.
Больше или равно номеру слота.
Больше номера слота.
Меньше или равно номеру слота.
Меньше номера слота.
Фильтр по метке времени блока (временная метка Unix).
Больше или равно временной метке.
Больше временной метки.
Меньше или равно временной метке.
Меньше временной метки.
Равно временной метке.
Фильтр по подписи транзакции.
Получить транзакции с подписями, которые больше или равны этому значению.
Получить транзакции после этой подписи.
Получить транзакции с подписями, которые меньше или равны этому значению.
Получить транзакции до этой подписи.
Фильтр по статусу транзакции.
* `succeeded`
* `failed`
* `any`
Фильтр транзакций по связанным токен-аккаунтам. Определяет, следует ли включать транзакции с участием токен-аккаунтов, принадлежащих указанному адресу.
* `none`
* `balanceChanged`
* `all`
Ограничивает результаты транзакциями, в которых запрашиваемый адрес участвовал в переводе токенов, соответствующем заданным критериям. Все поля необязательны и объединяются по логике AND.
Адрес контрагента. Соответствует переводам, на другой стороне которых находится этот адрес.
Направление перевода относительно запрашиваемого адреса.
* `in`
* `out`
* `any`
Адрес минта токена для фильтрации.
Фильтр по диапазону исходных сумм в блокчейне. Все поля необязательны и могут использоваться совместно.
## OpenAPI
````yaml ru/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Расширенный API истории транзакций Solana с мощными возможностями
фильтрации, сортировки и пагинации для получения полных данных о транзакциях
по любому адресу.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Конечная точка RPC основной сети
- url: https://devnet.helius-rpc.com
description: Конечная точка RPC тестовой сети Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransactionsForAddress
description: >
Расширенный API истории транзакций с мощными возможностями фильтрации,
сортировки и пагинации
для получения данных о транзакциях, связанных с любым адресом Solana.
Этот расширенный метод устраняет
ограничения getSignaturesForAddress и предлагает:
- Двунаправленную сортировку (хронологический порядок по возрастанию или
убыванию)
- Расширенную фильтрацию по слоту, времени, подписи и статусу транзакции
- Поддержку аккаунтов токенов (включение транзакций связанных аккаунтов
токенов)
- Фильтрацию переводов токенов по контрагенту, направлению, адресу
выпуска и необработанной сумме
- Эффективную пагинацию по ключам с использованием ключей на основе
слотов
- Возможность возвращать полные сведения о транзакциях или только
подписи
- Поддержку запросов по диапазону времени и фильтрации по статусу
Идеально подходит для создания полной истории кошельков, аналитических
панелей, журналов аудита
и любых приложений, которым требуется подробный анализ транзакций с
точным управлением получением данных.
operationId: getTransactionsForAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: Версия протокола JSON-RPC.
default: '2.0'
id:
type: string
example: '1'
description: Уникальный идентификатор запроса.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: Имя вызываемого метода RPC.
default: getTransactionsForAddress
params:
type: array
description: >-
Массив, содержащий обязательный адрес аккаунта и
необязательный объект конфигурации.
minItems: 1
maxItems: 2
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
items:
oneOf:
- type: string
description: >-
Адрес аккаунта Solana, для которого нужно получить
историю транзакций (кошелек, токен, программа, NFT и
т. д.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Расширенная конфигурация запроса для фильтрации,
сортировки и пагинации.
properties:
transactionDetails:
type: string
description: >-
Уровень детализации возвращаемых данных
транзакции.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: Порядок сортировки возвращаемых транзакций.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
Уровень подтверждения для запроса. Уровень
подтверждения `processed` не поддерживается.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Минимальный слот контекста для запроса
(необязательно).
example: 1000
limit:
type: integer
description: >-
Максимальное количество транзакций в одном
запросе. Используйте 1–1000 для
transactionDetails:"signatures" и 1–1000 для
transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Токен пагинации из предыдущего ответа для
получения следующей страницы результатов (формат
"slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Формат кодирования данных транзакции (применяется
только при transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Максимальная возвращаемая версия транзакции
(применяется только при transactionDetails=full).
Укажите 1, чтобы получать устаревшие транзакции, а
также транзакции v0 и v1.
example: 1
filters:
type: object
description: >-
Расширенные фильтры для ограничения результатов
транзакций.
properties:
slot:
type: object
description: Фильтрация по номеру слота.
properties:
gte:
type: integer
description: Больше или равно номеру слота.
example: 100
gt:
type: integer
description: Больше номера слота.
example: 100
lte:
type: integer
description: Меньше или равно номеру слота.
example: 200
lt:
type: integer
description: Меньше номера слота.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Фильтрация по временной метке блока (временная
метка Unix).
properties:
gte:
type: integer
description: Больше или равно временной метке.
example: 1640995200
gt:
type: integer
description: Больше временной метки.
example: 1640995200
lte:
type: integer
description: Меньше или равно временной метке.
example: 1641081600
lt:
type: integer
description: Меньше временной метки.
example: 1641081600
eq:
type: integer
description: Равно временной метке.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Фильтрация по подписи транзакции.
properties:
gte:
type: string
description: >-
Получить транзакции с подписями, большими
или равными этому значению.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: Получить транзакции после этой подписи.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Получить транзакции с подписями, меньшими
или равными этому значению.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: Получить транзакции до этой подписи.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Фильтрация по статусу транзакции.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Фильтрация транзакций связанных аккаунтов
токенов. Определяет, следует ли включать
транзакции с аккаунтами токенов,
принадлежащими адресу.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Ограничивает результаты транзакциями, в
которых запрашиваемый адрес участвовал в
переводе токенов, соответствующем контрагенту,
направлению, адресу выпуска или диапазону
необработанных сумм.
additionalProperties: false
responses:
'200':
description: Транзакции для указанного адреса успешно получены.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Версия протокола JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Идентификатор, соответствующий запросу.
example: '1'
result:
type: object
description: Данные транзакций и сведения о пагинации.
properties:
data:
type: array
description: Список сведений о транзакциях.
items:
oneOf:
- type: object
description: >-
Сводка транзакции на уровне подписи (когда
transactionDetails имеет значение "signatures").
properties:
signature:
type: string
description: >-
Подпись транзакции в виде строки,
закодированной в base-58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: Слот, содержащий блок с транзакцией.
example: 1054
transactionIndex:
type: integer
description: >-
Индекс транзакции в блоке, начинающийся с
нуля. Полезен для определения порядка
транзакций внутри блока.
example: 42
err:
oneOf:
- type: object
description: >-
Ошибка, если транзакция завершилась
неудачно
- type: 'null'
description: >-
Ошибка, если транзакция завершилась
неудачно, или null в случае успеха.
example: null
memo:
oneOf:
- type: string
description: Примечание, связанное с транзакцией
- type: 'null'
description: >-
Примечание, связанное с транзакцией, или
null, если оно отсутствует.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Расчетное время создания в виде
временной метки Unix
- type: 'null'
description: >-
Расчетное время создания в виде временной
метки Unix (в секундах с начала эпохи) или
null, если оно недоступно.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Статус подтверждения транзакции
кластером
- type: 'null'
description: Статус подтверждения транзакции кластером.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Полная транзакция с метаданными статуса (когда
transactionDetails имеет значение "full").
properties:
slot:
type: integer
description: Слот, содержащий блок с транзакцией.
example: 1054
transactionIndex:
type: integer
description: >-
Индекс транзакции в блоке, начинающийся с
нуля. Полезен для определения порядка
транзакций внутри блока.
example: 42
transaction:
type: object
description: >-
Закодированный или проанализированный объект
транзакции в соответствии с выбранным
форматом кодирования.
meta:
type: object
description: >-
Метаданные статуса транзакции — той же
структуры, что и getTransaction, включая
err, fee, preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages и
computeUnitsConsumed.
blockTime:
oneOf:
- type: integer
description: >-
Расчетное время создания в виде
временной метки Unix
- type: 'null'
description: >-
Расчетное время создания в виде временной
метки Unix (в секундах с начала эпохи) или
null, если оно недоступно.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: Токен для получения следующей страницы результатов
- type: 'null'
description: >-
Токен пагинации для следующей страницы или null, если
результатов больше нет.
example: '1055:5'
examples:
signaturesResponse:
summary: Ответ только со сведениями о подписях
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1054
transactionIndex: 42
err: null
memo: null
blockTime: 1641038400
confirmationStatus: finalized
- signature: >-
kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1055
transactionIndex: 15
err: null
memo: null
blockTime: 1641038460
confirmationStatus: finalized
paginationToken: '1055:5'
fullResponse:
summary: Ответ с полными сведениями о транзакциях
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
err: null
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
preTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '1500000'
decimals: 6
uiAmount: 1.5
uiAmountString: '1.5'
postTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '500000'
decimals: 6
uiAmount: 0.5
uiAmountString: '0.5'
logMessages:
- ...
computeUnitsConsumed: 2100
blockTime: 1641038400
paginationToken: '1055:5'
'400':
description: >-
Неверный запрос — недопустимые параметры или некорректно
сформированный запрос.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Недопустимые параметры
id: '1'
'401':
description: Нет авторизации — недействительный или отсутствующий ключ API.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Нет авторизации
id: '1'
'429':
description: Слишком много запросов — превышено ограничение частоты запросов.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Слишком много запросов
id: '1'
'500':
description: Внутренняя ошибка сервера — на сервере произошла ошибка.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Внутренняя ошибка
id: '1'
'503':
description: Сервис недоступен — сервис временно недоступен.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Сервис недоступен
id: '1'
'504':
description: Время ожидания шлюза истекло — время ожидания запроса истекло.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Время ожидания шлюза истекло
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenTransferFilter:
type: object
description: >-
Ограничивает результаты транзакциями, в которых запрашиваемый адрес
участвовал в переводе токенов, соответствующем заданным критериям. Все
поля необязательны и объединяются по логике AND.
properties:
with:
type: string
description: >-
Адрес контрагента. Соответствует переводам, на другой стороне
которых находится этот адрес.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
direction:
type: string
description: Направление перевода относительно запрашиваемого адреса.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: Адрес выпуска токена для фильтрации.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
$ref: '#/components/schemas/TokenTransferAmountFilter'
description: >-
Сравнение сумм с использованием необработанного значения из
блокчейна, а не значения пользовательского интерфейса или значения с
учетом десятичных знаков.
additionalProperties: false
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: Версия протокола JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Код ошибки.
example: -32602
message:
type: string
description: Сообщение об ошибке.
data:
type: object
description: Дополнительные сведения об ошибке.
id:
type: string
description: Идентификатор, соответствующий запросу.
example: '1'
TokenTransferAmountFilter:
type: object
description: >-
Фильтр диапазона необработанных сумм в блокчейне. Все поля необязательны
и могут использоваться совместно.
properties:
gt:
type: number
description: Строго больше.
example: 1000000
gte:
type: number
description: Больше или равно.
example: 1000000
lt:
type: number
description: Строго меньше.
example: 5000000
lte:
type: number
description: Меньше или равно.
example: 5000000
additionalProperties: false
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Ваш ключ API Helius. Его можно бесплатно получить на [панели
управления](https://dashboard.helius.dev/api-keys).
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.