BLblockaid-official
Token

Scan Token

Changed on

Gets a token address and scan the token to identify any indication of malicious behavior

post/v0/token/scan

Request

Request body

chain'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'zora' | 'solana' | 'starknet' | 'starknet-sepolia' | 'stellar' | 'linea' | 'degen' | 'zksync' | 'scroll' | 'blast' | 'soneium-minato' | 'base-sepolia' | 'bitcoin' | 'abstract' | 'soneium' | 'ink' | 'berachain' | 'unichain' | 'ronin' | 'sui' | 'hedera' | 'hyperevm' | 'xlayer' | 'monad' | 'megaeth' | 'tempo' | 'sei' | 'kaia' | 'tron' | 'robinhood' | 'flare' | 'arc' required

The chain name

addressstring required

Token address to validate (EVM / Solana / Stellar / Starknet)

token_idinteger nullable

The ID of the specific NFT within an ERC-721 or ERC-1155 collection.

Response

Successful Response

result_type'Benign' | 'Warning' | 'Malicious' | 'Spam' required
malicious_scorestring required

Score between 0 to 1 (double)

attack_typesobject required

Dictionary of detected attacks found during the scan

chain'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'zora' | 'solana' | 'starknet' | 'starknet-sepolia' | 'stellar' | 'linea' | 'degen' | 'zksync' | 'scroll' | 'blast' | 'soneium-minato' | 'base-sepolia' | 'bitcoin' | 'abstract' | 'soneium' | 'ink' | 'berachain' | 'unichain' | 'ronin' | 'sui' | 'hedera' | 'hyperevm' | 'xlayer' | 'monad' | 'megaeth' | 'tempo' | 'sei' | 'kaia' | 'tron' | 'robinhood' | 'flare' | 'arc' required

The chain name

addressstring required

Token address to validate (EVM / Solana)

Example response

{
  "financial_stats": {
    "dev_holding_percentage": 18.8,
    "initial_snipers_holding_percentage": 18.8,
    "snipers_holding_percentage": 18.8,
    "bundlers_holding_percentage": 18.8,
    "insiders_holding_percentage": 18.8
  }
}

Changes

  • 104550c9d3f1Revision changes
    • warning

      added the new METADATA_PROMPT_INJECTION enum value to the // response property for the response status

  • 421a1aca41d2Revision changes
    • warning

      added the new arc enum value to the response property for the response status

    • info

      added the new arc enum value to the request property