Get Risk Score

Returns the risk score, and risk detail list for a given address or transaction hash.

Note: This API calculates the risk score based on all transactions related to the address in question. Therefore, all tokens owned by the address will receive the same score. This is a POST type API

https://www.spyderlab.org/api/v1/risk-score

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Type	Description
keyword	string	the address to check for risk score, one of address and txid must be passed.
x-api-key	string	your api key pass in header

Response

Response Data Parameters

Parameter	Type	Description
score	int	Risk Score for the query address, range: 3 ~ 100
hacking_event	string	Related security event/incident name for the query address
detail_list	list	Risk description for the query address
risk_level	string	Risk level, Low / Moderate / High / Severe
risk_detail	list	Data for the risk score calculation process

Sample Response

{
    "success":true,
    "msg":"",
    "data":{
        "score":3,
        "hacking_event":"",
        "detail_list":[
            "Interact With Malicious Address",
            "Interact With High-risk Tag Address",
            "Interact With Medium-risk Tag Addresses"
        ],
        "risk_level":"Low",
        "risk_detail":[
            {
                "label":"Tornado.Cash: Router",
                "type":"high_risk",
                "volume":1338984,
                "address":"0xd90e2f925da726b50c4ed8d0fb90ad053324f31b",
                "percent":0.453
            },
            {
                "label":"Tornado.Cash: L1 Helper",
                "type":"high_risk",
                "volume":1859.7,
                "address":"0xca0840578f57fe71599d29375e16783424023357",
                "percent":0.001
            },
            {
                "label":"Tornado.Cash: Proxy",
                "type":"high_risk",
                "volume":1487760,
                "address":"0x722122df12d4e14e13ac3b6895a86e84145b6967",
                "percent":0.503
            },
            {
                "label":"Tornado.Cash: 10 ETH",
                "type":"high_risk",
                "volume":167204.511,
                "address":"0x910cbd523d972eb0a6f4cae4618ad62622b39dbf",
                "percent":0.057
            },
            {
                "label":"HitBTC",
                "type":"medium_risk",
                "volume":76090.41,
                "address":"0x9c67e141c0472115aa1b98bd0088418be68fd249",
                "percent":0.026
            }
        ]
    }
}

Risk Descriptions For detail_list

Risk Item	Risk Description
Malicious Address	Address directly involved in malicious events, Example: DeFi protocol exploiters, centralized exchange hackers, sanctioned addresses, etc.
Suspected Malicious Address	Address associated with malicious events
High-risk Tag Address	High-risk entity address, Example: Mixers, some nested exchanges, etc.
Medium-risk Tag Address	Medium-risk entity address, Example: Gambling, exchanges not requiring KYC, etc.
Mixer	Mixer entity address, Example: Tornado Cash, etc.
Risk Exchange	Exchanges that do not require KYC
Gambling	Gambling entity address
Involved Theft Activity	Address involved in theft events
Involved Ransom Activity	Address involved in ransom events
Involved Phishing Activity	Address involved in phishing events
Interact With Malicious Address	Interactions with malicious address
Interact With Suspected Malicious Address	Interactions with suspected malicious address
Interact With High-risk Tag Address	Interactions with high-risk address
Interact With Medium-risk Tag Addresses	Interactions with medium-risk address

Risk Level Guide

Risk Level	Risk Score	Suggested Operations
Severe	91 ~ 100	Prohit withdrawals & trade, and report address immediately
High	71 ~ 90	Maintain high level surveillance, and analyze via Spyderlab AML platform or OpenAPI to conduct transaction analysis
Moderate	31 ~ 70	Moderate supervision required
Low	0 ~ 30	Minimal supervision required