> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt > Use this file to discover all available pages before exploring further. # Règlements automatiques > Automatisez les règlements et conversions d'actifs entre réseaux blockchain En résumé
Les Règlements automatiques convertissent automatiquement les dépôts entrants vers l'actif de votre choix sur n'importe quelle blockchain. Définissez les règles une seule fois, et tous les dépôts correspondants sont échangés et acheminés vers votre chaîne de destination — sans aucune intervention manuelle. Règlements automatiques ## Prérequis Avant de configurer des règles de règlement automatique, assurez-vous de disposer des éléments suivants : Obtenez votre clé API depuis le [tableau de bord Blockradar](https://dashboard.blockradar.co). Rendez-vous dans **Developers** pour en générer une. Créez une master wallet via l'[API Create Wallet](/en/api-reference/wallets/create-wallet) ou depuis le tableau de bord. Les règles se configurent par wallet. Si vous effectuez un règlement cross-chain, assurez-vous d'avoir une wallet sur la blockchain de destination pour recevoir les actifs convertis. Approvisionnez vos wallets en tokens natifs (ETH, BNB, MATIC, etc.) pour couvrir les frais de swap et de transfert. Configurez des webhooks pour recevoir les notifications de règlement. Selon l'action, vous recevrez les événements `swap.success`/`swap.failed`, `gateway.success`/`gateway.failed` ou `withdraw.success`/`withdraw.failed`. Consultez [Webhooks](/en/essentials/webhooks) pour plus de détails. ## Fonctionnement Les Règlements automatiques vous permettent de convertir automatiquement les dépôts entrants en n'importe quel actif de destination, sur n'importe quel réseau blockchain, en fonction des règles que vous configurez. Cela évite d'avoir à effectuer manuellement des swaps ou bridges d'actifs et garantit que votre trésorerie peut être convertie automatiquement vers vos actifs préférés sur plusieurs chaînes. Créez et gérez des règles de règlement automatique pour automatiser les conversions d'actifs. Convertissez automatiquement n'importe quel stablecoin vers tout autre actif selon vos règles. Réglez vos actifs sur n'importe quel réseau blockchain de manière transparente. Appliquez des tolérances de slippage et des règles pour vous protéger contre des exécutions défavorables. ## Comment fonctionnent les Règlements automatiques ### **1. Création des règles** Définissez des règles de règlement précisant quand et comment les dépôts doivent être convertis automatiquement. ### **2. Détection des dépôts** Lorsque des fonds arrivent sur vos adresses, Blockradar détecte automatiquement les dépôts correspondant à vos règles. ### **3. Conversion d'actifs** Les dépôts sont automatiquement échangés vers votre actif de destination (typiquement USDC) sur la chaîne choisie. ### **4. Unification des soldes** Tous les actifs convertis sont consolidés en un solde unique et unifié sur votre chaîne de destination. ## Règles de Règlement automatique ### **Composants d'une règle** Chaque règle de règlement automatique définit les paramètres suivants : | Composant | Description | Exemple | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | | **Nom de la règle** | Nom descriptif pour votre règle de règlement | « Swap from USDC to Optimism USDC » | | **Order** | Préférence de priorité d'exécution | FASTEST, CHEAPEST, RECOMMENDED, NO\_SLIPPAGE | | **Tolérance de slippage** | Écart de prix maximal acceptable (%). Utilisez `-1` pour un slippage illimité | 5 ou -1 | | **Actifs sources** | Liste d'actifs à régler automatiquement | \["USDC", "USDT"] | | **Montant min./max. source** | Contrôle la taille du dépôt qui déclenche le règlement | Min : 1 $, Max : 1 000 $ | | **Blockchain de destination** | Réseau blockchain cible | optimism, base, ethereum | | **Actif de destination** | Actif cible pour la conversion | USDC, USDT, cNGN, DAI | | **Adresse de destination** | (Facultatif) Adresse spécifique pour recevoir les actifs convertis. Si elle n'est pas fournie, la logique de fallback intelligente s'applique | 0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22 | | **Is Gateway** | Active la fonctionnalité gateway pour la règle | false | ### **Options de configuration de la règle** #### **Seuils de montant** * **Montant minimum** : Ne régler que les dépôts au-dessus de ce seuil * **Montant maximum** : Plafonner la taille des règlements individuels * **Traitement par lot** : Regrouper plusieurs petits dépôts pour gagner en efficacité #### **Protection contre le slippage** * **Illimité** : `-1` (pas de limite de slippage — comportement par défaut) * **Conservateur** : 0,1 % - 0,5 % (impact minimal sur le prix) * **Modéré** : 0,5 % - 1,0 % (approche équilibrée) * **Agressif** : 1,0 % - 2,0 % (exécution plus rapide) Définir `slippageTolerance` à `-1` signifie une tolérance de slippage illimitée. C'est le comportement par défaut si aucune valeur n'est précisée, ce qui permet d'exécuter les règlements quel que soit l'écart de prix. #### **Adresse de destination (facultative)** Le champ `destination.address` est désormais facultatif. Lorsqu'il n'est pas fourni, le système utilise une logique de fallback intelligente pour déterminer l'adresse destinataire : | Scénario | Comportement de fallback | | ------------------------------------- | ------------------------------------------------------------------ | | **Adresse explicite fournie** | Utilise l'adresse spécifiée | | **Règlement sur la même chaîne** | Utilise l'adresse de dépôt (adresse source) | | **Cross-chain entre EVM** | Utilise la même adresse sur la chaîne de destination | | **Cross-chain (destination non EVM)** | Utilise l'adresse de la master wallet sur la chaîne de destination | Pour la plupart des cas d'usage, vous pouvez omettre l'adresse de destination et laisser le système acheminer automatiquement les fonds vers l'adresse appropriée selon le type de règlement. #### **Préférences d'exécution** * **Fastest** : Privilégie la vitesse au détriment du coût * **Cheapest** : Optimise pour les frais les plus bas * **Recommended** : Équilibre vitesse, coût et fiabilité * **No Slippage** : N'exécute que lorsqu'il n'y a aucun écart de prix ## Hiérarchie et précédence des règles ### **Comment les règles s'appliquent** **Concept clé** : Les règles créées sur une master wallet s'appliquent automatiquement à toutes les child addresses sous cette wallet. Toutefois, si vous créez des règles directement sur une child address, ces règles remplacent entièrement celles de la master wallet pour cette adresse spécifique. | Niveau de la règle | Portée | Comportement | | --------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------- | | **Règles de Master Wallet** | S'appliquent à la master wallet ET à toutes les child addresses | Règles par défaut pour toute la hiérarchie de la wallet | | **Règles de Child Address** | S'appliquent uniquement à cette adresse spécifique | Remplacent entièrement les règles de la master wallet lorsqu'elles existent | ### **Ordre d'application des règles** 1. **Vérifier les règles de Child Address** : Si l'adresse réceptrice possède ses propres règles, utilisez exclusivement celles-ci 2. **Se rabattre sur les règles de la Master Wallet** : S'il n'existe pas de règles de child address, appliquez les règles de la master wallet 3. **Aucune règle** : Si aucun des deux niveaux ne dispose de règles configurées, aucun règlement automatique n'a lieu Lorsqu'une child address possède ses propres règles, les règles de la master wallet sont **complètement ignorées** pour cette adresse — il n'y a ni fusion ni combinaison des règles. ### **Règles spécifiques à une blockchain** **Important** : Les règles sont isolées et liées à chaque blockchain. Une règle configurée pour une blockchain (par exemple Ethereum) n'affectera PAS les dépôts sur une autre blockchain (par exemple Base ou Optimism). Cela signifie que : * Vous devez créer des règles distinctes pour chaque blockchain source à régler automatiquement * Une règle pour « USDC sur Ethereum » ne se déclenchera pas pour « USDC sur Base » * Cela permet un contrôle granulaire du comportement de règlement par chaîne **Exemple** : Si vous souhaitez régler automatiquement les dépôts USDC depuis Ethereum et Base vers Optimism, vous avez besoin de deux règles distinctes : 1. Règle pour Ethereum USDC → Optimism USDC 2. Règle pour Base USDC → Optimism USDC ### **Cas d'usage pour chaque niveau** #### **Règles de Master Wallet** * **Stratégie cohérente** : Même comportement de règlement sur toutes les child addresses * **Gestion simplifiée** : Un seul endroit pour configurer le comportement par défaut * **Opérations en masse** : Appliquer des règles à plusieurs adresses à la fois * **Standardisation** : Garantir conformité et cohérence #### **Règles de Child Address** * **Tests** : Essayer différentes stratégies de règlement sur des adresses spécifiques * **Exigences personnalisées** : Besoins de règlement spécifiques à une adresse * **Surcharger les valeurs par défaut** : Modifier le comportement pour des cas d'usage particuliers * **Contrôle granulaire** : Affiner le règlement pour des adresses spécifiques ## Création de règles de Règlement automatique ### **Via le tableau de bord** 1. Rendez-vous dans la section Auto Settlements de votre wallet 2. Cliquez sur « Create New Rule » 3. Configurez les paramètres de la règle 4. Définissez les seuils de montant et la tolérance de slippage 5. Choisissez les actifs/chaînes source et de destination 6. Enregistrez et activez la règle ### **Via l'API** Créez des règles de règlement de manière programmatique grâce à l'API Auto Settlement Rules : ```bash theme={null} curl --request POST \ --url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \ --header 'Content-Type: application/json' \ --header 'x-api-key: ' \ --data '{ "name": "Swap from USDC to Optimism USDC", "order": "FASTEST", "slippageTolerance": "-1", "source": { "assets": [ "USDC", "USDT" ], "minAmount": "1", "maxAmount": "1000" }, "destination": { "blockchain": "optimism", "asset": "USDC" } }' ``` Dans cet exemple, `slippageTolerance` est défini à `-1` pour un slippage illimité, et `destination.address` est omis. Le système utilisera automatiquement la logique de fallback intelligente pour déterminer l'adresse destinataire. **Avec une adresse de destination explicite :** ```bash theme={null} curl --request POST \ --url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \ --header 'Content-Type: application/json' \ --header 'x-api-key: ' \ --data '{ "name": "Swap from USDC to Optimism USDC", "order": "FASTEST", "slippageTolerance": "5", "source": { "assets": [ "USDC", "USDT" ], "minAmount": "1", "maxAmount": "1000" }, "destination": { "blockchain": "optimism", "asset": "USDC", "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22" } }' ``` ## Cas d'usage ### **Gestion de trésorerie** * **Conversion d'actifs flexible** : Convertissez vers n'importe quel actif préféré (USDC, ETH, USDT, etc.) * **Opérations cross-chain** : Maintenez des soldes sur plusieurs réseaux * **Consolidation automatisée** : Aucune intervention manuelle requise * **Stratégie multi-actifs** : Prend en charge diverses préférences et stratégies d'actifs ### **Opérations métier** * **Traitement des paiements** : Réglez automatiquement les paiements entrants vers les actifs préférés * **Gestion des revenus** : Convertissez diverses stablecoins vers l'actif de destination choisi * **Atténuation des risques** : Appliquez automatiquement la protection contre le slippage * **Diversification d'actifs** : Maintenez automatiquement les allocations d'actifs cibles ### **Intégration DeFi** * **Yield farming** : Réglez automatiquement les récompenses vers l'actif préféré * **Gestion de la liquidité** : Consolidez les récompenses et frais de LP * **Rééquilibrage de portefeuille** : Maintenez les allocations d'actifs cibles ## Bonnes pratiques ### **Configuration des règles** * **Commencez prudemment** : Démarrez avec une faible tolérance de slippage * **Suivez les performances** : Surveillez les taux de succès des règlements * **Ajustez progressivement** : Affinez les règles selon les conditions du marché * **Testez sur testnet** : Validez les règles avant tout déploiement sur mainnet ### **Gestion du risque** * **Limites de slippage** : Définissez des niveaux de tolérance appropriés * **Plafonds de montant** : Limitez la taille maximale des règlements * **Sélection du réseau** : Choisissez des chaînes de destination fiables * **Règles de repli** : Créez des options de règlement de secours ### **Efficacité opérationnelle** * **Traitement par lot** : Regroupez les petits dépôts pour gagner en efficacité * **Optimisation du timing** : Tenez compte des schémas de congestion réseau * **Analyse des coûts** : Équilibrez les préférences vitesse vs. coût * **Surveillance** : Mettez en place des alertes pour les règlements échoués ## Surveillance et alertes ### **Surveillance via le tableau de bord** * **Statut des règles** : Indicateurs de règle active/inactive * **Historique des règlements** : Suivez les règlements réussis et échoués * **Indicateurs de performance** : Taux de succès et temps d'exécution * **Soldes d'actifs** : Surveillez la croissance du solde unifié ### **Notifications par webhook** Les règlements automatiques déclenchent des événements webhook lors de l'exécution : | Événement | Description | | -------------- | ---------------------------------------------------------- | | `swap.success` | Le swap du règlement automatique a été exécuté avec succès | | `swap.failed` | Le swap du règlement automatique n'a pas pu être exécuté | ### **Exemple de payload webhook** ```json theme={null} { "event": "swap.success", "data": { "id": "99a2b490-0798-460b-9265-4d99f182fe52", "reference": "ZMxcorDGtf", "senderAddress": "0xAA2d5fd5e7bE97E214f8565DCf3a4862719960b5", "recipientAddress": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43", "amount": "5", "status": "SUCCESS", "type": "SWAP", "network": "mainnet", "toAmount": "4.965398", "rate": "0.9930796000000001", "asset": { "name": "USD Coin", "symbol": "USDC", "network": "mainnet" }, "toAsset": { "name": "Tether USD", "symbol": "USDT", "network": "mainnet" }, "toBlockchain": { "name": "optimism", "slug": "optimism" }, "toWallet": { "name": "Optimism Mainnet Wallet", "address": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43" }, "metadata": { "swapAutoSettlement": { "rule": { "id": "rule-id-123", "name": "USDT to USDC on Base", "order": "RECOMMENDED", "slippageTolerance": 5, "source": { "assets": ["USDC", "USDT"], "minAmount": "1", "maxAmount": "1000" }, "destination": { "blockchain": "optimism", "asset": "USDC", "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22" } }, "settleAmount": "5" }, "transactionId": "transaction-id" } } } ``` ### **Identifier les transactions de règlement automatique** La meilleure façon d'identifier les transactions de règlement automatique est d'examiner le champ metadata. Selon l'action, le metadata contiendra l'une des clés suivantes : | Clé de metadata | Description | | ------------------------ | ----------------------------------------------------------------------------- | | `swapAutoSettlement` | Présent lorsque le règlement automatique a déclenché une opération de swap | | `gatewayAutoSettlement` | Présent lorsque le règlement automatique a déclenché une opération Gateway | | `withdrawAutoSettlement` | Présent lorsque le règlement automatique a déclenché une opération de retrait | Chaque objet metadata contient : | Champ | Description | | -------------- | -------------------------------------------------------------------------------------- | | `rule` | Payload complet de la règle de règlement automatique ayant déclenché cette transaction | | `settleAmount` | Montant réglé conformément à la règle | Lorsque l'une de ces clés de metadata (`swapAutoSettlement`, `gatewayAutoSettlement` ou `withdrawAutoSettlement`) est présente, la transaction a été déclenchée par une règle de règlement automatique. Le champ `rule` contient la configuration complète de la règle, et non un simple ID. ### **Champs clés des données du webhook** | Champ | Description | | -------------- | ---------------------------------------------------------------------------- | | `toAmount` | Montant final reçu après le swap (en tenant compte des frais et du slippage) | | `rate` | Taux de change utilisé pour le swap | | `toAsset` | Détails de l'actif de destination (USDT dans cet exemple) | | `toBlockchain` | Réseau blockchain de destination (Optimism dans cet exemple) | | `toWallet` | Wallet de destination ayant reçu les actifs convertis | | `assetSwept` | Indique si les actifs d'origine ont été balayés après la conversion | ## Référence de l'API ### **Endpoints** #### **Règlements automatiques de Master Wallet** | Endpoint | Méthode | Description | Référence de l'API | | ---------------------------------------------------- | ------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------- | | `/v1/wallets/{walletId}/auto-settlements/rules` | GET | Lister toutes les règles de règlement de la master wallet | [Get All Rules](/en/api-reference/auto-settlements/master-wallet-get-rules) | | `/v1/wallets/{walletId}/auto-settlements/rules` | POST | Créer une nouvelle règle de règlement pour la master wallet | [Create Rule](/en/api-reference/auto-settlements/master-wallet-create-rule) | | `/v1/wallets/{walletId}/auto-settlements/rules/{id}` | GET | Récupérer les détails d'une règle spécifique de la master wallet | [Get Rule](/en/api-reference/auto-settlements/master-wallet-get-rule) | | `/v1/wallets/{walletId}/auto-settlements/rules/{id}` | PATCH | Mettre à jour une règle existante de la master wallet | [Update Rule](/en/api-reference/auto-settlements/master-wallet-update-rule) | | `/v1/wallets/{walletId}/auto-settlements/rules/{id}` | DELETE | Supprimer une règle de règlement de la master wallet | [Delete Rule](/en/api-reference/auto-settlements/master-wallet-delete-rule) | | `/v1/wallets/{walletId}/auto-settlements` | GET | Récupérer l'historique des règlements de la master wallet | [Get Settlement](/en/api-reference/auto-settlements/master-wallet) | | `/v1/wallets/{walletId}/auto-settlements` | PATCH | Mettre à jour les paramètres de règlement de la master wallet | [Update Settlement](/en/api-reference/auto-settlements/master-wallet-update) | #### **Règlements automatiques de Child Address** | Endpoint | Méthode | Description | Référence de l'API | | -------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------- | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules` | GET | Lister toutes les règles de règlement pour une adresse spécifique | [Get All Rules](/en/api-reference/auto-settlements/child-address-get-rules) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules` | POST | Créer une nouvelle règle de règlement pour une adresse spécifique | [Create Rule](/en/api-reference/auto-settlements/child-address-create-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}` | GET | Récupérer les détails de la règle d'une adresse spécifique | [Get Rule](/en/api-reference/auto-settlements/child-address-get-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}` | PATCH | Mettre à jour une règle d'adresse existante | [Update Rule](/en/api-reference/auto-settlements/child-address-update-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}` | DELETE | Supprimer une règle de règlement d'adresse | [Delete Rule](/en/api-reference/auto-settlements/child-address-delete-rule) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements` | GET | Récupérer l'historique de règlement de l'adresse | [Get Settlement](/en/api-reference/auto-settlements/child-address) | | `/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements` | PATCH | Mettre à jour les paramètres de règlement de l'adresse | [Update Settlement](/en/api-reference/auto-settlements/child-address-update) | ### **Paramètres de la règle** | Paramètre | Type | Requis | Description | | ------------------------ | ------- | ------ | ------------------------------------------------------------------------------------------------- | | `name` | string | Oui | Nom de la règle pour identification | | `order` | string | Oui | Priorité d'exécution (FASTEST/CHEAPEST/RECOMMENDED/NO\_SLIPPAGE) | | `slippageTolerance` | string | Non | Slippage maximal acceptable (%). Utilisez `-1` pour illimité (par défaut) | | `isGateway` | boolean | Non | Active la fonctionnalité gateway pour la règle | | `source.assets` | array | Oui | Liste d'actifs sources à régler automatiquement | | `source.minAmount` | string | Non | Montant minimum déclenchant le règlement. Utilisez `-1` pour aucun minimum | | `source.maxAmount` | string | Non | Montant maximum par règlement. Utilisez `-1` pour illimité | | `destination.blockchain` | string | Oui | Réseau blockchain cible | | `destination.asset` | string | Oui | Actif cible pour la conversion | | `destination.address` | string | Non | Adresse de destination. Si omise, la logique de fallback intelligente s'applique (voir ci-dessus) | ## Pour commencer ### **1. Activer les Règlements automatiques** * Rendez-vous dans les paramètres de votre wallet * Activez la fonctionnalité de règlement automatique * Configurez les préférences par défaut ### **2. Créer votre première règle** * Commencez par une règle simple USDT vers ETH (ou tout autre actif de votre choix) * Définissez une tolérance de slippage prudente * Choisissez votre chaîne et votre actif de destination préférés ### **3. Tester et surveiller** * Déployez d'abord sur testnet * Surveillez les taux de succès des règlements * Ajustez les paramètres si nécessaire ### **4. Monter en charge progressivement** * Ajoutez des règles pour des actifs supplémentaires * Mettez en place le traitement par lot * Optimisez selon votre cas d'usage ## Support et ressources ### **Obtenir de l'aide** * **E-mail** : [support@blockradar.co](mailto:support@blockradar.co) * **Référence de l'API** : [Auto Settlement Rules](/en/api-reference/auto-settlements/master-wallet) * **Documentation** : [Configuration de Gateway](/en/essentials/gateway) Les règlements automatiques sont un moyen puissant d'automatiser la gestion de votre trésorerie. Commencez par des règles simples et ajoutez progressivement de la complexité au fur et à mesure que vous vous familiarisez avec le système.