All pages
Powered by GitBook
1 of 9

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

v2 (retiré)

L'ancienne version de l'API

Ceci est l'ancienne version de notre API.

Nous avons cessé de maintenir l'API depuis le 1er juillet 2024. Veuillez vous référer à la dernière version.

N'hésitez pas à nous contacter ([email protected]) si vous avez des questions concernant cette migration.

Commencer

🎉 Bienvenue dans la documentation API de MetaSleuth !

Découvrez le potentiel de notre API puissante, alimentée par la base de données des labels d'adresse de BlockSec et l'algorithme d'évaluation des risques.

  • API d'Étiquetage d'Adresse: Accédez à des informations détaillées et des étiquettes pour les adresses on-chain. Décrivez les identités et les activités des adresses spécifiques, vous aidant à comprendre la blockchain plus facilement.

  • API de Score de Conformité: Évaluez les niveaux de risque et les indicateurs pour les adresses, vous permettant d'évaluer plus efficacement les exigences de conformité. Détectez et empêchez l'interaction avec des fonds illicites de manière efficace, respectez les exigences réglementaires.

Authentification

La clé API est l'identifiant unique utilisé pour accéder aux interfaces API. Toutes les interfaces nécessitent une authentification par clé API pour être accessibles. Pour garantir la sécurité de vos données, veuillez ne pas partager votre clé API avec qui que ce soit.

Comment obtenir la clé API ?

Pour générer une clé API, commencez par vous inscrire à un compte MetaSleuth. Une fois inscrit, accédez au panneau API dans la section Paramètres, où vous pouvez facilement générer votre clé API.

Comment utiliser la clé API

Pour chaque requête API, assurez-vous d'inclure l'en-tête "API-KEY" dans les en-têtes de la requête HTTP et de fournir votre clé API en tant que valeur.

Limites de taux

Pour éviter une surcharge de l'API et garantir une vitesse de traitement et un temps de réponse optimaux, nous avons mis en place des restrictions d'accès sur les appels API.

  • API Adresse Labe : Limité à 5 appels par seconde.

  • API Score de Conformité : Limité à 5 appels par seconde.

Pour obtenir des informations concernant les limites quotidiennes de requêtes en fonction des différents plans d'abonnement, veuillez consulter nos Plans de Tarification API.

Points de terminaison API

Vue d'ensemble des points de terminaison de l'API MetaSleuth.

Étiquette d'adresse
Score de conformité

Annexe

Annexe 1 : Glossaire

Entité

Le contrôleur d'une adresse spécifiée. Pour une adresse EOA, l'entité est généralement l'identité qui contrôle la clé privée. Tandis que pour un contrat, l'entité est généralement le déployeur ou le propriétaire avec des privilèges élevés.

Entité Secondaire

L'utilisateur d'une adresse spécifiée et n'ayant pas le contrôle des clés privées. Par exemple, les échanges distribuent des adresses aux utilisateurs pour le dépôt. Les utilisateurs peuvent utiliser ces adresses pour recevoir des paiements mais ne peuvent pas accéder à la clé privée.

Étiquette Nom

Sert d'identifiant unique pour une adresse.

Propriété d'Adresse

Utilisé pour indiquer les caractéristiques associées à une adresse, telles que 'PORTFEUILLE CHAUD' ou 'BLOQUÉ PAR USDT'.

Propriété d'Entité

Utilisé pour caractériser les attributs exhibés par une entité, tels que 'PAS DE KYC' ou 'SANCTIONNÉ PAR L'OFAC'.

Score de Confiance

La gamme de notation est de 1 à 10. Par défaut, seules les étiquettes avec un score de confiance supérieur à 5 sont renvoyées.

Score de Risque

La gamme de notation est de 1 à 5. Les adresses avec une note de 4 ou plus sont considérées comme ayant un risque de conformité significatif.

Annexe 2 : Catégorie des Facteurs de Risque

Chaînes supportées

Veuillez utiliser les noms de chaîne fournis (insensibles à la casse) lors de la soumission des requêtes

Chaîne
Id de la chaîne
Nom de la chaîne

Exploitation d'un site web darknet impliquant une ou plusieurs des activités suivantes : drogues, comptes volés, armes, matériaux pornographiques, services de hackers, etc.

