Pool de Liquidite

En resume
Le Pool de Liquidite de Blockradar permet aux Fournisseurs de Liquidite (LPs) approuves de definir et gerer les taux de change pour les paires d’actifs. Les taux alimentent le moteur d’echange interne — lorsqu’un utilisateur initie un swap, le systeme selectionne automatiquement le meilleur taux disponible parmi les LPs actifs, valide la liquidite et execute la transaction.

Prerequis

Avant d’utiliser l’API du Pool de Liquidite, assurez-vous d’avoir :

Devenir Fournisseur de Liquidite

Le Pool de Liquidite est disponible uniquement pour les Fournisseurs de Liquidite approuves. Pour commencer, remplissez le formulaire de candidature LP et l’equipe Blockradar examinera votre demande et procedera a votre integration.

Cle API

Une fois integre, generez une cle API depuis le Tableau de bord Blockradar. Naviguez vers Developers pour en creer une.

Alimenter Vos Portefeuilles

Assurez-vous que vos portefeuilles de tresorerie disposent d’un solde suffisant des actifs pour lesquels vous prevoyez de fournir de la liquidite, ainsi que des jetons natifs pour couvrir les frais de reseau.

Comment Ca Fonctionne

En tant que Fournisseur de Liquidite, vous definissez des taux de change pour les paires d’actifs (par ex., BNB → USDC). Lorsqu’un utilisateur sur la plateforme Blockradar initie un swap, le systeme :

Trouve les taux correspondants parmi tous les LPs actifs pour la paire d’actifs demandee.
Classe les candidats selon le meilleur taux, la priorite du LP et la date de creation.
Valide la liquidite en verifiant que le portefeuille de tresorerie du LP selectionne dispose d’un solde suffisant pour executer le swap.
Execute le swap en utilisant le taux et la tresorerie du LP selectionne.

Gestion des Taux

Creez, mettez a jour, desactivez et reactivez les taux de change pour toute paire d’actifs prise en charge.

Tranches de Montant

Definissez les montants de transaction minimum et maximum par taux pour controler l’exposition et segmenter les niveaux de tarification.

Historique des Versions

Chaque modification de taux cree une nouvelle version. L’historique complet est conserve pour l’audit et l’analyse.

Selection Automatique

Le systeme selectionne automatiquement le meilleur LP pour chaque swap en fonction du taux, de la priorite et de la liquidite disponible.

Cycle de Vie des Taux

Les taux suivent un cycle de vie clair avec un suivi complet des versions :

1. Creer un Taux

Definissez un nouveau taux de change pour une paire d’actifs. Le taux demarre en tant qu’actif a la version 1.

curl --request POST \
  --url https://api.blockradar.co/v1/rates \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "fromAsset": "BNB",
    "toAsset": "USDC",
    "rate": "605.50",
    "minAmount": "0.01",
    "maxAmount": "100"
  }'

Parametres de la Requete

Parametre	Type	Requis	Description
`fromAsset`	string	Oui	Le symbole de l’actif a convertir depuis (par ex., `BNB`)
`toAsset`	string	Oui	Le symbole de l’actif a convertir vers (par ex., `USDC`)
`rate`	string	Oui	Le taux de change. Fourni sous forme de chaine de caracteres pour eviter les problemes de precision en virgule flottante
`minAmount`	string	Oui	Montant minimum de transaction pour ce taux (inclusif)
`maxAmount`	string	Non	Montant maximum de transaction (exclusif). Omettez pour illimite

Reponse de Creation

{
  "message": "Rate created successfully",
  "statusCode": 201,
  "data": {
    "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
    "fromAsset": "BNB",
    "toAsset": "USDC",
    "rate": "605.50",
    "minAmount": "0.01",
    "maxAmount": "100",
    "isActive": true,
    "status": "active",
    "version": 1,
    "network": "testnet",
    "createdAt": "2026-02-19T07:50:17.042Z"
  }
}

2. Mettre a Jour un Taux

Modifiez le taux ou les contraintes de montant pour un taux actif existant. Cela cree une nouvelle version — la version precedente est automatiquement marquee comme superseded.

