Skip to main content
POST
getTransfersByAddress

Aperçu

getTransfersByAddress retourne des objets de transfert analysés et lisibles pour le mouvement de tokens et de SOL natif impliquant une adresse de portefeuille. Utilisez des filtres pour affiner les résultats par mint, heure de bloc, montant, créneau, direction ou contrepartie. La réponse est conçue pour des vues précises de l’activité du portefeuille, le suivi des paiements et la réconciliation des soldes sans réimplémenter l’analyse des transferts Solana.
Les transferts de mint et de burn sont unilatéraux. Les mints ont fromUserAccount: null et ne peuvent être retournés que comme transferts entrants pour le destinataire. Les burns ont toUserAccount: null et ne peuvent être retournés que comme transferts sortants pour le propriétaire brulant.

Paramètres de la requête

string
requis
Adresse de portefeuille propriétaire encodée en Base58 pour interroger les transferts. Passez l’adresse du propriétaire du portefeuille, pas un compte de token associé (ATA).
string
Filtrer par adresse contrepartie. Retourne uniquement les transferts vers ou depuis cette adresse.
string
défaut:"any"
Filtrer par direction de transfert par rapport à l’adresse interrogée.
  • in
  • out
  • any
string
Adresse de mint de token. Utilisez So11111111111111111111111111111111111111111 pour le SOL natif et So11111111111111111111111111111111111111112 pour le WSOL.
string
défaut:"merged"
Mode d’affichage SOL/WSOL. merged traite le WSOL comme le SOL natif et exclut les lignes d’enveloppement/déballage pour que l’historique en SOL soit plus facile à réconcilier; separate préserve le WSOL comme un mint de token SPL distinct et inclut les lignes d’enveloppement/déballage.
  • merged
  • separate
object
Filtres supplémentaires pour le montant, le temps de bloc, et le créneau.
object
Filtre de comparaison de plage. Tous les champs sont optionnels et peuvent être combinés.
number
Supérieur à.
number
Supérieur ou égal.
number
Inférieur à.
number
Inférieur ou égal.
object
Filtre de comparaison de plage. Tous les champs sont optionnels et peuvent être combinés.
number
Supérieur à.
number
Supérieur ou égal.
number
Inférieur à.
number
Inférieur ou égal.
object
Filtre de comparaison de plage. Tous les champs sont optionnels et peuvent être combinés.
number
Supérieur à.
number
Supérieur ou égal.
number
Inférieur à.
number
Inférieur ou égal.
number
défaut:"100"
Nombre maximum de transferts à retourner. Plage de 1 à 100.
string
Curseur de la réponse précédente pour la pagination.
string
défaut:"finalized"
Niveau d’engagement des données.
  • finalized
  • confirmed
number
Créneau de contexte minimum à utiliser pour la requête (optionnel).
string
défaut:"desc"
Ordre des résultats.
  • asc
  • desc

Autorisations

api-key
string
query
requis

Votre clé API Helius. Vous pouvez en obtenir une gratuitement sur le tableau de bord.

Corps

application/json
jsonrpc
enum<string>
défaut:2.0
requis

La version du protocole JSON-RPC.

Options disponibles:
2.0
Exemple:

"2.0"

id
string
défaut:1
requis

Un identifiant unique pour la requête.

Exemple:

"1"

method
enum<string>
défaut:getTransfersByAddress
requis

Le nom de la méthode RPC à invoquer.

Options disponibles:
getTransfersByAddress
Exemple:

"getTransfersByAddress"

params
(string | object)[]
requis

Tableau contenant l'adresse de portefeuille requise et l'objet de configuration optionnel.

Required array length: 1 - 2 elements

Adresse de portefeuille du propriétaire encodée en Base58 pour interroger les transferts. Passez l'adresse du propriétaire du portefeuille, pas un compte associé (ATA).

Exemple:

"86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"

Réponse

Transferts récupérés avec succès pour l'adresse spécifiée.

jsonrpc
enum<string>

La version du protocole JSON-RPC.

Options disponibles:
2.0
Exemple:

"2.0"

id
string

Identifiant correspondant à la requête.

Exemple:

"1"

result
object

Données de transfert et informations de pagination.