ScanHood

Composite on-chain safety verdict for any Robinhood-Chain (chain 4663) token: honeypot buy+sell simulation, LP-lock status, contract verification, deployer reputation, RWA-impostor detection. Returns PASS/CAUTION/DANGER.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "ERC-20 token address, 0x + 40 hex chars"
    },
    "api_key": {
      "description": "Optional paid-scan API key. Free tier is 500 scans/day per IP; after that pay $0.005/scan in ETH on Robinhood Chain (see a 402 response or get_scan_pricing).",
      "type": "string"
    },
    "payment": {
      "description": "Optional X-Payment value, base64(JSON {txid, signature}), to redeem an ETH payment and receive an API key with credits.",
      "type": "string"
    }
  },
  "required": [
    "token"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free quota, price per scan, the Robinhood Chain treasury address, live wei amounts, and the step-by-step pay-and-retry recipe for when scan_token returns error free_quota_exceeded.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find any Robinhood-Chain token by symbol, name, or address across the whole chain (not just the top pairs).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "symbol, name, or 0x address"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

On-chain OHLCV candles for a pool, for charting/backtesting.

{
  "type": "object",
  "properties": {
    "pool": {
      "type": "string",
      "description": "pool/pair address, 0x + 40 hex chars"
    },
    "timeframe": {
      "default": "1h",
      "type": "string",
      "enum": [
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
      ]
    }
  },
  "required": [
    "pool"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fundamentals for every US stock Robinhood has tokenized on Robinhood Chain (194 total, refreshed every 15min from public market data): price, market cap, trailing+forward P/E, EPS, price-to-book, dividend yield, 52-week high/low position, and on-chain "basis" — how far the on-chain pool price sits from the real listed price (spot a genuine discount or a broken pool before trading; a withheld basis means the pool price is implausible, not merely missing). Pass a symbol for one stock, or omit it for the full list.

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "stock ticker, e.g. AAPL — omit for the full list of all 194",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read-only swap quote (no execution) for a token against the ScanHood swap contract — expected output for a given ETH-in (buy) or token-in (sell).

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "token address"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "amount": {
      "type": "string",
      "description": "ETH amount (buy) or token amount (sell), as a decimal string"
    }
  },
  "required": [
    "token",
    "side",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read-only quote (no execution) for bridging native ETH/BNB between Robinhood Chain and Ethereum, Base, Arbitrum, or BNB Chain, via relay.link — the same route ScanHood's own Bridge tab uses. No ScanHood fee. Returns amountOut, an ETA in seconds, relay's own fee in USD, and the raw unsigned deposit tx (to/value/data) for the caller's own wallet to sign and send on the fromChain — ScanHood never holds funds or keys.

{
  "type": "object",
  "properties": {
    "fromChain": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "source chain id — one of 4663 (Robinhood), 1 (Ethereum), 8453 (Base), 42161 (Arbitrum), 56 (BNB Chain)"
    },
    "toChain": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "destination chain id — same supported set as fromChain, must differ from it"
    },
    "amount": {
      "type": "string",
      "description": "native-token amount to bridge (ETH, or BNB if fromChain is 56), as a decimal string"
    },
    "user": {
      "description": "wallet address that will send the bridge — improves quote accuracy, optional",
      "type": "string"
    }
  },
  "required": [
    "fromChain",
    "toChain",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build (but do not sign or send) a launchToken transaction against ScanHood's live no-rug launchpad on Robinhood Chain — either Uniswap V3 (anti-snipe protection, supports an atomic initial buy) or V4 (Uniswap's newest, no anti-snipe window). Returns raw unsigned tx fields (to, data, value, gas) for the caller's own wallet to sign and broadcast — ScanHood never holds funds or keys. On success the token's liquidity is locked (V3: locker-held position; V4: locker-held one-sided position) and cannot be pulled.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "token name"
    },
    "symbol": {
      "type": "string",
      "description": "token symbol/ticker"
    },
    "version": {
      "description": "which launchpad to use — \"v3\" (default, has anti-snipe protection + atomic initial buy) or \"v4\" (Uniswap V4, no anti-snipe window, no atomic initial buy)",
      "type": "string",
      "enum": [
        "v3",
        "v4"
      ]
    },
    "logo": {
      "description": "logo image URL",
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "feeWallet": {
      "description": "address that receives your share of trading fees (defaults to your own sending address if omitted)",
      "type": "string"
    },
    "initialBuyEth": {
      "description": "ETH amount to buy in the same tx, as a decimal string (default \"0\"). V3 only — V4 launches reject this.",
      "type": "string"
    },
    "initialTick": {
      "description": "V4 only: starting price tick (default -204200, matches the standard launch price used across ScanHood)",
      "type": "number"
    },
    "from": {
      "description": "your wallet address — used only to predict the token address ahead of signing",
      "type": "string"
    }
  },
  "required": [
    "name",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the token addresses a wallet has saved to its ScanHood watchlist.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "wallet address, 0x + 40 hex chars"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Overwrites a wallet's saved token watchlist (up to 200 tokens). Requires a signature proving ownership of the address: sign the exact string in 'message' with that wallet's key (e.g. personal_sign / EIP-191) and pass it as 'signature'. Not usable without real wallet-signing capability.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "wallet address, 0x + 40 hex chars"
    },
    "tokens": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "token addresses to save, up to 200"
    },
    "message": {
      "type": "string",
      "description": "the exact message that was signed"
    },
    "signature": {
      "type": "string",
      "description": "signature of 'message' from 'address'"
    }
  },
  "required": [
    "address",
    "tokens",
    "message",
    "signature"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A wallet's consecutive-day ScanHood usage streak.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "wallet address, 0x + 40 hex chars"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

StockBack pays a share of real ScanHood trading-fee revenue as real tokenized stock, not points. Lists which real tokens are currently earnable and whether a reward auto-routes into a real covered-call yield vault.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Real Pending/Funded/Claimed StockBack state for one wallet. Pending is a promised USD value not yet backed by a purchase; Funded means a real on-chain stock purchase already confirmed and is waiting to be claimed; Claimed means it was already sent to the wallet. Works for any address, including ones that have never earned anything.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "wallet address, 0x + 40 hex chars"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Recent completed token safety scans across all of ScanHood (real activity, not a sample) — powers the "recent rugs caught" / "safe launches today" homepage modules. Optionally filter by verdict.

{
  "type": "object",
  "properties": {
    "verdict": {
      "description": "filter to only this verdict",
      "type": "string",
      "enum": [
        "PASS",
        "CAUTION",
        "DANGER"
      ]
    },
    "limit": {
      "description": "max entries, default 20",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Daily counts of PASS/CAUTION/DANGER verdicts plus a sample of real DANGER catches per day, for up to 60 days back. Powers the weekly "State of the Chain" report.

{
  "type": "object",
  "properties": {
    "days": {
      "description": "how many days back, default 60",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a free, higher-rate-limit (40r/s vs the 5r/s anonymous default) API key for a site that links back to scanhood.xyz. ScanHood fetches the site itself and checks for a real <a> to scanhood.xyz before issuing a key — self-reported claims are rejected. One key per site; re-applying with the same site returns the existing key.

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "description": "URL of the site that links back to scanhood.xyz, e.g. \"https://example.com\""
    },
    "contact": {
      "description": "optional contact info",
      "type": "string"
    }
  },
  "required": [
    "site"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Look up which site a partner key is registered to, when it was issued, and whether it has been upgraded to the paid tier.

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "partner API key, starts with \"sh_\""
    }
  },
  "required": [
    "key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Treasury address and minimum payment to upgrade an existing partner key from the free tier (40r/s) to the paid tier (200r/s) via a Robinhood-Chain ETH payment.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

After sending at least the minimum ETH (see get_paid_tier_info) to the treasury address on Robinhood Chain, submit the transaction hash here to upgrade an existing partner key to the paid tier (200r/s). Verifies the payment on-chain before activating — each txid can only be used once.

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "an existing partner key, starts with \"sh_\""
    },
    "txid": {
      "type": "string",
      "description": "the 32-byte transaction hash of the payment, 0x + 64 hex chars"
    }
  },
  "required": [
    "key",
    "txid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Stats from ScanHood's own arbitrage and fee-claim bots.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Per-token preferences for automatic trading-fee claiming.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Enable or disable automatic fee claiming for a token. Requires a signature proving ownership of 'address': sign the exact string in 'message' with that wallet's key and pass it as 'signature'. Not usable without real wallet-signing capability.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "wallet address, 0x + 40 hex chars"
    },
    "token": {
      "type": "string",
      "description": "token address, 0x + 40 hex chars"
    },
    "enabled": {
      "type": "boolean"
    },
    "message": {
      "type": "string",
      "description": "the exact message that was signed"
    },
    "signature": {
      "type": "string",
      "description": "signature of `message` from `address`"
    }
  },
  "required": [
    "address",
    "token",
    "enabled",
    "message",
    "signature"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}