> ## 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.

# Vue d'ensemble de l'API Wallet (Beta)

> Interrogez les données des portefeuilles Solana avec l'API Wallet. Obtenez soldes, historique des transactions, transferts, informations d'identité et sources de financement en une seule requête.

<Note>
  L'API Wallet est en version Beta. Les points de terminaison et les formats de réponse peuvent changer.
</Note>

## 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 ?

<CardGroup cols={2}>
  <Card title="Un appel REST unique" icon="bolt">
    Soldes, historique et transferts structurés sans assembler les réponses RPC brutes.
  </Card>

  <Card title="Prix en USD intégré" icon="dollar-sign">
    Les soldes de tokens incluent les valeurs en USD et les totaux de portefeuille, provenant de DAS.
  </Card>

  <Card title="Résolution d'identité" icon="address-card">
    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.
  </Card>

  <Card title="Sortie lisible par l'homme" icon="book-open">
    Données claires et ajustées décimalement au lieu de lamports bruts et d'instructions.
  </Card>
</CardGroup>

## Points de terminaison clés

<CardGroup cols={2}>
  <Card title="Identité du portefeuille" icon="address-card" href="/docs/fr/wallet-api/identity">
    Identifiez les portefeuilles connus par adresse ou domaine SNS/ANS — échanges, protocoles, institutions.
  </Card>

  <Card title="Soldes du portefeuille" icon="scale-balanced" href="/docs/fr/wallet-api/balances">
    Tous les soldes de tokens et NFT avec valeurs en USD, logos et métadonnées.
  </Card>

  <Card title="Solde historique" icon="clock" href="/docs/fr/wallet-api/balance-at">
    Un solde de token ou de SOL à une date, heure ou slot passée.
  </Card>

  <Card title="Historique du portefeuille" icon="clock-rotate-left" href="/docs/fr/wallet-api/history">
    Historique complet des transactions avec changements de solde pour chaque transaction.
  </Card>

  <Card title="Transferts de tokens" icon="arrow-right-arrow-left" href="/docs/fr/wallet-api/transfers">
    Tous les transferts entrants et sortants avec infos expéditeur/destinataire.
  </Card>

  <Card title="Source de financement" icon="money-bill-transfer" href="/docs/fr/wallet-api/funded-by">
    La source de financement initiale d'un portefeuille, retracée jusqu'à sa première entrée SOL.
  </Card>
</CardGroup>

## Quel point de terminaison devrais-je utiliser ?

| Vous avez besoin                                        | Utilisez ceci                                     | Renvoie                                                          |
| ------------------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------------- |
| Qui est un portefeuille (échange, protocole, étiquette) | [Identité](/docs/fr/wallet-api/identity)               | Nom, catégorie et étiquettes pour les adresses connues           |
| Le portefeuille actuel d'un portefeuille                | [Soldes](/docs/fr/wallet-api/balances)                 | Tous les tokens et NFTs avec valeurs en USD                      |
| Un solde à un moment passé                              | [Solde historique](/docs/fr/wallet-api/balance-at)     | Un solde de token ou de SOL à une date/heure/slot                |
| Activité transactionnelle complète                      | [Historique](/docs/fr/wallet-api/history)              | Transactions analysées avec changements de solde par transaction |
| Uniquement transferts envoyés/reçus                     | [Transferts](/docs/fr/wallet-api/transfers)            | Vue à niveau de transfert avec contrepartie et direction         |
| Origine des fonds d'un portefeuille                     | [Source de financement](/docs/fr/wallet-api/funded-by) | Premier transfert entrant de SOL et son expéditeur               |

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 :

<Tabs>
  <Tab title="Paramètre de requête">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="En-tête">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances" \
      -H "X-Api-Key: YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## 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.

| Point de terminaison                 | Mode Gratuit                     |
| ------------------------------------ | -------------------------------- |
| `GET /v1/wallet/{wallet}/identity`   | `403` — uniquement plans payants |
| `POST /v1/wallet/batch-identity`     | `403` — uniquement plans payants |
| `GET /v1/wallet/{wallet}/funded-by`  | `403` — uniquement plans payants |
| `GET /v1/wallet/{wallet}/balances`   | Disponible                       |
| `GET /v1/wallet/{wallet}/balance-at` | Disponible                       |
| `GET /v1/wallet/{wallet}/history`    | Disponible                       |
| `GET /v1/wallet/{wallet}/transfers`  | Disponible                       |

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](https://dashboard.helius.dev).

## 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`

| Point de terminaison              | `amount` lisible par l'homme      | Chaîne `amountRaw` brute |
| --------------------------------- | --------------------------------- | ------------------------ |
| **Soldes**                        | Champ `balance`                   | Non disponible           |
| **Balance-at**                    | Champ `balance` (chaîne décimale) | Champ `balanceRaw`       |
| **Funded-by**                     | Champ `amount`                    | Champ `amountRaw`        |
| **Transfers**                     | Champ `amount`                    | Champ `amountRaw`        |
| **Historique** (`balanceChanges`) | Champ `amount`                    | Non disponible           |

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

<Steps>
  <Step title="Obtenez votre clé API">
    Inscrivez-vous sur [dashboard.helius.dev](https://dashboard.helius.dev) pour obtenir votre clé API.
  </Step>

  <Step title="Choisissez votre point de terminaison">
    Utilisez le tableau ci-dessus pour choisir le point de terminaison correspondant à votre cas d'utilisation.
  </Step>

  <Step title="Faites votre première requête">
    Commencez par une requête de solde simple :

    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
    ```
  </Step>

  <Step title="Gérez la réponse">
    Analysez la réponse JSON et affichez les données dans votre application.
  </Step>
</Steps>

## Prochaines étapes

<CardGroup cols={3}>
  <Card title="Obtenir des données" icon="database" href="/docs/fr/getting-data">
    Explorez toutes les façons d'interroger les données Solana sur Helius.
  </Card>

  <Card title="Référence API" icon="code" href="/docs/fr/api-reference/wallet-api">
    Schémas de requête et de réponse pour tous les points de terminaison de l'API Wallet.
  </Card>

  <Card title="Contacter le support" icon="headset" href="/docs/fr/support/contact-support">
    Obtenez de l'aide via Discord, chat ou email.
  </Card>
</CardGroup>