Skip to main content
L’API Wallet est en version Beta. Les points de terminaison et les formats de réponse peuvent changer.

​
Qu’est-ce que l’API Wallet ?

L’API Wallet fournit des points de terminaison REST de haut niveau pour interroger les données complètes des portefeuilles Solana — soldes, historique des transactions, transferts de tokens, résolution d’identité, soldes historiques et sources de financement. Au lieu de faire plusieurs appels RPC et d’analyser les données brutes de la blockchain, vous obtenez des informations structurées et lisibles avec des prix en USD en une seule requête. Elle est conçue pour les portefeuilles, les trackers de portefeuille, les explorateurs, les processeurs de paiement, les outils fiscaux et les systèmes de conformité et de LBC. Tous les points de terminaison partagent l’URL de base https://api.helius.xyz et retournent des montants en unités lisibles (pas besoin de conversion en lamports).

​
Pourquoi Helius pour les données de portefeuille ?

Un appel REST unique

Soldes, historique et transferts structurés sans assembler les réponses RPC brutes.

Prix en USD intégré

Les soldes de tokens incluent les valeurs en USD et les totaux de portefeuille, provenant de DAS.

Résolution d'identité

Plus de 32 500 comptes et programmes étiquetés ainsi que plus de 21,5 millions d’étiquettes catégorielles pour les échanges, protocoles et institutions.

Sortie lisible par l'homme

Données claires et ajustées décimalement au lieu de lamports bruts et d’instructions.

​
Points de terminaison clés

Identité du portefeuille

Identifiez les portefeuilles connus par adresse ou domaine SNS/ANS — échanges, protocoles, institutions.

Soldes du portefeuille

Tous les soldes de tokens et NFT avec valeurs en USD, logos et métadonnées.

Solde historique

Un solde de token ou de SOL à une date, heure ou slot passée.

Historique du portefeuille

Historique complet des transactions avec changements de solde pour chaque transaction.

Transferts de tokens

Tous les transferts entrants et sortants avec infos expéditeur/destinataire.

Source de financement

La source de financement initiale d’un portefeuille, retracée jusqu’à sa première entrée SOL.

​
Quel point de terminaison devrais-je utiliser ?

Référence rapide des routes sous-jacentes (URL de base https://api.helius.xyz):
  • GET /v1/wallet/{wallet}/identity — obtenir l’identité du portefeuille par adresse ou domaine SNS/ANS
  • POST /v1/wallet/batch-identity — recherche d’identité par lot (jusqu’à 100 adresses et/ou domaines)
  • GET /v1/wallet/{wallet}/balances — obtenir tous les soldes de tokens et NFT
  • GET /v1/wallet/{wallet}/balance-at — obtenir un solde de token ou de SOL à une date, heure ou slot passée
  • GET /v1/wallet/{wallet}/history — obtenir l’historique des transactions avec changements de solde
  • GET /v1/wallet/{wallet}/transfers — obtenir toute l’activité de transfert de tokens
  • GET /v1/wallet/{wallet}/funded-by — trouver la source de financement initiale

​
Authentification

Toutes les requêtes API Wallet nécessitent une clé API. Vous pouvez la transmettre en tant que paramètre de requête ou en tant qu’en-tête :

​
Exigences du plan

Les points de terminaison d’identité et de source de financement nécessitent un plan payant. En mode Gratuit, les requêtes vers ces points de terminaison renvoient 403 Forbidden. Tous les autres points de terminaison sont ouverts sur tous les plans, y compris le mode Gratuit. Tout niveau payant débloque les points de terminaison restreints — Développeur, Entreprise, et tout niveau supérieur (tel qu’Entreprise). Pour activer les recherches d’identité et de source de financement, mettez à niveau votre plan sur le tableau de bord.

​
Montants et unités

L’API Wallet est une abstraction de haut niveau sur les données brutes de Solana. Tous les champs amount dans les réponses sont lisibles par l’homme — déjà divisés par le démembrement de l’decimals du token — de sorte que vous pouvez les afficher directement sans aucune conversion. Les appels RPC bruts de Solana renvoient des valeurs en lamports (la plus petite unité, 10⁻⁹ SOL) ; l’API Wallet ne le fait pas. "amount": 1.5 signifie 1,5 SOL, pas 1,5 lamports. Là où une arithmétique exacte est requise, certains points de terminaison exposent également amountRaw: la même valeur sous forme d’entier brut sérialisé en chaîne de caractères pour éviter les pertes de précision en virgule flottante. La formule de conversion est : amount = parseInt(amountRaw) / 10**decimals Utilisez amount pour l’affichage. Utilisez amountRaw lors de la transmission de valeurs aux instructions sur la chaîne ou à d’autres systèmes nécessitant une arithmétique entière exacte.

​
Commencez

1

Obtenez votre clé API

Inscrivez-vous sur dashboard.helius.dev pour obtenir votre clé API.
2

Choisissez votre point de terminaison

Utilisez le tableau ci-dessus pour choisir le point de terminaison correspondant à votre cas d’utilisation.
3

Faites votre première requête

Commencez par une requête de solde simple :
4

Gérez la réponse

Analysez la réponse JSON et affichez les données dans votre application.

​
Prochaines étapes

Obtenir des données

Explorez toutes les façons d’interroger les données Solana sur Helius.

Référence API

Schémas de requête et de réponse pour tous les points de terminaison de l’API Wallet.

Contacter le support

Obtenez de l’aide via Discord, chat ou email.