Token Scan API

Response

The /v1/token-scan/contract/query API returns a JSON object with the following structure.
For retrieving token scan results in bulk, refer to the batch endpoint: /v1/token-scan/contract/query/batch.

Top-Level Fields

  • code: integer – HTTP status code (e.g., 200)
  • message: string – Message indicating success or failure
  • data: object – Main result containing token insights

data.token_info

  • Standard attributes: address, blockchain, token_type, decimals, supply, deployer_address, token_deploy_time
  • Ownership details: owner, owner_holding_ratio, deployer_holding_ratio, factory_address, factory_address_holding_ratio
  • Activity metrics: active_holder_count

data.token_meta

  • token_name, image (optional)

data.market_info

  • pair_list: LP pairs and their info
  • top_holders: Top 20 Token holders list with balances and holding percentages
  • lp_holders: Top 20 LP holders list with balances and holding percentages. Supports both V2 (standard) and V3 (NFT-based) LP tokens.

data.skyknight_score

  • score: 0-100 token scan score
  • details: Identified risk flags (e.g., is_mintable, has_hidden_owner)

data.security_summary

Detailed token scan results. Each risk flag includes the following:

  • alert: Indicates whether the check is flagged as a risk
    • true: risk detected
    • false: not detected
    • null: unable to detect
  • alert_summary: Summary of the identified risk
  • alert_level: Indicates the severity level of the risk. There are five levels, listed below:
    • Critical: urgent threat
    • Major: significant risk
    • Medium: moderate concern worth monitoring
    • Minor: low-impact issue, often informational or edge-case
    • Informational: general insight or context, not necessarily a risk
  • description: Explanation of what the check evaluates
  • alert_msg: A detailed message describing the specific check
  • extended_data: Additional contextual data for the flagged risk (e.g., percentage)

data.created_at

  • ISO timestamp of the result