Reglements Automatiques

En resume
Les Reglements Automatiques convertissent automatiquement les depots entrants vers votre actif prefere sur n’importe quelle blockchain. Definissez des regles une fois, et tous les depots correspondants sont echanges et routes vers votre chaine de destination—sans intervention manuelle requise.

Prerequis

Avant de configurer des regles de reglement automatique, assurez-vous d’avoir :

Cle API

Obtenez votre cle API depuis le Tableau de bord Blockradar. Naviguez vers Developers pour en generer une.

Portefeuille Principal Cree

Creez un portefeuille principal via l’API Creer Portefeuille ou le tableau de bord. Les regles sont configurees par portefeuille.

Portefeuille de Destination

Si vous reglez cross-chain, assurez-vous d’avoir un portefeuille sur la blockchain de destination pour recevoir les actifs convertis.

Gas Suffisant

Financez vos portefeuilles avec des tokens natifs (ETH, BNB, MATIC, etc.) pour couvrir les frais de swap et de transfert.

Webhook Configure

Configurez des webhooks pour recevoir des notifications de reglement. Selon l’action, vous recevrez des evenements swap.success/swap.failed, gateway.success/gateway.failed, ou withdraw.success/withdraw.failed. Voir Webhooks pour les details.

Comment Ca Fonctionne

Les Reglements Automatiques vous permettent de convertir automatiquement les depots entrants en n’importe quel actif de destination sur n’importe quel reseau blockchain en fonction de vos regles configurees. Cela elimine le besoin d’echanger ou de bridger manuellement les actifs, garantissant que votre tresorerie peut etre automatiquement convertie vers vos actifs preferes sur plusieurs chaines.

Gestion des Regles

Creez et gerez des regles de reglement automatique pour automatiser les conversions d’actifs.

Conversion d'Actifs

Convertissez automatiquement n’importe quel stablecoin en n’importe quel autre actif en fonction de vos regles.

Cross-Chain

Reglez les actifs vers n’importe quel reseau blockchain de maniere fluide.

Gestion des Risques

Appliquez une tolerance au slippage et des regles pour vous proteger contre les mauvaises executions.

Comment Fonctionnent les Reglements Automatiques

1. Creation de Regle

Definissez des regles de reglement qui specifient quand et comment les depots doivent etre automatiquement convertis.

2. Detection de Depot

Lorsque des fonds arrivent a vos adresses, Blockradar detecte automatiquement les depots correspondant a vos regles.

3. Conversion d’Actifs

Les depots sont automatiquement echanges vers votre actif de destination (typiquement USDC) sur la chaine de votre choix.

4. Unification du Solde

Tous les actifs convertis sont consolides dans un solde unique et unifie sur votre chaine de destination.

Regles de Reglement Automatique

Composants de Regle

Chaque regle de reglement automatique definit les parametres suivants :

Composant	Description	Exemple
Nom de la Regle	Nom descriptif pour votre regle de reglement	”Swap from USDC to Optimism USDC”
Ordre	Preference de priorite d’execution	FASTEST, CHEAPEST, RECOMMENDED, NO_SLIPPAGE
Tolerance au Slippage	Deviation de prix maximum acceptable (%). Utilisez `-1` pour un slippage illimite	5 ou -1
Actifs Sources	Tableau d’actifs a regler automatiquement	[“USDC”, “USDT”]
Montant Min/Max Source	Controler la taille du depot qui declenche le reglement	Min: $1, Max:$ 1,000
Blockchain de Destination	Reseau blockchain cible	optimism, base, ethereum
Actif de Destination	Actif cible pour la conversion	USDC, USDT, cNGN, DAI
Adresse de Destination	(Optionnel) Adresse specifique pour recevoir les actifs convertis. Si non fournie, une logique de repli intelligente s’applique	0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22
Is Gateway	Activer la fonctionnalite gateway pour la regle	false

Options de Configuration des Regles

Seuils de Montant

Montant Minimum : Regler uniquement les depots au-dessus de ce seuil
Montant Maximum : Plafonner la taille des reglements individuels
Traitement par Lots : Regrouper plusieurs petits depots pour l’efficacite

