> ## 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
> Renvoie les statuts d'une liste de signatures. Chaque signature doit être un txid, la première signature d'une transaction.
## Paramètres de requête
Tableau de signatures de transaction (jusqu'à 256), encodées en base-58.
Permet de rechercher au-delà du cache de statut récent pour trouver des transactions historiques plus anciennes.
## OpenAPI
````yaml fr/openapi/rpc-http/getSignatureStatuses.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de suivi de confirmation des transactions pour surveiller le statut et
le niveau de finalité de plusieurs transactions Solana avec des mises à jour
en temps réel.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Point de terminaison RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Point de terminaison RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignatureStatuses
description: >
Récupérer le statut de confirmation pour plusieurs transactions Solana
dans une seule requête groupée efficace.
Cette API essentielle de suivi des transactions permet aux applications
de surveiller la progression des transactions à travers le processus de
consensus Solana, de la soumission initiale à la confirmation finale.
Retourne des informations détaillées sur le statut des transactions, y
compris le slot de traitement, le nombre de confirmations, les détails
des erreurs et le niveau de finalité. Critique pour les portefeuilles,
les échanges, les processeurs de paiement et toute application
qui a besoin de vérifier quand les transactions ont été réglées avec
succès sur la blockchain avec des options de recherche historique des
transactions configurables.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La version du protocole JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identifiant unique pour la requête.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: Le nom de la méthode RPC à invoquer.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: >-
Tableau contenant les signatures des transactions et l'objet
de configuration optionnel.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Tableau des signatures de transactions (jusqu'à 256),
sous forme de chaînes encodées en base-58.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Options de configuration.
properties:
searchTransactionHistory:
type: boolean
description: >-
Activer la recherche au-delà du cache des statuts
récents pour trouver des transactions historiques
plus anciennes.
example: true
responses:
'200':
description: Statuts des signatures récupérés avec succès.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La version du protocole JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identifiant correspondant à la requête.
example: '1'
result:
type: object
description: >-
Contient le contexte et les valeurs de statut de
signature.
properties:
context:
type: object
properties:
slot:
type: integer
description: Slot dans lequel les données ont été récupérées.
example: 82
value:
type: array
description: Liste des statuts des signatures de transactions.
items:
oneOf:
- type: 'null'
description: Null si la transaction est inconnue.
- type: object
properties:
slot:
type: integer
description: >-
Numéro de slot blockchain Solana où cette
transaction a été incluse dans un bloc.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Number of confirmed blocks since this
transaction was processed (null if fully
finalized).
- type: 'null'
description: >-
Null indique que la transaction a
atteint la finalité maximale
(enracinée).
example: 48
err:
oneOf:
- type: object
description: >-
Objet d'erreur contenant des détails si
la transaction a échoué lors de
l'exécution.
- type: 'null'
description: >-
Null indique que la transaction a été
exécutée avec succès sans erreurs.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Statut de finalité actuel de la transaction
sur le réseau Solana (traité → confirmé →
finalisé).
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: >-
Mauvaise requête - Paramètres de requête invalides ou requête
malformée.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Paramètres invalides
id: '1'
'401':
description: Non autorisé - Clé API invalide ou manquante.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Non autorisé
id: '1'
'429':
description: Trop de requêtes - Limite de taux dépassée.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Trop de requêtes
id: '1'
'500':
description: >-
Erreur interne du serveur - Une erreur s'est produite sur le
serveur.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Erreur interne
id: '1'
'503':
description: Service indisponible - Le service est temporairement indisponible.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service indisponible
id: '1'
'504':
description: Délai d'attente dépassé - La requête a expiré.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Délai d'attente de la passerelle
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: La version du protocole JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Le code d'erreur.
example: -32602
message:
type: string
description: Le message d'erreur.
data:
type: object
description: Données supplémentaires sur l'erreur.
id:
type: string
description: Identifiant correspondant à la requête.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Votre clé API Helius. Vous pouvez en obtenir une gratuitement dans le
[tableau de bord](https://dashboard.helius.dev/api-keys).
````