Blog · 21 mai 2026

API de Criblage de Portefeuille : Risque On-Chain à 0,02 $ (BYOK) (FR)

Évaluez le risque on-chain de tout portefeuille crypto ou hachage de transaction (sanctions, mixeurs, darknet, ransomware) avec un score de 0 à 100 et une ventilation des sources de fonds, pour 0,02 $ avec votre propre clé (BYOK).

Par Didit21 mai 2026Mis à jour le 21 mai 2026

Une vérification KYC vous indique que le propriétaire d'un portefeuille est une personne réelle. Elle ne vous dit rien sur l'historique des fonds dans ce portefeuille. Sur la chaîne, un portefeuille d'apparence ordinaire peut être à un saut d'une adresse sanctionnée, à deux sauts d'un marché darknet, ou fraîchement sorti d'un mixeur. Le criblage de portefeuille — Know Your Transaction (KYT) — est la couche qui lit cet historique avant de permettre le transfert de valeur.

L'API de Criblage de Portefeuille de Didit évalue toute adresse de portefeuille crypto ou hachage de transaction par rapport aux renseignements sur les risques on-chain. Vous envoyez une adresse, elle renvoie un score de risque de 0 à 100, une bande BAS/MOYEN/ÉLEVÉ/CRITIQUE, et une ventilation des catégories de risque auxquelles les fonds sont exposés — sanctions, mixeurs, marchés darknet, ransomwares, fonds volés, et plus encore. Cela coûte 0,02 $ par criblage avec votre propre clé (BYOK), soit environ 10 fois moins cher que d'acheter un abonnement direct à une plateforme d'analyse blockchain.

Ce guide explique ce que l'API examine, comment fonctionne la notation et comment l'intégrer dans un flux de dépôt ou de retrait.

Points clés à retenir

Un appel, un risque on-chain. Envoyez une adresse de portefeuille (avant transfert) ou un hachage de transaction (après transfert) et obtenez un verdict de risque.
Score de risque de 0 à 100 mappé à quatre bandes — BAS / MOYEN / ÉLEVÉ / CRITIQUE — pour que la politique soit un seuil unique, et non un projet de recherche.
Plus de 14 catégories de sources de fonds — SANCTIONED, TERRORIST_FINANCING, RANSOMWARE, DARKNET_MARKET, MIXER, STOLEN_FUNDS, SCAM, et plus encore — chacune affichée par type d'exposition.
Tableau d'exposition + graphique de réseau — exposition directe et indirecte (multi-sauts) pour que vous voyiez non seulement la contrepartie mais aussi la provenance de ses fonds.
BYOK à 0,02 $ par criblage. Apportez votre propre clé Crystal ou Merkle Science ; Chainalysis et Elliptic arrivent bientôt. Des tarifs gérés sont également disponibles.
Intégré à la Surveillance des Transactions — les transactions crypto peuvent déclencher automatiquement le criblage de portefeuille, sans configuration supplémentaire.

Ce que fait le criblage de portefeuille

Les blockchains sont des registres publics, mais les données brutes des transactions ne sont pas des données de risque. Transformer une adresse en un verdict de risque nécessite une couche de clustering et d'étiquetage qui associe les adresses à des entités du monde réel — échanges, mixeurs, portefeuilles sanctionnés, opérateurs de ransomware, marchés darknet — puis retrace comment la valeur circule entre eux.

L'API de Criblage de Portefeuille de Didit s'appuie sur cette intelligence. Donnez-lui une adresse de portefeuille et elle analyse l'exposition de l'adresse : quelle proportion de sa valeur entrante et sortante est connectée à des entités risquées, directement ou via des sauts intermédiaires. Elle renvoie un score de risque unique, la bande dans laquelle ce score se situe, et les catégories à l'origine du risque — ainsi, une politique de conformité peut être exprimée comme « bloquer CRITICAL, réviser HIGH, laisser passer le reste. »

Pourquoi c'est important