Protection contre le Slippage

Illimite : -1 (pas de limite de slippage - comportement par defaut)
Conservateur : 0.1% - 0.5% (impact de prix minimal)
Modere : 0.5% - 1.0% (approche equilibree)
Agressif : 1.0% - 2.0% (execution plus rapide)

Definir slippageTolerance a -1 signifie une tolerance de slippage illimitee. C’est le comportement par defaut si non specifie, permettant aux reglements de s’executer quelle que soit la deviation de prix.

Adresse de Destination (Optionnel)

Le champ destination.address est maintenant optionnel. Lorsqu’il n’est pas fourni, le systeme utilise une logique de repli intelligente pour determiner l’adresse du destinataire :

Scenario	Comportement de Repli
Adresse explicite fournie	Utilise l’adresse specifiee
Reglement sur la meme chaine	Utilise l’adresse de depot (adresse source)
Cross-chain EVM-vers-EVM	Utilise la meme adresse sur la chaine de destination
Cross-chain (destination non-EVM)	Utilise l’adresse du portefeuille principal de la chaine de destination

Pour la plupart des cas d’utilisation, vous pouvez omettre l’adresse de destination et laisser le systeme router automatiquement les fonds vers l’adresse appropriee en fonction du type de reglement.

Preferences d’Execution

Plus rapide : Prioriser la vitesse sur le cout
Moins cher : Optimiser pour les frais les plus bas
Recommande : Equilibrer vitesse et cout avec fiabilite
Sans Slippage : Executer uniquement lorsqu’aucune deviation de prix ne se produit

Hierarchie et Precedence des Regles

Comment les Regles s’Appliquent

Concept Cle : Les regles creees sur un portefeuille principal s’appliquent automatiquement a toutes les adresses enfants sous ce portefeuille. Cependant, si vous creez des regles directement sur une adresse enfant, ces regles remplaceront completement les regles du portefeuille principal pour cette adresse specifique.

Niveau de Regle	Portee	Comportement
Regles du Portefeuille Principal	S’appliquent au portefeuille principal ET a toutes les adresses enfants	Regles par defaut pour toute la hierarchie du portefeuille
Regles d’Adresse Enfant	S’appliquent uniquement a cette adresse specifique	Remplacent completement les regles du portefeuille principal lorsqu’elles sont presentes

Ordre d’Application des Regles

Verifier les Regles d’Adresse Enfant : Si l’adresse receptrice a ses propres regles, utiliser celles-ci exclusivement
Se Rabattre sur les Regles du Portefeuille Principal : Si aucune regle d’adresse enfant n’existe, appliquer les regles du portefeuille principal
Pas de Regles : Si aucun niveau n’a de regles configurees, aucun reglement automatique ne se produit

Lorsqu’une adresse enfant a ses propres regles, les regles du portefeuille principal sont completement ignorees pour cette adresse—il n’y a pas de fusion ou de combinaison de regles.

Regles Specifiques par Blockchain

Important : Les regles sont isolees et liees a chaque blockchain. Une regle configuree pour un blockchain (ex. Ethereum) N’affectera PAS les depots sur un autre blockchain (ex. Base ou Optimism).

Cela signifie :

Vous devez creer des regles separees pour chaque blockchain source que vous souhaitez regler automatiquement
Une regle pour “USDC sur Ethereum” ne se declenchera pas pour “USDC sur Base”
Cela permet un controle granulaire sur le comportement de reglement par chaine

Exemple : Si vous souhaitez regler automatiquement les depots USDC d’Ethereum et de Base vers Optimism, vous avez besoin de deux regles separees :

Regle pour Ethereum USDC → Optimism USDC
Regle pour Base USDC → Optimism USDC

Cas d’Utilisation pour Chaque Niveau

Regles du Portefeuille Principal

Strategie Coherente : Meme comportement de reglement sur toutes les adresses enfants
Gestion Simplifiee : Un seul endroit pour configurer le comportement par defaut
Operations en Masse : Appliquer des regles a plusieurs adresses a la fois
Standardisation : Assurer la conformite et la coherence

