Skip to main content

Address Analysis API

Endpoint

https://api.hashdit.io/security-api/public/chain/v1/detect/address
HeaderDescription
Content-Typeapplication/json;charset=UTF-8
X-Signature-appidAppid, unique code
X-Signature-timestampTimestamp, millisecond
X-Signature-nonceRandom uuid, replace “-” with “”,32 byte length
X-Signature-signatureSignature,lowercase,check below for sign details

Body

NameRequiredTypeDescriptionExample
chain_idYesStringThe chain id of the blockchain1 - Ethereum
56 - BSC
137 - Polygon
addressYesStringAddress that needs to be analyzed0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c

Response

NameNullableTypeExample
statusNoStringOK/ERROR
codeNoString00001:verify signature error
> appid, timestamp, nonce, signature headers can not be null or empty
> nonce is illegal
> timestamp has illegal
> timestamp is expired
> invalid appid
> appid has expired
> invalid signature
> replay request
> app is out of count limit
00002:unknown server error occurred during verifying signature
00003:unknown server error occurred during detection
dataYesString
data.request_idNoStringUnique request id
data.has_resultNoBooleanWhether there is already a definite result, if False, it needs to be requested in [polling_interval] million seconds
data.polling_intervalYesLongRecommended waiting time(million seconds) to the next repeat request. seconds
data.risk_levelYesInteger-1: Invalid
0: Very Low Risk
1: Some Risk
2: Low Risk
3: Medium Risk
4: High Risk
5: Significant Risk
data.risk_detailYesStringSee Risk Detail
[{
"name": "scam",
"value": "The contract has some scam features such as Ponzi, Honeypot or fake token, please be careful of scam risk."
},
{
"name": "blacklist",
"value": "The address is blacklisted based on threat intelligence or manual analysis."
}]

Risk Detail

The risk_detail will comprise of an array of objects, the object contain the following fields name : name of the check. value: check result

NameValue
whitelistThe address is whitelisted based on threat intelligence or manual analysis.
blacklistThe address is blacklisted based on threat intelligence or manual analysis.
unverifiedThe contract is unverified which always indicates some potential risks, please be careful of scam or hack risk.
mixcoin-relatedThe address is related to a coin mixer platform such as Tornado.Cash, which could mean some potential risks, please be careful of scam risk
centralizationThe contract contains some privileged role function which could mean some centralization risk, please be careful of rugpull risk.
backdoor-functionThe contract contains some backdoor function which could mean the owner has some potentially malicious intent, please be careful of rugpull risk.
business-issueThe contract contains some business logic bug which always mean it would be a potential attack target, please be careful of hack risk.
behavior-issueThe address is found to be associated with some already known malicious addresses.
red_alarmThe address was marked as red alarm on: {redalarm url}
scamThe contract has some scam features such as Ponzi, Honeypot or fake token, please be careful of scam risk.
spoofed_addressThe address is potentially a spoofing related address. Please check again if this is your intended receiver address.