> ## 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 renvoie l'historique complet des transactions Solana pour une adresse en un seul appel — filtres de temps, de slot et de statut, tri et pagination par ensemble de clés.
## Paramètres de requête
Adresse du compte Solana pour récupérer l'historique des transactions (portefeuille, jeton, programme, NFT, etc.).
Niveau de détail des transactions à retourner.
* `signatures`
* `full`
Ordre de tri pour les transactions retournées.
* `asc`
* `desc`
Le niveau d'engagement pour la requête. L'engagement `processed` n'est pas pris en charge.
* `confirmed`
* `finalized`
Slot de contexte minimum à utiliser pour la requête (optionnel).
Nombre maximum de transactions par requête. Utilisez 1–1000 pour transactionDetails:"signatures" et 1–1000 pour transactionDetails:"full".
Jeton de pagination de la réponse précédente pour obtenir la page suivante des résultats (format "slot:position").
Format d'encodage pour les données de transaction (s'applique uniquement lorsque transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Version maximale de transaction à retourner (s'applique uniquement lorsque transactionDetails=full). Réglez sur 1 pour recevoir des transactions legacy, v0 et v1.
Filtres avancés pour affiner les résultats des transactions.
Filtrer par numéro de slot.
Supérieur ou égal au numéro de slot.
Supérieur au numéro de slot.
Inférieur ou égal au numéro de slot.
Inférieur au numéro de slot.
Filtrer par horodatage du bloc (timestamp Unix).
Supérieur ou égal à l'horodatage.
Supérieur à l'horodatage.
Inférieur ou égal à l'horodatage.
Inférieur à l'horodatage.
Égal à l'horodatage.
Filtrer par signature de transaction.
Obtenez les transactions dont les signatures sont supérieures ou égales à cette valeur.
Obtenez les transactions après cette signature.
Obtenez les transactions dont les signatures sont inférieures ou égales à cette valeur.
Obtenez les transactions avant cette signature.
Filtrer par statut de transaction.
* `succeeded`
* `failed`
* `any`
Filtrer les transactions pour les comptes de jetons associés. Contrôle si les transactions impliquant des comptes de jetons détenus par l'adresse sont incluses.
* `none`
* `balanceChanged`
* `all`
Réduit les résultats aux transactions où l'adresse interrogée a participé à un transfert de jetons correspondant à des critères spécifiques. Tous les champs sont optionnels et combinés avec une sémantique AND.
Adresse de la contrepartie. Correspond aux transferts dont l'autre côté est cette adresse.
Direction du transfert par rapport à l'adresse interrogée.
* `in`
* `out`
* `any`
Monnaie de jeton à filtrer.
Filtre de plage de quantité brute sur la chaîne. Tous les champs sont optionnels et peuvent être combinés.
## OpenAPI
````yaml fr/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API avancée d'historique des transactions Solana avec des capacités
puissantes de filtrage, tri et pagination pour récupérer des données de
transaction complètes pour toute adresse.
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: getTransactionsForAddress
description: >
API avancée d'historique des transactions qui offre des capacités
puissantes de filtrage, tri et pagination
pour récupérer des données de transaction associées à toute adresse
Solana. Cette méthode avancée surmonte les
limitations de getSignaturesForAddress en offrant :
- Tri bidirectionnel (ordre chronologique croissant/décroissant)
- Filtrage avancé par slot, heure, signature et statut de transaction
- Support des comptes de jetons (inclut les transactions pour les
comptes de jetons associés)
- Filtrage des transferts de jetons par contrepartie, direction, mint,
et montant brut
- Pagination efficace par ensemble de clés en utilisant des clés basées
sur les slots
- Option pour retourner des détails de transaction complets ou seulement
des signatures
- Support des requêtes de plage temporelle et du filtrage de statut
Parfait pour créer des historiques de portefeuille complets, des
tableaux de bord analytiques, des pistes d'audit,
et toute application nécessitant une analyse détaillée des transactions
avec un contrôle précis sur la récupération des données.
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: 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:
- getTransactionsForAddress
example: getTransactionsForAddress
description: Le nom de la méthode RPC à invoquer.
default: getTransactionsForAddress
params:
type: array
description: >-
Tableau contenant l'adresse de compte requise et l'objet de
configuration facultatif.
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: >-
Adresse du compte Solana pour récupérer l'historique
des transactions (portefeuille, jeton, programme, NFT,
etc.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Configuration de requête avancée pour le filtrage, le
tri et la pagination.
properties:
transactionDetails:
type: string
description: Niveau de détail de transaction à retourner.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: Ordre de tri pour les transactions retournées.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
Le niveau d'engagement pour la requête.
L'engagement 'processed' n'est pas supporté.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Slot de contexte minimum à utiliser pour la
requête (facultatif).
example: 1000
limit:
type: integer
description: >-
Nombre maximum de transactions par requête.
Utiliser 1–1000 pour
transactionDetails:"signatures" et 1–1000 pour
transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Jeton de pagination de la réponse précédente pour
obtenir la page suivante des résultats (format
"slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Format d'encodage pour les données de transaction
(s'applique uniquement lorsque
transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Version maximale de transaction à retourner
(s'applique uniquement lorsque
transactionDetails=full). Réglez sur 1 pour
recevoir des transactions legacy, v0, et v1.
example: 1
filters:
type: object
description: >-
Filtres avancés pour affiner les résultats des
transactions.
properties:
slot:
type: object
description: Filtrer par numéro de slot.
properties:
gte:
type: integer
description: Supérieur ou égal au numéro de slot.
example: 100
gt:
type: integer
description: Supérieur au numéro de slot.
example: 100
lte:
type: integer
description: Inférieur ou égal au numéro de slot.
example: 200
lt:
type: integer
description: Inférieur au numéro de slot.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Filtrer par horodatage de bloc (timestamp
Unix).
properties:
gte:
type: integer
description: Supérieur ou égal à l'horodatage.
example: 1640995200
gt:
type: integer
description: Supérieur à l'horodatage.
example: 1640995200
lte:
type: integer
description: Inférieur ou égal à l'horodatage.
example: 1641081600
lt:
type: integer
description: Inférieur à l'horodatage.
example: 1641081600
eq:
type: integer
description: Égal à l'horodatage.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Filtrer par signature de transaction.
properties:
gte:
type: string
description: >-
Obtenir les transactions avec des
signatures supérieures ou égales à cette
valeur.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: >-
Obtenir des transactions après cette
signature.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Obtenir les transactions avec des
signatures inférieures ou égales à cette
valeur.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: >-
Obtenir des transactions avant cette
signature.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Filtrer par statut de transaction.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Filtrer les transactions pour les comptes de
jetons associés. Contrôle si les transactions
impliquant des comptes de jetons détenus par
l'adresse sont incluses.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Filtre pour les transactions où l'adresse
interrogée a participé à un transfert de
jetons correspondant à une contrepartie, une
direction, un mint, ou une plage de montants
bruts.
additionalProperties: false
responses:
'200':
description: Transactions 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: object
description: Données de transaction et informations de pagination.
properties:
data:
type: array
description: Liste d'informations sur les transactions.
items:
oneOf:
- type: object
description: >-
Résumé de la transaction au niveau des
signatures (lorsque transactionDetails est
"signatures").
properties:
signature:
type: string
description: >-
Signature de la 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: 1054
transactionIndex:
type: integer
description: >-
L'index zéro-basé de la transaction dans son
bloc. Utile pour déterminer l'ordre des
transactions dans un bloc.
example: 42
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 s'il
n'y en a pas.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Heure de production estimée en tant que
timestamp Unix
- type: 'null'
description: >-
Heure de production estimée en tant que
timestamp Unix (secondes depuis l'époque),
ou null si non disponible.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Statut de confirmation par le cluster de
la transaction
- type: 'null'
description: >-
Statut de confirmation par le cluster de la
transaction.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Transaction complète avec métadonnées de statut
(lorsque transactionDetails est "full").
properties:
slot:
type: integer
description: >-
Le slot qui contient le bloc avec la
transaction.
example: 1054
transactionIndex:
type: integer
description: >-
L'index zéro-basé de la transaction dans son
bloc. Utile pour déterminer l'ordre des
transactions dans un bloc.
example: 42
transaction:
type: object
description: >-
Objet de transaction encodé ou analysé selon
le format d'encodage sélectionné.
meta:
type: object
description: >-
Métadonnées de statut de transaction — même
forme que getTransaction, y compris err,
fee, preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages, et
computeUnitsConsumed.
blockTime:
oneOf:
- type: integer
description: >-
Heure de production estimée en tant que
timestamp Unix
- type: 'null'
description: >-
Heure de production estimée en tant que
timestamp Unix (secondes depuis l'époque),
ou null si non disponible.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: >-
Jeton pour récupérer la page suivante des
résultats
- type: 'null'
description: >-
Jeton de pagination pour la page suivante, ou null
s'il n'y a plus de résultats.
example: '1055:5'
examples:
signaturesResponse:
summary: Réponse avec détails de signature uniquement
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: Réponse avec détails complets de transaction
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: >-
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: Invalid params
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: Unauthorized
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: Too many requests
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: Internal error
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 unavailable
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: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenTransferFilter:
type: object
description: >-
Affiner les résultats aux transactions où l'adresse interrogée a
participé à un transfert de jeton correspondant à des critères
spécifiques. Tous les champs sont optionnels et combinés avec une
sémantique ET.
properties:
with:
type: string
description: >-
Adresse du contrepartie. Correspond aux transferts dont l'autre
partie est cette adresse.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
direction:
type: string
description: Direction du transfert par rapport à l'adresse interrogée.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: Sélectionner un mint pour filtrer.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
$ref: '#/components/schemas/TokenTransferAmountFilter'
description: >-
Comparaison de montant en utilisant le montant brut sur la chaîne,
pas le montant ajusté décimal ou UI.
additionalProperties: false
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'
TokenTransferAmountFilter:
type: object
description: >-
Filtre de plage de montant brut sur la chaîne. Tous les champs sont
optionnels et peuvent être combinés.
properties:
gt:
type: number
description: Strictement supérieur à.
example: 1000000
gte:
type: number
description: Supérieur ou égal à.
example: 1000000
lt:
type: number
description: Strictement inférieur à.
example: 5000000
lte:
type: number
description: Inférieur ou égal à.
example: 5000000
additionalProperties: false
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Votre clé API Helius. Vous pouvez en obtenir une gratuitement sur le
[tableau de bord](https://dashboard.helius.dev/api-keys).
````