> ## 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.
# getSignatureStatuses
> Возвращает статусы списка подписей. Каждая подпись должна быть txid — первой подписью транзакции.
## Параметры запроса
Массив подписей транзакций (до 256) в виде строк в кодировке base-58.
Включите поиск за пределами кэша недавних статусов, чтобы находить более старые транзакции в истории.
## OpenAPI
````yaml ru/openapi/rpc-http/getSignatureStatuses.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: getSignatureStatuses
description: >
Получите статусы подтверждения нескольких транзакций Solana с помощью
одного эффективного пакетного запроса.
Этот важный API отслеживания транзакций позволяет приложениям
контролировать прохождение транзакций
через процесс консенсуса Solana — от первоначальной отправки до
окончательного подтверждения. Возвращает подробные
сведения о статусе транзакции, включая слот обработки, количество
подтверждений, сведения об ошибках
и уровень финальности. Необходим для кошельков, бирж, платежных систем и
любых приложений, которым
требуется проверять успешное завершение транзакций в блокчейне с
настраиваемыми
параметрами поиска исторических транзакций.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Версия протокола JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Уникальный идентификатор запроса.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: Имя вызываемого метода RPC.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: >-
Массив, содержащий подписи транзакций и необязательный
объект конфигурации.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Массив подписей транзакций (до 256) в виде строк,
закодированных в base-58.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Параметры конфигурации.
properties:
searchTransactionHistory:
type: boolean
description: >-
Включает поиск за пределами кэша недавних статусов
для обнаружения более старых исторических
транзакций.
example: true
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:
context:
type: object
properties:
slot:
type: integer
description: Слот, в котором были получены данные.
example: 82
value:
type: array
description: Список статусов подписей транзакций.
items:
oneOf:
- type: 'null'
description: Значение null, если транзакция неизвестна.
- type: object
properties:
slot:
type: integer
description: >-
Номер слота блокчейна Solana, в котором эта
транзакция была включена в блок.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Количество подтвержденных блоков с
момента обработки этой транзакции (null,
если она полностью финализирована).
- type: 'null'
description: >-
Значение null означает, что транзакция
достигла максимальной финальности
(rooted).
example: 48
err:
oneOf:
- type: object
description: >-
Объект ошибки со сведениями о сбое
транзакции во время выполнения.
- type: 'null'
description: >-
Значение null означает, что транзакция
успешно выполнена без ошибок.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Текущий статус финальности транзакции в сети
Solana (processed → confirmed → finalized).
example: finalized
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 82
value:
- slot: 48
confirmations: 48
err: null
confirmationStatus: finalized
- null
'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:
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'
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.