Scanner API Overview

The Scanner API performs a comprehensive security analysis of any token contract, returning a structured report that covers ownership risks, honeypot detection, tax configuration, liquidity locks, and top holder distribution.

What It Does

When you scan a token, InsightX inspects the on-chain state of the contract and its surrounding ecosystem to answer the key questions every trader and integrator needs:

Is this token safe to trade? -- The simple score gives a quick 0-100 safety rating.
Can the creator drain liquidity or freeze transfers? -- Authority and permission checks reveal contract-level risks.
Is there a hidden tax or honeypot? -- Honeypot simulation and tax analysis detect traps.
Is liquidity locked? -- LP lock data shows whether liquidity can be pulled.
Who holds the most tokens? -- Top holder breakdown and creator balance reveal concentration risk.

Endpoint

GET /scanner/v1/tokens/{network}/{token_address}

Parameter	Type	Description
`network`	path	Network ID: `sol`, `eth`, `base`, `bsc`
`token_address`	path	Token contract address

Response Structure

Every scan returns a consistent top-level structure regardless of network:

{
  "network": {
    "name": "Solana",
    "symbol": "SOL"
  },
  "token": {
    "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
    "name": "Pump.com",
    "symbol": "PUMP",
    "logo": "https://...",
    "decimals": 6,
    "total_supply": 1000000000.0,
    "additional_info": {},
    "age": 1712218394,
    "socials": [
      { "type": "twitter", "url": "https://twitter.com/..." },
      { "type": "website", "url": "https://..." }
    ]
  },
  "extensions": {},
  "results": {
    "generated_at": 1756397766,
    "simple": {
      "score": 87,
      "message": "OK",
      "reasons": []
    },
    "advanced": {}
  }
}

Top-Level Fields

Field	Type	Description
`network`	object	Network name and symbol
`token`	object	Token metadata (name, symbol, supply, age, socials)
`extensions`	object	Chain-specific raw data (e.g. Token-2022 extensions on Solana, Metaplex metadata)
`results`	object	The actual scan results

`token` Object

Field	Type	Description
`address`	string	Token contract address
`name`	string	Token name
`symbol`	string	Token ticker symbol
`logo`	string or null	URL to token logo image
`decimals`	integer	Token decimal places
`total_supply`	number	Total token supply (in human-readable units)
`additional_info`	object or null	Chain-specific metadata
`age`	integer or null	Unix timestamp of token creation
`socials`	array	Social links (`type` + `url`) parsed from on-chain metadata

`results` Object

Field	Type	Description
`generated_at`	integer	Unix timestamp of when this scan was generated
`simple`	object	Quick safety summary
`advanced`	object	Detailed security indicators (chain-specific -- see child pages)

Simple Score

The simple result gives a quick safety assessment:

Field	Type	Description
`score`	integer	Safety score from 0 (dangerous) to 100 (safe)
`message`	string	Score label (e.g. `"OK"`, `"Caution"`, `"High Risk"`)
`reasons`	array	List of specific risk identifications (e.g. `["Mint authority not renounced"]`). Empty when no risks are found.

The simple score is derived from the advanced indicators. A score below 60 generally indicates significant risks were found. The message field provides a human-readable label, while reasons contains the individual findings that contributed to the score.

Advanced Results

The advanced object contains the detailed, chain-specific security indicators. The fields differ between Solana and EVM networks: