> ## 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.
# getSignaturesForAddress
> getSignaturesForAddress renvoie les signatures de transaction confirmées qui incluent une adresse Solana dans accountKeys, en remontant dans le temps à partir du bloc le plus récent.
Pour un filtrage avancé, un tri et un historique de compte token, utilisez [`getTransactionsForAddress`](/docs/fr/rpc/gettransactionsforaddress) à la place. Notez que `getSignaturesForAddress` n'inclut pas les transactions impliquant des comptes de tokens associés.
## Paramètres de la requête
Adresse de compte Solana pour récupérer l'historique des transactions (portefeuille, token, programme, NFT, etc.).
Le niveau d'engagement pour la requête. L'engagement `processed` n'est pas pris en charge.
* `confirmed`
* `finalized`
Le slot minimum auquel la requête peut être évaluée.
Nombre maximum de signatures de transaction à retourner dans une seule requête (1-1 000).
Paramètre de pagination pour obtenir des transactions avant cette signature (plus tôt dans le temps).
Obtenez des transactions jusqu'à ce que cette signature soit atteinte, utile pour des plages de temps spécifiques.
## OpenAPI
````yaml fr/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API complète d'historique de transactions Solana pour récupérer et analyser
les activités historiques de la blockchain associées à toute adresse de
portefeuille ou programme.
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: getSignaturesForAddress
description: >
Récupérer les signatures de transactions pour l'activité impliquant une
adresse Solana spécifique avec une pagination puissante.
Cette API essentielle fournit l'historique des transactions pour tout
portefeuille Solana, jeton, programme ou adresse NFT,
retournant des signatures de transactions chronologiques avec leur
statut, timing, et résultats d'exécution.
Parfait pour construire des historiques de transactions de portefeuille,
le suivi des activités des programmes, les analyses d'adresses,
et toute application nécessitant de suivre les opérations historiques
sur la blockchain Solana.
Supporte une pagination flexible pour accéder à l'intégralité de
l'historique des transactions.
operationId: getSignaturesForAddress
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: La version du protocole JSON-RPC.
default: '2.0'
id:
type: string
example: '1'
description: Un identifiant unique pour la requête.
default: '1'
method:
type: string
enum:
- getSignaturesForAddress
example: getSignaturesForAddress
description: Le nom de la méthode RPC à invoquer.
default: getSignaturesForAddress
params:
type: array
description: >-
Tableau contenant l'adresse de compte requise et un objet de
configuration optionnel.
default:
- Vote111111111111111111111111111111111111111
items:
oneOf:
- type: string
description: >-
Adresse de compte Solana pour récupérer l'historique
des transactions (portefeuille, jeton, programme, NFT,
etc.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Configuration avancée de la requête pour personnaliser
la récupération de l'historique des transactions.
properties:
commitment:
type: string
description: >-
Le niveau d'engagement pour la requête.
L'engagement `processed` n'est pas pris en charge.
enum:
- confirmed
- finalized
example: finalized
minContextSlot:
type: integer
description: >-
Le slot minimum auquel la requête peut être
évaluée.
example: 1000
limit:
type: integer
description: >-
Nombre maximum de signatures de transactions à
retourner dans une seule requête (1-1,000).
example: 1000
before:
type: string
description: >-
Paramètre de pagination pour obtenir les
transactions avant cette signature (plus tôt dans
le temps).
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
until:
type: string
description: >-
Obtenir les transactions jusqu'à ce que cette
signature soit atteinte, utile pour des plages de
temps spécifiques.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
responses:
'200':
description: Signatures récupérées avec succès pour l'adresse spécifiée.
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: array
description: Liste des informations de signature de transaction.
items:
type: object
description: Détails pour chaque signature de transaction.
properties:
signature:
type: string
description: >-
Signature de transaction en tant que chaîne encodée
en base-58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: Le slot qui contient le bloc avec la transaction.
example: 114
err:
oneOf:
- type: object
description: Erreur si la transaction a échoué
- type: 'null'
description: >-
Erreur si la transaction a échoué, ou null si elle a
réussi.
example: null
memo:
oneOf:
- type: string
description: Mémo associé à la transaction
- type: 'null'
description: Mémo associé à la transaction, ou null si aucun.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Temps de production estimé en tant que timestamp
Unix
- type: 'null'
description: >-
Temps de production estimé en tant que timestamp
Unix (secondes depuis l'époque), ou null si non
disponible.
example: null
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Statut de confirmation du cluster pour la
transaction
- type: 'null'
description: >-
Statut de confirmation du cluster pour la
transaction.
example: finalized
examples:
response:
value:
jsonrpc: '2.0'
id: 1
result:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 114
err: null
memo: null
blockTime: null
confirmationStatus: finalized
application/json; schema=examples/request:
example:
jsonrpc: '2.0'
id: 1
method: getSignaturesForAddress
params:
- Vote111111111111111111111111111111111111111
- limit: 1
'400':
description: >-
Requête incorrecte - Paramètres de requête invalides ou requête mal
formé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 débit 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 est survenue 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 de la passerelle - 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).
````