Pour toute entreprise en contact avec la crypto — une bourse, une rampe d'accès/de sortie, un dépositaire, un portefeuille, un PSAN — accepter des fonds, c'est accepter leur historique. L'exposition aux sanctions est le risque le plus aigu : transférer de la valeur vers ou depuis un portefeuille figurant sur une liste de sanctions est une violation, quelle que soit l'intention. Mais le risque pratique est plus large. Les fonds blanchis via un mixeur, les produits d'un paiement de rançon, ou les pièces drainées lors d'un exploit apparaissent tous comme une exposition on-chain bien avant de se manifester ailleurs.

Le problème classique est le coût. Les plateformes d'analyse blockchain sont vendues sous forme d'abonnements d'entreprise avec des minimums annuels à cinq ou six chiffres — un véritable obstacle pour une équipe qui a juste besoin de cribler des portefeuilles au moment du dépôt. Didit supprime cet obstacle avec BYOK : vous apportez votre propre clé de fournisseur, payez 0,02 $ par criblage via l'API unifiée de Didit, et évitez entièrement les licences par utilisateur.

Détails techniques

Le criblage de portefeuille s'exécute dans la Surveillance des Transactions sur l'API unifiée /v3/. Lorsque vous soumettez une transaction crypto, le moteur peut cribler automatiquement la contrepartie ; vous pouvez également cribler explicitement en définissant currency_kind: "crypto" avec une direction.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_5b21fa",
    "category": "finance",
    "amount": 12500,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x9f1c...e3a2",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_7781", "role": "RECEIVER" }
  }'

La réponse contient le verdict de criblage — un score numérique, la bande et la ventilation de l'exposition :

{
  "transaction_id": "txn_5b21fa",
  "status": "IN_REVIEW",
  "wallet_screening": {
    "risk_score": 78,
    "risk_band": "HIGH",
    "provider": "crystal",
    "exposure": [
      { "category": "MIXER", "type": "INDIRECT", "hops": 2, "share": 0.34 },
      { "category": "DARKNET_MARKET", "type": "INDIRECT", "hops": 3, "share": 0.11 }
    ]
  }
}

Score de risque et bandes. Chaque criblage renvoie un score de 0 à 100 mappé à quatre bandes :

Bande	Score	Politique typique
`LOW`	0–24	Passer
`MEDIUM`	25–49	Passer avec journalisation / examen léger
`HIGH`	50–79	Mettre en attente pour examen par un analyste
`CRITICAL`	80–100	Refuser / geler

Catégories de sources de fonds. L'exposition est attribuée à des catégories spécifiques — SANCTIONED, TERRORIST_FINANCING, CHILD_EXPLOITATION, RANSOMWARE, STOLEN_FUNDS, DARKNET_MARKET, MIXER, SCAM, HIGH_RISK_EXCHANGE, HIGH_RISK_JURISDICTION, GAMBLING_UNLICENSED, P2P_EXCHANGE, EXCHANGE, et UNNAMED_SERVICE — afin que vous voyiez la raison d'un score, et pas seulement le nombre.

