Links

Blacklist Detection System API (Optional)

post
/v1/code/bl
Detect the risk of a virtual asset wallet address being blacklisted and return the corresponding result.
By providing a virtual asset wallet address, this API detects the risks related to the wallet address.
The risk detection results for the wallet address are provided as "BLACK/GRAY/WHITE/UNKNOWN," and if the detection results correspond to "BLACK" and "GRAY," additional information on the type of criminal damage is provided.
  • The blacklisted wallet address detection API is operated jointly by Code and UpSecurities.
  • For inquiries and applications, please contact the CODE manager at [email protected].
REQUEST Body Schema: application/jsonRequest
  • walletAddress(Required): This is a virtual asset wallet address.
  • chain(Optional):This is the symbol for the virtual asset. (For example, "ETH" instead of Ethereum or Ether.)
{
"walletAddress": "0x67c9c03dC2aa8C7EcB6b30494aA757367ed2981C"
"chain" : "ETH"
}
Response
200 OK
RESPONSE SCHEMA: application/json
  • result(Required): This is the blacklist detection result for the requested wallet address.
    • NORMAL: Normal response.
    • ERROR: Error response.
  • reasonMsg(Optional) : In case of an error, this defines the detailed message.
  • id(Required) : This is the traffic ID generated when the request was made.
  • walletAddress(Required) : This is the requested virtual asset wallet address.
  • securityCategory(Required) : This is the detection result (risk level) for the requested virtual asset wallet address.
    • BLACK : Highly suspicious
    • GRAY : Suspicious
    • WHITE : Normal
    • UNKNOWN : Unknown (Can't verify the risk assessment of the wallet address)
  • securityTags(Optional) : If the requested virtual asset wallet address is "BLACK" or "GRAY," information on the type of criminal damage is provided.

Normal response

{
"result": "NORMAL"
"id": "dummy-0313013706-57359efa",
"walletAddress": "0x67c9c03dC2aa8C7EcB6b30494aA757367ed2981",
"securityCategory": "BLACK",
"securityTags": [Gambling, Malware, Darknet]
}

Error response

{
"result": "ERROR"
"reasonMsg" : "Connect timed out",
"id": "dummy-0313013706-57359efa",
"walletAddress": "0x67c9c03dC2aa8C7EcB6b30494aA757367ed2981"
}

In case of not entering the required parameters

422 Unprocessable Entity
RESPONSE SCHEMA: application/json
{
"errorType": "INVALID_MSG_FIELD_VALUE",
"errorMsg": "[walletAddress] Please enter a value."
}

In case of requesting without subscribing to the service

422 Unprocessable Entity
RESPONSE SCHEMA: application/json
{
"errorType": "INVALID_ORIGIN",
"errorMsg": "That feature is not supported."
}