> ## Documentation Index
> Fetch the complete documentation index at: https://docs.afkcrypto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> Votre premier appel à l'API AFK Crypto

## Démarrez en 4 étapes

Créez un compte, activez l'automatisation, créez une clé API et effectuez votre première requête.

### Étape 1 : Connexion

<AccordionGroup>
  <Accordion icon="user" title="Connectez-vous à votre compte">
    Connectez-vous sur <a href="https://app.afkcrypto.com">app.afkcrypto.com</a>.
  </Accordion>
</AccordionGroup>

### Étape 2 : Activer l'automatisation (Portefeuilles)

<AccordionGroup>
  <Accordion icon="toggle-on" title="Autoriser AFK à signer pour vous (sans garde)">
    Sur la page <a href="https://app.afkcrypto.com/wallets">Wallets</a>, activez Automation pour votre adresse. Cela permet à AFK de signer des transactions pour des flux automatisés via une signature non dépositaire basée sur des sessions. Vous pouvez révoquer à tout moment.
  </Accordion>
</AccordionGroup>

### Étape 3 : Créer une clé API (automatisation de portefeuille)

<AccordionGroup>
  <Accordion icon="key" title="Créer une clé API">
    Dans le tableau de bord <a href="https://app.afkcrypto.com/api-keys">API Keys</a>, créez une clé pour l'automatisation des portefeuilles.

    * En-tête : `x-api-key: afk_<prefix>_<random>`
    * Gardez-la secrète ; faites une rotation si compromise

    Voir <a href="/api-reference/authentication/">Authentification</a> pour plus de détails.
  </Accordion>
</AccordionGroup>

### Étape 4 : Effectuer des appels API

<AccordionGroup>
  <Accordion icon="list" title="Lister les portefeuilles">
    Définissez votre clé API dans une variable d'environnement pour la réutiliser :

    ```bash theme={null}
    export AFK_API_KEY="afk_abcd_xxx"
    ```

    ```bash theme={null}
    curl -s -H "x-api-key: $AFK_API_KEY" \
      "https://api.afkcrypto.com/v1/wallets?chain=ethereum"
    ```

    ```json theme={null}
    {
      "wallets": [
        {
          "address": "0xabc...",
          "chainType": "ethereum",
          "isDefault": true,
          "automationEnabled": true,
          "providerType": "embedded",
          "clientType": "privy"
        }
      ]
    }
    ```
  </Accordion>

  <Accordion icon="paper-plane" title="Envoyer un actif (idempotence)">
    Indiquez `Idempotency-Key: <uuid>` pour tous les endpoints d'écriture.

    ```bash theme={null}
    curl -s -X POST https://api.afkcrypto.com/v1/send \
      -H "x-api-key: $AFK_API_KEY" -H "Idempotency-Key: $(uuidgen)" \
      -H "Content-Type: application/json" \
      -d '{
        "chain":"base-sepolia",
        "asset":"erc20",
        "token":"0xToken",
        "to":"0xRecipient",
        "amount":"1000000000000000000"
      }'
    ```

    ```json theme={null}
    { "id": "tx_...", "status": "SUBMITTED", "hash": "0x...", "explorerUrl": "https://basescan.org/tx/0x...", "chainName": "Base" }
    ```
  </Accordion>

  <Accordion icon="bolt" title="Interagir avec des contrats (EVM)">
    ```bash theme={null}
    curl -s -X POST https://api.afkcrypto.com/v1/contracts/send \
      -H "x-api-key: $AFK_API_KEY" -H "Idempotency-Key: $(uuidgen)" \
      -H "Content-Type: application/json" \
      -d '{
        "chain":"base-sepolia",
        "to":"0xContract",
        "data":"0xabcdef...",
        "value":"0"
      }'
    ```
  </Accordion>

  <Accordion icon="circle-nodes" title="Envoyer un token SPL (Solana)">
    ```bash theme={null}
    curl -s -X POST https://api.afkcrypto.com/v1/send \
      -H "x-api-key: $AFK_API_KEY" -H "Idempotency-Key: $(uuidgen)" \
      -H "Content-Type: application/json" \
      -d '{
        "chain":"solana-devnet",
        "asset":"spl",
        "token":"MintAddress",
        "to":"RecipientOwnerAddress",
        "amount":"1000000"
      }'
    ```
  </Accordion>

  <Accordion icon="receipt" title="Consulter une transaction">
    ```bash theme={null}
    curl -s -H "x-api-key: $AFK_API_KEY" \
      "https://api.afkcrypto.com/v1/tx/tx_cuid_here"
    ```

    ```json theme={null}
    {
      "id":"tx_cuid_here",
      "status":"PENDING",
      "hash": null,
      "explorerUrl": null,
      "chainName":"Base",
      "chainType":"ethereum",
      "chainId":8453,
      "to":"0xrecipient...",
      "value":"1000000000000000",
      "error": null,
      "createdAt":"2025-08-25T08:00:00.000Z",
      "updatedAt":"2025-08-25T08:00:00.000Z"
    }
    ```
  </Accordion>
</AccordionGroup>

## Prochaines étapes

Découvrez les endpoints principaux :

<CardGroup cols={2}>
  <Card title="Envoyer un actif" icon="paper-plane" href="/api-reference/endpoint/send/">
    Transférer des actifs natifs et des tokens.
  </Card>

  <Card title="Approuver des tokens" icon="key" href="/api-reference/endpoint/token-approve/">
    Approuver les allocations ERC20.
  </Card>

  <Card title="Échanger" icon="right-left" href="/api-reference/endpoint/trade-quote/">
    Demander des cotations et exécuter des swaps.
  </Card>

  <Card title="Référence API" icon="code" href="/api-reference/introduction/">
    Explorer les endpoints et conventions.
  </Card>
</CardGroup>

<Note>
  **Besoin d'aide ?** Écrivez à <a href="mailto:hello@afkcrypto.com">[hello@afkcrypto.com](mailto:hello@afkcrypto.com)</a> ou contactez-nous sur <a href="https://twitter.com/afkcryptoai">Twitter</a>.
</Note>
