
En bref
L’API Swap de Blockradar vous permet d’échanger des actifs sur la même chaîne (swap) ou de déplacer des actifs entre différentes chaînes (bridge) en utilisant un seul endpoint unifié.
L’API Swap de Blockradar vous permet d’échanger des actifs sur la même chaîne (swap) ou de déplacer des actifs entre différentes chaînes (bridge) en utilisant un seul endpoint unifié.
Prérequis
Avant d’utiliser l’API Swap, assurez-vous d’avoir :1
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar. Naviguez vers Paramètres → Clés API pour en générer une.
2
Wallet Créé
Créez un wallet via l’API Créer Wallet ou le tableau de bord. Vous aurez besoin du
walletId pour les opérations de swap.3
IDs d'Actifs
Obtenez l’
assetId pour vos actifs source et destination depuis Actifs dans le tableau de bord ou via l’API Obtenir Actifs.4
Solde Suffisant
Assurez-vous que votre wallet a un solde suffisant de l’actif source pour couvrir le montant du swap plus les frais de réseau.
Comment Ça Marche
Blockradar détermine automatiquement si votre transaction est un swap ou un bridge en fonction de votre sélection d’actifs :Swap
Échangez différents actifs sur la même blockchain.Exemple : USDC → USDT sur Base
Bridge
Déplacez des actifs entre différentes blockchains.Exemple : USDC sur BSC → USDC sur Optimism
Actifs et Chaînes Supportés
L’API Swap supporte les principales stablecoins sur les chaînes supportées par Blockradar :| Stablecoin | Description |
|---|---|
| USDT | Tether USD |
| USDC | USD Coin |
| DAI | Dai Stablecoin |
| BUSD | Binance USD |
| cNGN | Stablecoin Naira |
| EURC | Euro Coin |
| IDRX | Stablecoin Indonésien |
Voir Intégrations pour la liste complète des réseaux et stablecoins supportés.
Master Wallet vs Adresse Enfant
L’API Swap est disponible à deux niveaux :Master Wallet
Exécutez des swaps directement depuis votre master wallet. Idéal pour les opérations de trésorerie.
Adresse Enfant
Exécutez des swaps depuis des adresses enfants individuelles. Parfait pour les opérations spécifiques aux utilisateurs.
Endpoints
| Opération | Master Wallet | Adresse Enfant |
|---|---|---|
| Obtenir Devis | POST /v1/wallets/{walletId}/swaps/quote | POST /v1/wallets/{walletId}/addresses/{addressId}/swaps/quote |
| Exécuter | POST /v1/wallets/{walletId}/swaps/execute | POST /v1/wallets/{walletId}/addresses/{addressId}/swaps/execute |
Étape 1 : Obtenir un Devis
Obtenez toujours un devis avant d’exécuter un swap pour montrer aux utilisateurs le résultat attendu.Paramètres de Requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
fromAssetId | string | Oui | L’ID de l’actif à échanger |
toAssetId | string | Oui | L’ID de l’actif vers lequel échanger |
amount | string | Oui | Le montant à échanger |
order | string | Non | Préférence de devis : FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE |
recipientAddress | string | Non | Adresse de wallet externe (pour envoyer vers des wallets non-Blockradar) |
Exemple de Devis
Réponse de Devis
Comprendre les Champs du Devis
| Champ | Description |
|---|---|
amount | Montant estimé que vous recevrez après le swap |
minAmount | Montant minimum garanti (tenant compte du glissement) |
rate | Taux de change effectif (montantDestination / montantSource) |
impact | Pourcentage d’impact sur le prix |
slippage | Pourcentage maximum autorisé de mouvement de prix |
networkFee | Frais de gas en unités du token natif |
networkFeeInUSD | Frais de gas convertis en USD |
estimatedArrivalTime | Temps de finalisation estimé en secondes |
Étape 2 : Exécuter le Swap
Une fois que l’utilisateur confirme le devis, exécutez le swap.Paramètres de Requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
fromAssetId | string | Oui | L’ID de l’actif à échanger |
toAssetId | string | Oui | L’ID de l’actif vers lequel échanger |
amount | string | Oui | Le montant à échanger |
order | string | Non | Préférence de devis : FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE |
recipientAddress | string | Non | Adresse de wallet externe (pour envoyer vers des wallets non-Blockradar) |
reference | string | Non | Votre ID de suivi interne |
metadata | object | Non | Données personnalisées transmises via webhooks |
Exemple d’Exécution
Réponse d’Exécution
Types d’Ordre
Choisissez le bon type d’ordre selon votre cas d’utilisation :| Type d’Ordre | Description | Idéal Pour |
|---|---|---|
FASTEST | Priorise la vitesse sur le coût | Transactions sensibles au temps |
CHEAPEST | Minimise les frais | Opérations sensibles au coût |
RECOMMENDED | Approche équilibrée (par défaut) | La plupart des cas d’utilisation |
NO_SLIPPAGE | Montant exact ou échec | Exigences de montant précis |
Événements Webhook
Surveillez la finalisation du swap via les webhooks :| Événement | Description |
|---|---|
swap.success | Swap complété avec succès |
swap.failed | Swap échoué |
Payload du Webhook
Exemple de Flux Complet
Voici une implémentation complète montrant le flux devis → confirmer → exécuter :Réponses d’Erreur
Solde Insuffisant
Solde Insuffisant
ID d'Actif Invalide
ID d'Actif Invalide
Route de Swap Non Disponible
Route de Swap Non Disponible
Montant Trop Bas
Montant Trop Bas
Glissement Dépassé
Glissement Dépassé
Meilleures Pratiques
Expérience Utilisateur
- Toujours afficher les devis : Montrez le montant, les frais et le temps estimé avant l’exécution
- Gérer le glissement : Informez les utilisateurs des variations de prix potentielles
- Afficher la progression : Utilisez les webhooks pour mettre à jour les utilisateurs sur le statut du swap
Sécurité
- Valider les montants : Assurez-vous que les montants de swap sont dans des plages acceptables
- Utiliser des références : Suivez les swaps avec des IDs de référence uniques
- Surveiller les webhooks : Vérifiez toujours la finalisation du swap via les webhooks
Performance
- Mettre en cache les IDs d’actifs : Stockez les IDs d’actifs localement pour éviter les recherches répétées
- Utiliser les types d’ordre appropriés : Choisissez
FASTESTpour le temps sensible,CHEAPESTpour le coût sensible - Implémenter les réessais : Gérez les échecs transitoires avec un backoff exponentiel
Référence API
| Endpoint | Description |
|---|---|
| Master Wallet Obtenir Devis | Obtenir un devis de swap depuis le master wallet |
| Master Wallet Exécuter | Exécuter un swap depuis le master wallet |
| Adresse Enfant Obtenir Devis | Obtenir un devis de swap depuis une adresse enfant |
| Adresse Enfant Exécuter | Exécuter un swap depuis une adresse enfant |
Support
- Email : [email protected]
- Documentation : Référence API
- Blog : Comment Échanger ou Ponter des Actifs avec Blockradar
L’API Swap fournit une interface unifiée pour les swaps sur la même chaîne et les bridges entre chaînes. Commencez avec de petits montants de test sur les testnets avant de passer en production.

