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

# Service d'Échanges Cryptographiques

> Spécification pour Service d'Échanges Cryptographiques

# Service d'Échanges Cryptographiques

::: info
Cette spécification est maintenue dans `docs/specifications/` et associée à des tests automatisés.
:::

Cette spécification couvre les fonctionnalités du service d'échanges cryptographiques.

## Initialisation et Configuration

* Le service peut se connecter à plusieurs plateformes d'échange (Binance, FTX, etc.)
* Les identifiants d'API sont stockés de manière sécurisée
* Le service vérifie la validité des identifiants lors de l'initialisation

## Opérations de Marché

* Le service peut créer des ordres d'achat et de vente au marché
* Le service peut créer des ordres limites
* Le service peut annuler des ordres existants
* Les montants et prix sont formatés selon la précision exigée par chaque échange

## Récupération d'Informations

* Le service peut récupérer les balances pour chaque devise
* Le service peut récupérer l'historique des prix (OHLCV)
* Le service peut récupérer les informations sur les paires de trading
* Le service peut récupérer l'état des ordres passés

## Gestion des Erreurs

* Le service gère les erreurs de connexion aux API
* Le service gère les erreurs liées aux limites de taux (rate limits)
* Le service gère les erreurs d'insuffisance de fonds
* Les erreurs sont journalisées avec des informations de contexte suffisantes

## Performance et Optimisation

* Le service utilise un système de mise en cache pour réduire les appels API
* Les informations de marché sont mises en cache pour la durée appropriée
* Les opérations en masse sont optimisées pour minimiser les appels API

{/* Ne pas modifier manuellement, ils sont mis à jour automatiquement après chaque commit */}

## 📊 Statut des Tests

### Tests Frontend (Checkly)

[![checkly-frontend no-tests](https://img.shields.io/badge/checkly--frontend-no--tests-lightgrey)](https://app.checklyhq.com/checks)

### Tests Backend (Vitest)

[![vitest-backend passing](https://img.shields.io/badge/vitest--backend-passing-brightgreen)](https://docs.poihunter.com/docs/reports/vitest/specs/exchanges-exchanges_service.json)

***

Ce document est lié notamment au test suivant :

* `packages/functions/src/tests/exchanges/exchange-clients-load-markets.test.ts`\
  Valide que **tous les clients d'exchange configurés en base** peuvent charger correctement leurs marchés (`loadMarkets`), ce qui garantit que les identifiants et la connectivité sont fonctionnels (Binance, Kucoin, Kucoinfutures, MEXC, etc.).