Address Label

Get labels for a single address

Return label information for a target address

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

Path Parameters

Name	Type	Description
chain*	String	chain name, see supported chains
address*	String	target address

Headers

Name	Type	Description
API-KEY*	String	Your API Key

Request

curl --location 'https://aml.blocksec.com/api/aml/v2/address/eth/0x5b5082214d62585d686850ab8d9e3f6b6a5c58ff' \
--header 'API-KEY: $ApiKey'

Response

Sample Response

{
    "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": "Ronin Bridge Exploiter 27",
                "others": [
                    {
                        "label": "RONIN BRIDGE EXPLOIT",
                        "confidence": 9
                    }
                ]
            },
            "risk": 5
        }
    ]
}

• code: Integer. Error code.

  • 200: No error.

  • other: Error occurs.

• msg: String

  • If the code is not 200, this field denotes the detailed error information.

• data: Array

  • List of the label information of the request address. See Response Data Parameter for detail.

Get labels for multiple addresses

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

Path Parameters

Name	Type	Description
chain*	String	chain name, see supported chains
addresses*	String	Target addresses that connected into a single string using ', ' as separators. The number of addresses in a single request should not exceed 100.

Headers

Name	Type	Description
API-KEY*	String	Your api key

200: OK

Request

Sample Request

curl --location 'https://aml.blocksec.com/api/aml/v2/addresses/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0x0191e884bf8e21e138e161da520f94d4bbc79c1c' \
--header 'API-KEY: $ApiKey'

Response

Sample Response

{
    "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: USDC Token",
                "others": [
                    {
                        "label": "CIRCLE",
                        "confidence": 9
                    },
                    {
                        "label": "STABLECOIN",
                        "confidence": 9
                    },
                    {
                        "label": "TOKEN CONTRACT",
                        "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": "DEPOSIT ADDRESS",
                        "confidence": 9
                    }
                ],
                "contract_info": {
                    "contract_name": "UserWallet"
                }
            },
            "risk": 1
        }
    ]
}

The response format is consistent with the result returned by the single-address query.

• code: Integer. Error code.

  • 200: No error.

  • other: Error occurs.

• msg: String

  • If the code is not 200, this field denotes the detailed error information.

• data: Array

  • List of the label information of the request address. See Response Data Parameter for detail.

Response Data Parameters

Field	Type	Description
address	String	Target address
is_address_valid	Boolean	Whether the address conforms to the address format of the target blockchain
chain	String	Target blockchain
is_contract	Boolean	Wherther the target address is a contract
*labels	Object	Label info, see Subfields of the labels field for details
compatible_chain_labels	Array	Return labels on compatible chains if the target chain dose not have any information. See Subfields of the labels field for details
risk	Integer	Risk Score

For italic words， refer to Appendix 1: Glossary for explanations.

Subfields of the labels field

Field	Type	Description
chain	String	The chain the address belongs to. Avaliable for compatible_chain_labels
entity_info	Object	Entity information, subfields listed below
> entity_type	String	‘first’ indicates the Entity, ‘second’ indicates the Secondary Entity
> entity	String	The name of Entity
> category	String	The category of Entity
> entity_property	String	Entity Property
> confidence	Integer	The Confidence of entity info
property_info	Object	Property information, subfields listed below
> address_property	String	Address Property
> category	String	The category of address property
> confidence	Integer	The Confidence of address property
contract_info	Object	Contract information if it's a contract address, subfields listed below
> contract_name	String	Contract name
> token_name	String	Token name if it's a token contract
name_tag	String	Name Tag
others	Array	List of label information, subfields listed below
> label	String	Labels do not fall into the above fields
> confidence	Integer	The Confidence for each label