Règlements automatiques

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.

Prérequis

Avant de configurer des règles de règlement automatique, assurez-vous de disposer des éléments suivants :

Clé API

Obtenez votre clé API depuis le tableau de bord Blockradar. Rendez-vous dans Developers pour en générer une.

Master Wallet créée

Créez une master wallet via l’API Create Wallet ou depuis le tableau de bord. Les règles se configurent par wallet.

Wallet de destination

Si vous effectuez un règlement cross-chain, assurez-vous d’avoir une wallet sur la blockchain de destination pour recevoir les actifs convertis.

Gas suffisant

Approvisionnez vos wallets en tokens natifs (ETH, BNB, MATIC, etc.) pour couvrir les frais de swap et de transfert.

Webhook configuré

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 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.

Gestion des règles

Créez et gérez des règles de règlement automatique pour automatiser les conversions d’actifs.

Conversion d'actifs

Convertissez automatiquement n’importe quel stablecoin vers tout autre actif selon vos règles.

Cross-Chain

Réglez vos actifs sur n’importe quel réseau blockchain de manière transparente.

Gestion du risque

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

Vérifier les règles de Child Address : Si l’adresse réceptrice possède ses propres règles, utilisez exclusivement celles-ci
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
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 :

Règle pour Ethereum USDC → Optimism USDC
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

Rendez-vous dans la section Auto Settlements de votre wallet
Cliquez sur « Create New Rule »
Configurez les paramètres de la règle
Définissez les seuils de montant et la tolérance de slippage
Choisissez les actifs/chaînes source et de destination
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 :

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <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 :

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <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

{
  "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
`/v1/wallets/{walletId}/auto-settlements/rules`	POST	Créer une nouvelle règle de règlement pour la 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
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	PATCH	Mettre à jour une règle existante de la 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
`/v1/wallets/{walletId}/auto-settlements`	GET	Récupérer l’historique des règlements de la master wallet	Get Settlement
`/v1/wallets/{walletId}/auto-settlements`	PATCH	Mettre à jour les paramètres de règlement de la master wallet	Update Settlement

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
`/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
`/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
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	PATCH	Mettre à jour une règle d’adresse existante	Update Rule
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	DELETE	Supprimer une règle de règlement d’adresse	Delete Rule
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	GET	Récupérer l’historique de règlement de l’adresse	Get Settlement
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	PATCH	Mettre à jour les paramètres de règlement de l’adresse	Update Settlement

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 : [email protected]
Référence de l’API : Auto Settlement Rules
Documentation : Configuration de 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.

Démarrage

Portefeuilles

Encaissements

Paiements

Convertir et Gérer

Conformité et Outils

Documentation Index

​Prérequis

​Fonctionnement

Gestion des règles

Conversion d'actifs

Cross-Chain

Gestion du risque

​Comment fonctionnent les Règlements automatiques

​1. Création des règles

​2. Détection des dépôts

​3. Conversion d’actifs

​4. Unification des soldes

​Règles de Règlement automatique

​Composants d’une règle

​Options de configuration de la règle

​Seuils de montant

​Protection contre le slippage

​Adresse de destination (facultative)

​Préférences d’exécution

​Hiérarchie et précédence des règles

​Comment les règles s’appliquent

​Ordre d’application des règles

​Règles spécifiques à une blockchain

​Cas d’usage pour chaque niveau

​Règles de Master Wallet

​Règles de Child Address

​Création de règles de Règlement automatique

​Via le tableau de bord

​Via l’API

​Cas d’usage

​Gestion de trésorerie

​Opérations métier

​Intégration DeFi

​Bonnes pratiques

​Configuration des règles

​Gestion du risque

​Efficacité opérationnelle

​Surveillance et alertes

​Surveillance via le tableau de bord

​Notifications par webhook

​Exemple de payload webhook

​Identifier les transactions de règlement automatique

​Champs clés des données du webhook

​Référence de l’API

​Endpoints

​Règlements automatiques de Master Wallet

​Règlements automatiques de Child Address

​Paramètres de la règle

​Pour commencer

​1. Activer les Règlements automatiques

​2. Créer votre première règle

​3. Tester et surveiller

​4. Monter en charge progressivement

​Support et ressources

​Obtenir de l’aide

Prérequis

Fonctionnement

Comment fonctionnent les Règlements automatiques

1. Création des règles

2. Détection des dépôts

3. Conversion d’actifs

4. Unification des soldes

Règles de Règlement automatique

Composants d’une règle

Options de configuration de la règle

Seuils de montant

Protection contre le slippage

Adresse de destination (facultative)

Préférences d’exécution

Hiérarchie et précédence des règles

Comment les règles s’appliquent

Ordre d’application des règles

Règles spécifiques à une blockchain

Cas d’usage pour chaque niveau

Règles de Master Wallet

Règles de Child Address

Création de règles de Règlement automatique

Via le tableau de bord

Via l’API

Cas d’usage

Gestion de trésorerie

Opérations métier

Intégration DeFi

Bonnes pratiques

Configuration des règles

Gestion du risque

Efficacité opérationnelle

Surveillance et alertes

Surveillance via le tableau de bord

Notifications par webhook

Exemple de payload webhook

Identifier les transactions de règlement automatique

Champs clés des données du webhook

Référence de l’API

Endpoints

Règlements automatiques de Master Wallet

Règlements automatiques de Child Address

Paramètres de la règle

Pour commencer

1. Activer les Règlements automatiques

2. Créer votre première règle

3. Tester et surveiller

4. Monter en charge progressivement

Support et ressources

Obtenir de l’aide