5

INDIVIDU / ORGANISATION ILLICITE

Entités impliquées dans des activités illégales telles que fraude, piratage, sites de hameçonnage, opérations sur le darknet, etc., manquent d'identification précise, mais sont indiquées par des sources de renseignement.

5

MELANGEUR

Services qui obscurcissent la source et la destination des fonds.

5

RANÇONGICIEL

Groupes criminels qui pratiquent l'extorsion par le biais de rançongiciels.

5

SANCTIONNÉ

Toute personne relevant de la juridiction de l'autorité émettrice de sanctions, y compris les ressortissants opérant ailleurs ou les entreprises étrangères opérant directement dans la juridiction de l'autorité émettrice, ne doit pas s'engager dans des transactions avec des entités sanctionnées.

5

ESCROQUERIE

Adresse(s) contrôlée(s) par un certain escroc (projet), par exemple, l'adresse(s) des auteur(s) de l'escroquerie Plus Token.

5

Catégorie de Risque

Description

Score de Risque

COMPROMIS

Par exemple, contrats vulnérables, adresses de clés privées divulguées publiquement, etc., il n'est pas recommandé d'interagir avec ces adresses.

4

JEUX D'ARGENT

Une plateforme de jeux en ligne qui prend en charge les cryptomonnaies, offrant des services tels que des machines à sous et des paris sportifs/e-sports.

4

ATTAQUANT

Le responsable d'un certain incident de sécurité, par exemple, l'adresse de l'attaquant dans le piratage du Colonial Pipeline.

5

MARCHÉ NOIR

Plateformes de trading à grande échelle sur le darknet qui vendent des drogues, des données de comptes volés, des armes, des matériaux pornographiques, des services de hackers, et plus encore.

5

ENTREPRISE DARKNET

1

eth

BNB Smart Chain

2

bsc

TRON

-

tron

Fantom

250

fantom

Arbitrum One

42161

arbitrum

Avalanche C-Chain

43114

avalanche

Optimism

10

optimism

Polygon

137

polygon

Cronos

25

cronos

Base

8453

base

Linea

59144

linea

Moonbeam

1284

moonbeam

Moonriver

1285

moonriver

Polygon zkEVM

1101

polygon zkevm

Celo

42220

celo

CLV

1024

clv

Gnosis

100

gnosis

Bittorrent

199

bittorrent

Boba

288

boba

Wemix3.0

1111

wemix

zkSync Era

324

zksync era

Aurora

1313161554

aurora

Bitcoin

-

btc

Ethereum

Score de conformité

Obtenez des informations sur le risque de conformité pour une seule adresse

GET https://aml.blocksec.com/api/risk/v1/address

Paramètres de chemin

Nom
Type
Description

En-têtes

Nom
Type
Description

Exemple de requête

Exemple de réponse

  • code: Integer. Code d'erreur.

    • 200: Pas d'erreur.

Paramètre de données de réponse

Champ
Type
Description

Pour les mots en italique, reportez-vous à l' pour des explications.

Sous-champs du champ risk_indicators

Champ
Type
Description