Regles d’Adresse Enfant

Tests : Essayer differentes strategies de reglement sur des adresses specifiques
Exigences Personnalisees : Besoins de reglement specifiques a l’adresse
Remplacer les Defauts : Modifier le comportement pour des cas d’utilisation particuliers
Controle Granulaire : Affiner le reglement pour des adresses specifiques

Creation des Regles de Reglement Automatique

Via le Tableau de Bord

Naviguez vers la section Reglements Automatiques de votre portefeuille
Cliquez sur “Creer une Nouvelle Regle”
Configurez les parametres de la regle
Definissez les seuils de montant et la tolerance au slippage
Choisissez les actifs/chaines source et destination
Sauvegardez et activez la regle

Via l’API

Creez des regles de reglement de maniere programmatique en utilisant l’API des Regles de Reglement Automatique :

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 defini a -1 pour un slippage illimite, et destination.address est omis. Le systeme utilisera automatiquement la logique de repli intelligente pour determiner l’adresse du 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’Utilisation

Gestion de Tresorerie

Conversion d’Actifs Flexible : Convertir vers n’importe quel actif prefere (USDC, ETH, USDT, etc.)
Operations Cross-Chain : Maintenir des soldes sur plusieurs reseaux
Consolidation Automatisee : Aucune intervention manuelle requise
Strategie Multi-Actifs : Supporter diverses preferences et strategies d’actifs

Operations Commerciales

Traitement des Paiements : Regler automatiquement les paiements entrants vers les actifs preferes
Gestion des Revenus : Convertir divers stablecoins vers votre actif de destination choisi
Attenuation des Risques : Appliquer automatiquement la protection contre le slippage
Diversification des Actifs : Maintenir automatiquement les allocations d’actifs cibles

Integration DeFi

Yield Farming : Regler automatiquement les recompenses vers l’actif prefere
Gestion de Liquidite : Consolider les recompenses et frais LP
Reequilibrage de Portefeuille : Maintenir les allocations d’actifs cibles

Bonnes Pratiques

Configuration des Regles

Commencez Conservateur : Commencez avec une faible tolerance au slippage
Surveillez les Performances : Suivez les taux de succes des reglements
Ajustez Graduellement : Affinez les regles en fonction des conditions du marche
Testez sur Testnet : Validez les regles avant le deploiement mainnet

Gestion des Risques

Limites de Slippage : Definissez des niveaux de tolerance appropries
Plafonds de Montant : Limitez les tailles maximales de reglement
Selection de Reseau : Choisissez des chaines de destination fiables
Regles de Secours : Creez des options de reglement de secours

Efficacite Operationnelle

Traitement par Lots : Regroupez les petits depots pour l’efficacite
Optimisation du Timing : Considerez les modeles de congestion du reseau
Analyse des Couts : Equilibrez les preferences vitesse vs cout
Surveillance : Configurez des alertes pour les reglements echoues

Surveillance et Alertes

Surveillance du Tableau de Bord

Statut des Regles : Indicateurs de regles actives/inactives
Historique des Reglements : Suivez les reglements reussis et echoues
Metriques de Performance : Taux de succes et temps d’execution
Soldes des Actifs : Surveillez la croissance du solde unifie

Notifications Webhook

Les reglements automatiques declenchent des evenements webhook lorsque les reglements sont executes :

Evenement	Description
`swap.success`	Le swap de reglement automatique a ete execute avec succes
`swap.failed`	Le swap de reglement automatique a echoue

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"
    }
  }
}

Distinguer les Reglements Automatiques des Swaps Reguliers

Le payload webhook inclut des metadonnees qui aident a identifier les transactions de reglement automatique :

Champ	Description
`metadata.swapAutoSettlement.rule`	Payload complet de la regle de reglement automatique qui a declenche ce swap
`metadata.swapAutoSettlement.settleAmount`	Montant qui a ete regle selon la regle
`metadata.transactionId`	ID de transaction interne pour le suivi

