# API Bifrost Crypto

> Version Markdown de la documentation publique de l'API v1 de Bifrost Crypto, pour les agents d'IA et les générateurs de code. Même contenu que les pages HTML, généré à partir de la même source, sans navigation ni mise en forme.
>
> Version HTML: https://bifrostcrypto.com/fr/docs
> Fichiers liés: [ai.md](https://bifrostcrypto.com/ai/fr.md) · [Postman](https://bifrostcrypto.com/postman-collection.json) · [OpenAPI](https://bifrostcrypto.com/openapi.json) · [llms.txt](https://bifrostcrypto.com/llms.txt)
> Autres langues: [Português](https://bifrostcrypto.com/ai/pt-BR/introduction.md) · [English](https://bifrostcrypto.com/ai/en/introduction.md) · [Español](https://bifrostcrypto.com/ai/es/introduction.md)
> API v1 · dernière modification du contrat le 2026-10-10

Référence complète pour l'API Bifrost Crypto V1. Intégrez des paiements crypto multi-chaîne dans votre plateforme en minutes.

## Authentification

Toutes les routes nécessitent l'en-tête avec votre clé API privée : `X-Bifrost-Invoke`

## URL de Base

Toutes les requêtes sont effectuées vers : `https://bridge.bifrostcrypto.com`

## Format

Tous les corps de requête et de réponse utilisent le format JSON : `Content-Type: application/json`

## Démarrage Rapide

Chaque requête API doit inclure votre clé privée dans l'en-tête :

```bash
curl -X GET "https://bridge.bifrostcrypto.com/v1/balances" \
  -H "X-Bifrost-Invoke: YOUR_API_KEY"
```

## Spécification OpenAPI

Toute la référence dans un fichier OpenAPI 3.1. Importez-le dans Postman ou Insomnia pour essayer les endpoints, ou générez un client dans votre langage. Il est construit à partir de la même source que cette documentation.

https://bifrostcrypto.com/openapi.json

## Dates et heures

Les champs de date et heure (created_at, updated_at, expires_at et les autres) sont au format YYYY-MM-DD HH:MM:SS en UTC−03:00, sans le décalage dans la valeur. Les filtres de date (date_from, date_to) sont lus avec le même décalage. Deux exceptions : la limite quotidienne de payout d'une clé d'API repart à 00:00 UTC, et les webhooks d'adresse fixe envoient timestamp en ISO 8601 avec le décalage inclus.

## Réseaux Pris en Charge

Valeurs acceptées dans le champ network, sans tenir compte de la casse à la création. À la création, des alias courants sont aussi acceptés (erc20, bsc, trc20, matic…) et convertis vers ces noms ; voir Network aliases sur les endpoints de création. Les réponses, webhooks et filtres de liste utilisent toujours les noms ci-dessous. Les tokens disponibles sur chaque réseau sont indiqués par GET /v1/summary/tokens.

`Bitcoin`, `Ethereum`, `BinanceSmartChain`, `Tron`, `Solana`, `Ripple`, `Cardano`, `Dogecoin`, `Polygon`, `Avalanche`, `ArbitrumOne`, `Celo`, `Optimism`, `Arbitrum`, `Cronos`, `Base`, `BitcoinCash`, `BitcoinSV`, `BitcoinGold`, `Monero`, `OpBnb`, `Xlayer`, `Litecoin`, `TON`

## Codes de Statut HTTP

| Code | Signification |
| --- | --- |
| `200` | Succès |
| `201` | Créé - adresse fixe attribuée |
| `207` | Multi-Status - lot de payout avec des éléments refusés |
| `400` | Requête Invalide - paramètres invalides |
| `401` | Non Autorisé - clé API ou signature absente ou invalide |
| `403` | Interdit - aucune permission sur cette ressource |
| `404` | Non Trouvé - ressource ou route inexistante |
| `409` | Conflit - requête encore en cours ou limite atteinte |
| `422` | Non Traitable - type non pris en charge |
| `429` | Trop de Requêtes - quota ou limite d'échecs d'authentification |
| `500` | Erreur Serveur |
| `502` | Bad Gateway - un service dont nous dépendons a échoué. Réessayez plus tard. |
| `503` | Service Indisponible - réessayez plus tard |

## Catégories d'API

- **Paiements (Payout)** (3 endpoints): Créez et gérez les retraits crypto. Jusqu'à 50 par lot.
- **Dépôts (Payin)** (3 endpoints): Générez des portefeuilles de dépôt et suivez les paiements entrants.
- **Requêtes** (6 endpoints): Vérifiez les soldes, les relevés, les tokens et les informations de compte.
- **Prix** (2 endpoints): Obtenez les taux de conversion en temps réel et les devises disponibles.
- **Adresses Fixes** (5 endpoints): Attribuez et gérez des adresses de dépôt permanentes par client.