curl --request PATCH \
  --url https://api.blockradar.co/v1/rates/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "rate": "610.00",
    "minAmount": "0.005"
  }'

Fournissez uniquement les champs que vous souhaitez modifier — les mises a jour partielles sont prises en charge.

3. Desactiver un Taux

Mettez temporairement un taux hors ligne. Le taux devient desactive et ne sera plus selectionne pour les swaps.

curl --request POST \
  --url https://api.blockradar.co/v1/rates/{id}/deactivate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "reason": "Pausing for maintenance"
  }'

4. Reactiver un Taux

Remettez en ligne un taux desactive. Cela cree une nouvelle version avec le statut active.

curl --request POST \
  --url https://api.blockradar.co/v1/rates/{id}/reactivate \
  --header 'x-api-key: <api-key>'

Gestion des Versions des Taux

Chaque fois qu’un taux est mis a jour ou reactive, une nouvelle version est creee. La version precedente est marquee comme superseded. Cela fournit une piste d’audit complete.

Champ	Description
`version`	Numero de version sequentiel commencant a 1
`rootRateId`	Pointe vers le taux original — toutes les versions d’une chaine partagent cet ID
`previousRateId`	Pointe vers la version immediatement precedente

Exemple de Chaine de Versions

v1 (active)  →  v2 (active, v1 superseded)  →  v3 (deactivated)  →  v4 (active, v3 superseded)

Consulter l’Historique des Taux

Recuperez l’historique complet des versions d’un taux :

curl --request GET \
  --url https://api.blockradar.co/v1/rates/{id}/history \
  --header 'x-api-key: <api-key>'

Reponse de l’Historique

{
  "message": "Rate history retrieved successfully",
  "statusCode": 200,
  "data": {
    "currentVersion": 2,
    "rootRateId": "d69078ef-2467-40f4-bb00-63394efe32c0",
    "history": [
      {
        "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
        "fromAsset": "BNB",
        "toAsset": "USDC",
        "rate": "605.50",
        "minAmount": "0.01",
        "status": "superseded",
        "version": 1,
        "createdAt": "2026-02-19T07:50:17.042Z"
      },
      {
        "id": "cad01df3-4041-4e81-a368-534fb4de5d12",
        "fromAsset": "BNB",
        "toAsset": "USDC",
        "rate": "610.00",
        "minAmount": "0.005",
        "status": "active",
        "version": 2,
        "createdAt": "2026-02-19T07:59:35.481Z"
      }
    ]
  },
  "meta": {
    "currentPage": 1,
    "itemCount": 2,
    "itemsPerPage": 10,
    "totalItems": 2,
    "totalPages": 1
  }
}

Statuts des Taux

Statut	Description
`active`	Actuellement en ligne et eligible pour la selection de swap
`superseded`	Remplace par une version plus recente (via mise a jour ou reactivation)
`deactivated`	Mis hors ligne manuellement — peut etre reactive

superseded est un etat terminal — ces enregistrements sont historiques et ne peuvent pas etre modifies.

Tranches de Montant

Chaque taux couvre une plage de montant de transaction definie par minAmount et maxAmount :

minAmount — La borne inferieure inclusive. Les transactions en dessous de ce montant n’utiliseront pas ce taux.
maxAmount — La borne superieure exclusive. Definissez sur null (omettez) pour illimite.

Plusieurs Taux pour la Meme Paire

Vous pouvez creer plusieurs taux pour la meme paire d’actifs avec differentes tranches de montant pour offrir une tarification par paliers :

Taux	Tranche	Cas d’utilisation
605.00	0.01 – 10 BNB	Petites transactions
606.50	10 – 100 BNB	Transactions moyennes
608.00	100+ BNB	Grosses transactions

Les tranches de montant pour la meme paire d’actifs ne doivent pas se chevaucher. Le systeme rejettera un taux si sa tranche chevauche celle d’un autre taux actif pour la meme paire.

Validation de la Liquidite

Avant d’executer un swap utilisant votre taux, le systeme valide que votre portefeuille de tresorerie dispose de :