Lorsque metadata.swapAutoSettlement est present, le swap a ete declenche par une regle de reglement automatique. Le champ rule contient la configuration complete de la regle, pas seulement un ID.

Champs Cles des Donnees Webhook

Champ	Description
`toAmount`	Montant final recu apres le swap (tenant compte des frais et du slippage)
`rate`	Taux de change utilise pour le swap
`toAsset`	Details de l’actif de destination (USDT dans cet exemple)
`toBlockchain`	Reseau blockchain de destination (Optimism dans cet exemple)
`toWallet`	Portefeuille de destination qui a recu les actifs convertis
`assetSwept`	Si les actifs originaux ont ete balayes apres la conversion

Reference API

Endpoints

Reglements Automatiques du Portefeuille Principal

Endpoint	Methode	Description	Reference API
`/v1/wallets/{walletId}/auto-settlements/rules`	GET	Lister toutes les regles de reglement pour le portefeuille principal	Obtenir Toutes les Regles
`/v1/wallets/{walletId}/auto-settlements/rules`	POST	Creer une nouvelle regle de reglement pour le portefeuille principal	Creer une Regle
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	GET	Obtenir les details d’une regle specifique du portefeuille principal	Obtenir une Regle
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	PATCH	Mettre a jour une regle existante du portefeuille principal	Mettre a Jour une Regle
`/v1/wallets/{walletId}/auto-settlements/rules/{id}`	DELETE	Supprimer une regle de reglement du portefeuille principal	Supprimer une Regle
`/v1/wallets/{walletId}/auto-settlements`	GET	Obtenir l’historique des reglements du portefeuille principal	Obtenir le Reglement
`/v1/wallets/{walletId}/auto-settlements`	PATCH	Mettre a jour les parametres de reglement du portefeuille principal	Mettre a Jour le Reglement

Reglements Automatiques de l’Adresse Enfant

Endpoint	Methode	Description	Reference API
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	GET	Lister toutes les regles de reglement pour une adresse specifique	Obtenir Toutes les Regles
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules`	POST	Creer une nouvelle regle de reglement pour une adresse specifique	Creer une Regle
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	GET	Obtenir les details d’une regle specifique d’adresse	Obtenir une Regle
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	PATCH	Mettre a jour une regle existante d’adresse	Mettre a Jour une Regle
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}`	DELETE	Supprimer une regle de reglement d’adresse	Supprimer une Regle
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	GET	Obtenir l’historique des reglements d’adresse	Obtenir le Reglement
`/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements`	PATCH	Mettre a jour les parametres de reglement d’adresse	Mettre a Jour le Reglement

Parametres de Regle

Parametre	Type	Requis	Description
`name`	string	Oui	Nom de la regle pour l’identification
`order`	string	Oui	Priorite d’execution (FASTEST/CHEAPEST/RECOMMENDED/NO_SLIPPAGE)
`slippageTolerance`	string	Non	Slippage maximum acceptable (%). Utilisez `-1` pour illimite (par defaut)
`isGateway`	boolean	Non	Activer la fonctionnalite gateway pour la regle
`source.assets`	array	Oui	Tableau d’actifs source a regler automatiquement
`source.minAmount`	string	Non	Montant minimum pour declencher le reglement. Utilisez `-1` pour aucun minimum
`source.maxAmount`	string	Non	Montant maximum par reglement. Utilisez `-1` pour illimite
`destination.blockchain`	string	Oui	Reseau blockchain cible
`destination.asset`	string	Oui	Actif cible pour la conversion
`destination.address`	string	Non	Adresse de destination. Si omise, utilise la logique de repli intelligente (voir ci-dessus)

Pour Commencer

1. Activer les Reglements Automatiques

Naviguez vers les parametres de votre portefeuille
Activez la fonctionnalite de reglement automatique
Configurez les preferences par defaut

2. Creez Votre Premiere Regle

Commencez avec une simple regle USDT vers ETH (ou n’importe quel actif que vous preferez)
Definissez une tolerance au slippage conservatrice
Choisissez votre chaine et actif de destination preferes