Type d'exposition et graphique de réseau. Chaque catégorie est signalée comme directe (le portefeuille a effectué une transaction avec l'entité risquée) ou indirecte (la valeur l'a atteinte par des sauts intermédiaires), avec le nombre de sauts. Un graphique de réseau retrace le chemin afin qu'un analyste puisse voir comment les fonds sont connectés.

Prix. 0,02 $ par criblage avec BYOK (Crystal ou Merkle Science). Les tarifs gérés — où Didit fournit les données — sont de 0,18 $ par criblage avec Crystal et 0,15 $ avec Merkle Science.

Criblage avant et après transfert

Le criblage de portefeuille fonctionne à deux moments du flux. Le criblage avant transfert prend une adresse de portefeuille et évalue son risque avant que vous n'acceptiez un dépôt ou ne libériez un retrait — la décision est prise avant que la valeur ne bouge. Le criblage après transfert prend un hachage de transaction (passé comme payment_reference_id) et évalue une transaction réglée après coup, pour la tenue des registres et l'examen continu. La plupart des équipes exécutent les deux : avant transfert pour filtrer le flux, après transfert pour conserver une piste d'audit.

Cas d'utilisation

Échanges de crypto — cribler chaque adresse de dépôt à l'entrée et chaque destination de retrait à la sortie ; refuser automatiquement les CRITICAL, acheminer les HIGH à un analyste.
Rampes d'accès/de sortie — filtrer les conversions fiat-crypto et crypto-fiat en fonction de l'exposition du portefeuille de la contrepartie avant le règlement.
Dépositaires — cribler les portefeuilles à l'entrée et les recribler lors des mouvements, avec le graphique de réseau comme preuve pour tout actif gelé.
Portefeuilles — protéger les utilisateurs en avertissant ou en bloquant les transferts vers des adresses présentant une forte exposition aux sanctions ou aux escroqueries.
PSAN — combiner le criblage de portefeuille avec l'échange de données de la règle de voyage du GAFI afin que le risque de contrepartie et d'origine soit évalué conjointement.

Comment s'intégrer à Didit

Définissez votre fournisseur et votre valeur par défaut. Dans la Console d'entreprise sous Transactions → Paramètres, choisissez Crystal ou Merkle Science, ajoutez votre clé BYOK et définissez si les transactions crypto sont criblées par défaut.
Envoyez des transactions crypto. POST /v3/transactions/ avec currency_kind: "crypto" et une direction. Utilisez include_crypto_screening pour remplacer la valeur par défaut par appel.
Lisez le verdict. Agissez en fonction de risk_band et de la ventilation de l'exposition — laisser passer LOW/MEDIUM, mettre en attente HIGH, refuser CRITICAL.
Gérez les alertes dans la Console. Un criblage à haut risque ouvre une alerte avec le graphique de réseau joint, prête pour l'enquête et le dépôt de DSF (déclaration de soupçon de financement).

Parce que tout est sur l'API unifiée /v3/, le criblage de portefeuille, la surveillance des transactions, le KYC et l'AML se combinent en une seule plateforme d'identité et de fraude — un portefeuille signalé peut interrompre une transaction et déclencher automatiquement une étape de remédiation.

Questions fréquemment posées

Combien coûte le criblage de portefeuille ?

0,02 $ par criblage avec votre propre clé (Crystal ou Merkle Science) — environ 10 fois moins cher que d'acheter un abonnement direct à une plateforme d'analyse blockchain. Le prix géré est de 0,18 $ (Crystal) ou 0,15 $ (Merkle Science) par criblage.

Quels fournisseurs d'analyse blockchain sont pris en charge ?

Crystal et Merkle Science aujourd'hui, via BYOK ou géré. Chainalysis et Elliptic arrivent bientôt, également à 0,02 $ BYOK.

Quelle est la différence entre le score de risque et la bande de risque ?

Le score est un nombre de 0 à 100 ; la bande (BAS/MOYEN/ÉLEVÉ/CRITIQUE) est la catégorie dans laquelle il se situe, de sorte que vous pouvez rédiger une politique par rapport à une étiquette au lieu d'ajuster vous-même les seuils numériques.

Puis-je cribler un portefeuille sans envoyer d'argent ?

Oui. Le criblage avant transfert prend une adresse de portefeuille et renvoie le risque avant que toute valeur ne bouge, afin que vous puissiez décider d'accepter un dépôt ou de libérer un retrait.

Couvre-t-il l'exposition indirecte, et pas seulement la contrepartie directe ?

Oui. L'exposition est signalée comme directe ou indirecte avec le nombre de sauts, et un graphique de réseau retrace comment les fonds ont atteint une entité risquée via des intermédiaires.

Prêt à commencer ?

Lisez l'aperçu du criblage de portefeuille dans la documentation, voyez comment il s'intègre à la plateforme sur la page produit du criblage de portefeuille, et consultez les prix transparents par appel sur la page de tarification. Lorsque vous êtes prêt, commencez gratuitement — 500 vérifications KYC gratuites chaque mois, et criblage de portefeuille à 0,02 $ par criblage avec BYOK.