autre: Une erreur survient.

  • msg: String

    • Si le code n'est pas 200, ce champ indique les informations détaillées de l'erreur.

  • data: Object

    • Les informations de risque détaillées de l'adresse cible, voir le 'Paramètre de données de réponse' pour plus de détails.

  • > entity

    String

    Le nom de l'Entité

    > name_tag

    String

    Tag Nom

    > contract_name

    String

    Nom du contrat

    > token_name

    String

    Nom du token si c'est un contrat de token

    risk_indicators

    Array

    Liste des éléments de risque, format détaillé dans le tableau '' ci-dessous

    risk_level

    Integer

    Score de Risque

    > chain

    string

    Chaîne où se trouve la source du risque.

    > address

    string

    L'adresse source du risque

    > entity

    string

    Entité nom de la source du risque

    chaine *

    String

    nom de la chaîne, voir chaînes prises en charge

    adresse*

    String

    Adresse cible

    API-KEY*

    String

    Votre clé API

    address

    String

    Adresse cible

    chain

    String

    Chaîne cible

    is_address_valid

    Boolean

    Si l'adresse est conforme au format d'adresse de la blockchain cible

    entity_info

    Object

    Informations de l'entité de l'adresse, sous-champs listés ci-dessous

    risk_type

    string

    Types de risque, y compris Propriété (risque d'entité) et Contrepartie (interaction directe avec une adresse à risque)

    risk_label

    string

    Label de risque

    risk_category

    string

    Catégorie de label de risque

    risk_source

    object

    Lorsque le risk_type est 'Contrepartie', les sous-champs suivants fournissent les informations de la source du risque.

    Appendice 1 : Glossaire
    {
    	"code": 200,
    	"msg": "OK",
    	"data": {
        	"address": "0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc",
        	"chain": "ETH",
        	"is_address_valid": true,
        	"entity_info": {
            	"entity": "TORNADO.CASH",
            	"name_tag": "Tornado.Cash: 0.1 ETH",
            	"contract_name": "TornadoCash_Eth_01"
        	},
        	"risk_indicators": [
            	{
                	"risk_type": "Ownership",
                	"risk_label": "OFAC SANCTIONED",
                	"risk_category": "SANCTIONED"
            	},
            	{
                	"risk_type": "Ownership",
                	"risk_label": "TORNADO.CASH",
                	"risk_category": "MIXER"
            	}
        	],
        	"risk_level": 5
    	}
    }
    curl --location 'https://aml.blocksec.com/api/risk/v1/adresse/eth/0x12d66f87a04a9e220743712ce6d9bb1b5616b8fc' \
    --header 'API-KEY: $ApiKey' 
    Sous-champs du champ risk_indicators

    Étiquette d'adresse

    Obtenez des étiquettes pour une seule adresse

    Retourne les informations de l'étiquette pour une adresse cible

    GET https://aml.blocksec.com/api/aml/v2/address

    Paramètres de chemin

    Nom
    Type
    Description

    En-têtes

    Nom
    Type
    Description

    Exemple de réponse

    • code: Entier. Code d'erreur.

      • 200: Pas d'erreur.

    Obtenez des étiquettes pour plusieurs adresses

    GET https://aml.blocksec.com/api/aml/v2/addresses

    Paramètres de chemin

    Nom
    Type
    Description

    En-têtes

    Nom
    Type
    Description

    Exemple de requête

    Exemple de réponse

    Le format de réponse est cohérent avec le résultat retourné par la requête d'adresse unique.

    • code: Entier. Code d'erreur.

      • 200

    Paramètres de données de réponse

    Champ
    Type
    Description

    Pour les mots en italique, référez-vous à pour des explications.

    Sous-champs du champ étiquettes

    Champ
    Type
    Description
    autre: Une erreur survient.
  • msg: Chaîne

    • Si le code n'est pas 200, ce champ indique les informations d'erreur détaillées.

  • data: Tableau

    • Liste des informations de l'étiquette de l'adresse demandée. Voir Paramètre des données de réponse pour plus de détails.

  • : Pas d'erreur.
  • autre: Une erreur survient.

  • msg: Chaîne

    • Si le code n'est pas 200, ce champ indique les informations d'erreur détaillées.

  • data: Tableau

    • Liste des informations de l'étiquette de l'adresse demandée. Voir Paramètre des données de réponse pour plus de détails.

  • *labels

    Object

    Informations sur l'étiquette, voir pour plus de détails

    compatible_chain_labels

    Array

    Retourne les étiquettes sur les chaînes compatibles si la chaîne cible ne dispose d'aucune information. Voir pour plus de détails

    risk

    Integer

    Score de risque

    > category

    String

    La catégorie de l'Entité

    > entity_property

    String

    Propriété de l'entité

    > confidence

    Integer

    La Confiance des informations sur l'entité

    property_info

    Object

    Informations sur la propriété, sous-champs listés ci-dessous

    > address_property

    String

    Propriété de l'adresse

    > category

    String

    La catégorie de la propriété de l'adresse

    > confidence

    Integer

    La Confiance de la propriété de l'adresse

    contract_info

    Object

    Informations sur le contrat si c'est une adresse de contrat, sous-champs listés ci-dessous

    > contract_name

    String

    Nom du contrat

    > token_name

    String

    Nom du jeton si c'est un contrat de jeton

    name_tag

    String

    Étiquette de nom

    others

    Array

    Liste des informations sur l'étiquette, sous-champs listés ci-dessous

    > label

    String

    Étiquettes qui ne relèvent pas des champs ci-dessus

    > confidence

    Integer

    La Confiance pour chaque étiquette

    chain*

    String

    nom de la chaîne, voir chaînes supportées

    address*

    String

    adresse cible

    API-KEY*

    String

    Votre clé API

    chain*

    String

    nom de la chaîne, voir chaînes supportées

    addresses*

    String

    Adresses cibles connectées dans une seule chaîne en utilisant ', ' comme séparateurs. Le nombre d'adresses dans une seule requête ne doit pas dépasser 100.

    API-KEY*

    String

    Votre clé API

    address

    String

    Adresse cible

    is_address_valid

    Boolean

    Si l'adresse est conforme au format d'adresse de la blockchain cible

    chain

    String

    Blockchain cible

    is_contract

    Boolean

    Si l'adresse cible est un contrat

    chain

    String

    La chaîne à laquelle l'adresse appartient. Disponible pour compatible_chain_labels

    entity_info

    Object

    Informations sur l'entité, sous-champs listés ci-dessous

    > entity_type

    String

    ‘first’ indique l'Entité, ‘second’ indique la Deuxième Entité

    > entity

    String

    Le nom de l'Entité

    Annexe 1 : Glossaire
    curl --location 'https://aml.blocksec.com/api/aml/v2/address/eth/0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff' \
    --header 'API-KEY: $ApiKey'
    {
        "code": 200,
        "data": [
            {
                "address": "0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff",
                "is_address_valid": true,
                "chain": "ETH",
                "is_contract": false,
                "labels": {
                    "entity_info": [
                        {
                            "entity_type": "first",
                            "entity": "HUOBI",
                            "category": "CEX",
                            "confidence": 8
                        }
                    ],
                    "property_info": [
                        {
                            "address_property": "DEPOSIT ADDRESS",
                            "confidence": 8
                        },
                        {
                            "address_property": "EXPLOIT",
                            "category": "ATTACKER",
                            "confidence": 9
                        }
                    ],
                    "name_tag": "Exploiteur du Pont Ronin 27",
                    "others": [
                        {
                            "label": "EXPLOIT DU PONT RONIN",
                            "confidence": 9
                        }
                    ]
                },
                "risk": 5
            }
        ]
    }
    
    curl --location 'https://aml.blocksec.com/api/aml/v2/addresses/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x0191e884bf8e21e138e161da520f94d4bbc79c1c' \
    --header 'API-KEY: $ApiKey'
    {
        "code": 200,
        "data": [
            {
                "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                "is_address_valid": true,
                "chain": "ETH",
                "is_contract": true,
                "labels": {
                    "entity_info": [
                        {
                            "entity_type": "first",
                            "entity": "CENTRE",
                            "confidence": 9
                        }
                    ],
                    "contract_info": {
                        "contract_name": "FiatTokenProxy",
                        "token_name": "USD Coin (USDC)"
                    },
                    "name_tag": "Circle: Token USDC",
                    "others": [
                        {
                            "label": "CIRCLE",
                            "confidence": 9
                        },
                        {
                            "label": "STABLECOIN",
                            "confidence": 9
                        },
                        {
                            "label": "CONTRAT DE JETON",
                            "confidence": 9
                        },
                        {
                            "label": "USDC",
                            "confidence": 9
                        }
                    ]
                },
                "risk": 2
            },
            {
                "address": "0x8672867cb976c723d600d810b419d439133fca7a",
                "is_address_valid": true,
                "chain": "ETH",
                "is_contract": true,
                "labels": {
                    "entity_info": [
                        {
                            "entity_type": "first",
                            "entity": "BITTREX",
                            "category": "CEX",
                            "confidence": 9
                        }
                    ],
                    "property_info": [
                        {
                            "address_property": "ADRESSE DE DÉPÔT",
                            "confidence": 9
                        }
                    ],
                    "contract_info": {
                        "contract_name": "UserWallet"
                    }
                },
                "risk": 1
            }
        ]
    }
    Sous-champs du champ étiquettes
    Sous-champs du champ étiquettes