Compliance Score

Get compliance risk information for a single address

GET https://aml.blocksec.com/api/risk/v1/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

Sample Request

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

Response

Sample response

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

• 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: Object

  • The detailed risk information of the target address, see the 'Response Data Parameter' for detail.

Response Data Parameter

Field	Type	Description
address	String	Target address
chain	String	Target chain
is_address_valid	Boolean	Whether the address conforms to the address format of the target blockchain
entity_info	Object	Address entity information, subfilds listed below
> entity	String	The name of Entity
> name_tag	String	Name Tag
> contract_name	String	Contract name
> token_name	String	Token name if it's a token contract
risk_indicators	Array	List of risk items, format detailed in the 'Subfields of the risk_inficators field' table below
risk_level	Integer	Risk Score

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

Subfields of the risk_indicators field

Field	Type	Description
risk_type	string	Risk types, including Ownership (entity risk) and Counterparty (direct interation with risky address)
risk_label	string	Risk label
risk_category	string	Category of risk label
risk_source	object	When the risk_type is 'Counterparty', the following subfields provide the risk source information.
> chain	string	Chain where the risk source is located.
> address	string	The risk source address
> entity	string	Entity name of the risk source