Skip to main content
POST
/
v0
/
token
/
scan
curl --request POST \
  --url https://api.blockaid.io/v0/token/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "ethereum",
  "address": "0x66587563e933bbf3974b89156b47bb82b921eb35"
}
'
{
  "result_type": "Benign",
  "malicious_score": "<string>",
  "attack_types": {},
  "chain": "arbitrum",
  "address": "<string>",
  "metadata": {
    "type": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "image_url": "<string>",
    "description": "<string>",
    "deployer": "<string>",
    "deployer_balance": {
      "amount": 123,
      "amount_wei": "<string>"
    },
    "contract_balance": {
      "amount": 123,
      "amount_wei": "<string>"
    },
    "owner_balance": {
      "amount": 123,
      "amount_wei": "<string>"
    },
    "owner": "<string>",
    "creation_timestamp": "<string>",
    "external_links": {
      "homepage": "<string>",
      "twitter_page": "<string>",
      "telegram_channel_id": "<string>"
    },
    "urls": [
      "<string>"
    ],
    "malicious_urls": [
      "<string>"
    ],
    "token_creation_initiator": "<string>",
    "mint_authority": "<string>",
    "update_authority": "<string>",
    "freeze_authority": "<string>"
  },
  "fees": {
    "transfer": 123,
    "transfer_fee_max_amount": 123,
    "buy": 123,
    "sell": 123
  },
  "features": [],
  "trading_limits": {
    "max_buy": {
      "amount": 123,
      "amount_wei": "<string>"
    },
    "max_sell": {
      "amount": 123,
      "amount_wei": "<string>"
    },
    "max_holding": {
      "amount": 123,
      "amount_wei": "<string>"
    },
    "sell_limit_per_block": {
      "amount": 123,
      "amount_wei": "<string>"
    }
  },
  "financial_stats": {
    "supply": 123,
    "holders_count": 123,
    "usd_price_per_unit": 123,
    "burned_liquidity_percentage": 123,
    "locked_liquidity_percentage": 123,
    "top_holders": [],
    "total_reserve_in_usd": 123
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
chain
enum<string>
required

The chain name

Available options:
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,
zero-network,
berachain,
unichain,
ronin,
sui,
hedera
​
address
string
required

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

​
metadata
object

Object of additional information to validate against.

Response

Successful Response

​
result_type
enum<string>
required

General indication

Available options:
Benign,
Warning,
Malicious,
Spam
​
malicious_score
string
required

Score between 0 to 1 (double)

​
attack_types
object
required

Dictionary of detected attacks found during the scan

​
chain
enum<string>
required

Blockchain network

Available options:
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,
zero-network,
berachain,
unichain,
ronin,
sui,
hedera
​
address
string
required

Token address to validate (EVM / Solana)

​
metadata
object
required

Metadata of the token

​
fees
object
required

Fees associated with the token

​
trading_limits
object
required

Trading limits of the token

​
financial_stats
object
required

financial stats of the token

​
features
Feature · object[]

List of features associated with the token