3. Testez et Surveillez

Deployez d’abord sur testnet
Surveillez les taux de succes des reglements
Ajustez les parametres selon les besoins

4. Evoluez Graduellement

Ajoutez des regles pour des actifs supplementaires
Implementez le traitement par lots
Optimisez pour votre cas d’utilisation

Support et Ressources

Obtenir de l’Aide

Email : [email protected]
Reference API : Regles de Reglement Automatique
Documentation : Configuration Gateway

Les reglements automatiques sont un moyen puissant d’automatiser la gestion de votre tresorerie. Commencez avec des regles simples et ajoutez progressivement de la complexite a mesure que vous vous familiarisez avec le systeme.

​Prerequis

​Comment Ca Fonctionne

Gestion des Regles

Conversion d'Actifs

Cross-Chain

Gestion des Risques

​Comment Fonctionnent les Reglements Automatiques

​1. Creation de Regle

​2. Detection de Depot

​3. Conversion d’Actifs

​4. Unification du Solde

​Regles de Reglement Automatique

​Composants de Regle

​Options de Configuration des Regles

​Seuils de Montant

​Protection contre le Slippage

​Adresse de Destination (Optionnel)

​Preferences d’Execution

​Hierarchie et Precedence des Regles

​Comment les Regles s’Appliquent

​Ordre d’Application des Regles

​Regles Specifiques par Blockchain

​Cas d’Utilisation pour Chaque Niveau

​Regles du Portefeuille Principal

​Regles d’Adresse Enfant

​Creation des Regles de Reglement Automatique

​Via le Tableau de Bord

​Via l’API

​Cas d’Utilisation

​Gestion de Tresorerie

​Operations Commerciales

​Integration DeFi

​Bonnes Pratiques

​Configuration des Regles

​Gestion des Risques

​Efficacite Operationnelle

​Surveillance et Alertes

​Surveillance du Tableau de Bord

​Notifications Webhook

​Exemple de Payload Webhook

​Distinguer les Reglements Automatiques des Swaps Reguliers

​Champs Cles des Donnees Webhook

​Reference API

​Endpoints

​Reglements Automatiques du Portefeuille Principal

​Reglements Automatiques de l’Adresse Enfant

​Parametres de Regle

​Pour Commencer

​1. Activer les Reglements Automatiques

​2. Creez Votre Premiere Regle

​3. Testez et Surveillez

​4. Evoluez Graduellement

​Support et Ressources

​Obtenir de l’Aide

Prerequis

Comment Ca Fonctionne

Comment Fonctionnent les Reglements Automatiques

1. Creation de Regle

2. Detection de Depot

3. Conversion d’Actifs

4. Unification du Solde

Regles de Reglement Automatique

Composants de Regle

Options de Configuration des Regles

Seuils de Montant

Protection contre le Slippage

Adresse de Destination (Optionnel)

Preferences d’Execution

Hierarchie et Precedence des Regles

Comment les Regles s’Appliquent

Ordre d’Application des Regles

Regles Specifiques par Blockchain

Cas d’Utilisation pour Chaque Niveau

Regles du Portefeuille Principal

Regles d’Adresse Enfant

Creation des Regles de Reglement Automatique

Via le Tableau de Bord

Via l’API

Cas d’Utilisation

Gestion de Tresorerie

Operations Commerciales

Integration DeFi

Bonnes Pratiques

Configuration des Regles

Gestion des Risques

Efficacite Operationnelle

Surveillance et Alertes

Surveillance du Tableau de Bord

Notifications Webhook

Exemple de Payload Webhook

Distinguer les Reglements Automatiques des Swaps Reguliers

Champs Cles des Donnees Webhook

Reference API

Endpoints

Reglements Automatiques du Portefeuille Principal

Reglements Automatiques de l’Adresse Enfant

Parametres de Regle

Pour Commencer

1. Activer les Reglements Automatiques

2. Creez Votre Premiere Regle

3. Testez et Surveillez

4. Evoluez Graduellement

Support et Ressources

Obtenir de l’Aide