DeepCounterfeit

Look up a deployed token by contract/mint address and report whether it impersonates a real company, its "official" token or its tokenized stock (e.g. a fake SpaceX, Coinbase or NVDAx coin). Returns verdict (likely_impersonation | brand_mention_watch | not_in_index), matched brands, risk score 0-100 with reasons (creator bought supply at launch, same-block bundles, creator cash-out, serial launcher), creator wallet and explorer links. Use before buying, listing or promoting a token. "not_in_index" only means no brand match was recorded, not that the token is safe. Without an API key: brand match and coin only (flagged as likely impersonation), no risk score, creator wallet or forensics.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Token mint (Solana) or contract address (0x... on BNB Chain, Base, Robinhood Chain)."
    },
    "chain": {
      "type": "string",
      "enum": [
        "solana",
        "bsc",
        "base",
        "robinhood"
      ],
      "description": "Optional chain filter."
    }
  },
  "required": [
    "address"
  ]
}

Run the impersonation detector on a token name and/or ticker symbol without needing an address. Tells you whether a coin called e.g. "SpaceX Official" ($SPACEX) or "TSLAx" would be flagged as impersonating a brand, which brand, and why. Use for pre-launch name checks, or when a user mentions a coin by name and you have no address (with an address, use check_token). Does not assess creator behaviour.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Token name, e.g. \"Coinbase Official Token\"."
    },
    "symbol": {
      "type": "string",
      "description": "Ticker symbol without $, e.g. \"COIN\"."
    },
    "description": {
      "type": "string",
      "description": "Optional token description text."
    }
  }
}

List recent impersonation coins, newest first, filtered by brand, chain, time and severity. Use to answer "are there fake <brand> tokens?", to monitor a brand, or to collect cases for a takedown. Free tier returns alerts older than 24 h only (max 20).

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name, or ticker, e.g. \"spacex\", \"SpaceX\", \"TSLA\". See list_brands."
    },
    "chain": {
      "type": "string",
      "enum": [
        "solana",
        "bsc",
        "base",
        "robinhood"
      ],
      "description": "Optional chain filter (bsc = BNB Chain, robinhood = Robinhood Chain). Omit for all chains."
    },
    "since": {
      "type": "string",
      "description": "Start time: relative (\"24h\", \"7d\", \"30m\"), ISO 8601 (\"2026-10-01\") or unix seconds."
    },
    "severity": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ],
      "description": "high = risk 70+, medium = 50-69."
    },
    "min_risk": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "default": 0,
      "description": "Only alerts with risk score >= this (needs an API key; ignored on the keyless Free tier)."
    },
    "include_watch": {
      "type": "boolean",
      "default": false,
      "description": "Also include watch-tier brand mentions (memes), not just impersonation alerts."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Max alerts to return (Free tier capped at 20). Narrow with since/brand instead of paging."
    }
  }
}

Summarise impersonation activity against one brand over a window: number of fake coins, traded volume, breakdown by chain/match type/severity, repeat creator wallets, how many creators bought 50%+ of supply, and the top cases with evidence. Pro/Wholesale keys also get the takedown-ready PDF link.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand id, name or ticker, e.g. \"anthropic\", \"Coinbase\", \"NVDA\"."
    },
    "days": {
      "type": "number",
      "minimum": 1,
      "maximum": 365,
      "default": 30,
      "description": "Look-back window in days."
    }
  },
  "required": [
    "brand"
  ]
}

List the brands on the watchlist (companies, tokenized stocks, crypto projects, private companies) with ids, tickers and all-time alert counts, most-targeted first. Use to find a brand id or check whether a brand is covered.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional substring of name, id, alias or ticker."
    },
    "category": {
      "type": "string",
      "description": "Optional: sp500, xstock, crypto, private, foreign, consumer, media, finance, sports, stock."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "default": 50,
      "description": "Max brands to return, most-targeted first."
    }
  }
}

Aggregate numbers for a window: alerts, high-severity count, brands hit, by chain, by match type, top brands, data-source health and coverage. Use for overviews, trend questions and to check data freshness.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "minimum": 0.04,
      "maximum": 90,
      "default": 1,
      "description": "Window in days (1 = last 24 h)."
    }
  }
}

Search the impersonation index by brand name, ticker or coin name. Returns result ids for fetch. Prefer search_alerts / check_name when available.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Brand name/ticker (e.g. \"SpaceX\", \"TSLA\") or part of a coin name. Brand matches return that brand's latest alerts; otherwise coin names are substring-matched."
    }
  },
  "required": [
    "query"
  ]
}

Fetch the full check_token result for a result id returned by search (format "<chain>:<address>"): verdict, matched brands, match type and explorer links; with an API key also risk score, reasons and creator facts. Use after search; for a known address call check_token directly.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Result id from search, e.g. \"solana:<mint>\" or \"bsc:0x...\"."
    }
  },
  "required": [
    "id"
  ]
}