Un solde de jetons suffisant de l’actif de destination pour couvrir le resultat du swap (montant x taux).
Un solde de jetons natifs suffisant (ETH, BNB, etc.) pour couvrir les frais de reseau pour le transfert.

Si le solde de votre portefeuille est insuffisant, le systeme ignore votre taux et passe au LP disponible suivant. Vous recevrez une alerte par e-mail lorsque votre liquidite est faible.

Maintenez vos portefeuilles de tresorerie bien alimentes pour eviter de manquer des opportunites de swap. Le systeme vous notifiera lorsque les soldes descendront en dessous des seuils.

Bonnes Pratiques

Gestion des Taux

Surveillez les conditions du marche et mettez a jour les taux regulierement pour rester competitif
Utilisez les tranches de montant pour offrir une tarification par paliers selon les differentes tailles de transactions
Desactivez les taux pendant la maintenance ou les periodes de forte volatilite au lieu de les supprimer
Consultez l’historique des versions pour suivre l’evolution des taux au fil du temps

Liquidite

Maintenez un solde suffisant dans vos portefeuilles de tresorerie pour l’actif de destination et les jetons natifs
Configurez la surveillance pour les alertes de solde faible
Alimentez les portefeuilles de maniere proactive pour eviter les interruptions de service

Reference API

Point d’acces	Description
Creer un Taux	Creer un nouveau taux de change pour une paire d’actifs
Obtenir un Taux	Recuperer un taux unique par ID
Mettre a Jour un Taux	Mettre a jour un taux existant (cree une nouvelle version)
Desactiver un Taux	Mettre un taux hors ligne
Reactiver un Taux	Remettre en ligne un taux desactive
Obtenir l’Historique d’un Taux	Consulter l’historique complet des versions d’un taux

Support

E-mail : [email protected]
Devenir un LP : Postulez ici pour exprimer votre interet a devenir Fournisseur de Liquidite

Le Pool de Liquidite est concu pour les fournisseurs de liquidite institutionnels et professionnels. Postulez pour devenir un LP, puis testez vos configurations de taux sur le testnet avant de passer en production.

Démarrage

Essentiels

Prerequis

Comment Ca Fonctionne

Gestion des Taux

Tranches de Montant

Historique des Versions

Selection Automatique

Cycle de Vie des Taux

1. Creer un Taux

Parametres de la Requete

Reponse de Creation

2. Mettre a Jour un Taux

3. Desactiver un Taux

4. Reactiver un Taux

Gestion des Versions des Taux

Exemple de Chaine de Versions

Consulter l’Historique des Taux

Reponse de l’Historique

Statuts des Taux

Tranches de Montant

Plusieurs Taux pour la Meme Paire

Validation de la Liquidite

Bonnes Pratiques

Gestion des Taux

Liquidite

Reference API

Support

Démarrage

Essentiels

​Prerequis

​Comment Ca Fonctionne

Gestion des Taux

Tranches de Montant

Historique des Versions

Selection Automatique

​Cycle de Vie des Taux

​1. Creer un Taux

​Parametres de la Requete

​Reponse de Creation

​2. Mettre a Jour un Taux

​3. Desactiver un Taux

​4. Reactiver un Taux

​Gestion des Versions des Taux

​Exemple de Chaine de Versions

​Consulter l’Historique des Taux

​Reponse de l’Historique

​Statuts des Taux

​Tranches de Montant

​Plusieurs Taux pour la Meme Paire

​Validation de la Liquidite

​Bonnes Pratiques

​Gestion des Taux

​Liquidite

​Reference API

​Support

Prerequis

Comment Ca Fonctionne

Cycle de Vie des Taux

1. Creer un Taux

Parametres de la Requete

Reponse de Creation

2. Mettre a Jour un Taux

3. Desactiver un Taux

4. Reactiver un Taux

Gestion des Versions des Taux

Exemple de Chaine de Versions

Consulter l’Historique des Taux

Reponse de l’Historique

Statuts des Taux

Tranches de Montant

Plusieurs Taux pour la Meme Paire

Validation de la Liquidite

Bonnes Pratiques

Gestion des Taux

Liquidite

Reference API

Support