{"openapi":"3.1.0","info":{"title":"HexScan Token Security Scanner API","version":"1.0.0","description":"Is this token safe to buy? Honeypot detection, rug-pull and scam check for any ERC-20 token. Risk score 0-100 from our on-chain checks plus GoPlus. Not an audit. $0.10/scan via x402.","contact":{"name":"HexScan","url":"https://hexscan.xyz","email":"rowan@basecradle.com"}},"servers":[{"url":"https://hexscan.xyz"}],"paths":{"/scan":{"post":{"summary":"Scan a token contract for security risks","description":"Check any ERC-20 token for honeypot, rug-pull, tax analysis, source verification, and on-chain checks. Risk score 0-100 from our on-chain checks plus GoPlus. Not an audit.","x402":{"price":"$0.10 USDC","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x841Ef35b7b7ee4C820BFF040369a8Ade4741b45d"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"ERC-20 contract address (0x...)","example":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"},"chain":{"type":"string","description":"Blockchain name","enum":["ethereum","base","arbitrum","optimism","polygon","bsc","avalanche"],"example":"ethereum"}},"required":["address","chain"]}}}},"responses":{"200":{"description":"Risk triage result","content":{"application/json":{"schema":{"type":"object","properties":{"riskScore":{"type":"integer","minimum":0,"maximum":100,"description":"Composite risk score"},"riskLevel":{"type":"string","enum":["MINIMAL","LOW","MEDIUM","HIGH","CRITICAL"]},"tokenName":{"type":"string","nullable":true},"tokenSymbol":{"type":"string","nullable":true},"findings":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH","CRITICAL"]},"title":{"type":"string"},"description":{"type":"string"},"confidence":{"type":"number"},"source":{"type":"string"}}}},"summary":{"type":"string"},"settleTx":{"type":"string","nullable":true,"description":"On-chain settlement transaction hash"}}}}}},"400":{"description":"Invalid payment format"},"402":{"description":"Payment required -- x402 challenge in headers"},"500":{"description":"Internal error"}}},"get":{"summary":"Get payment challenge (same as POST without body)","responses":{"402":{"description":"Payment required -- x402 challenge"}}}},"/honeypot":{"post":{"summary":"Honeypot check -- is this token a honeypot?","description":"Fast honeypot detection. Checks if a token can be bought but not sold, plus buy/sell tax.","x402":{"price":"$0.001","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"chain":{"type":"string"}},"required":["address"]}}}},"responses":{"200":{"description":"Honeypot check result"},"402":{"description":"Payment required"}}}},"/simulate":{"post":{"summary":"Simulate buy-then-sell -- can you actually sell this token?","description":"Real on-chain transfer simulation via eth_call. Checks if a holder can transfer tokens out. Returns canBuy, canSell, revertReason, and verdict.","x402":{"price":"$0.01","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x841Ef35b7b7ee4C820BFF040369a8Ade4741b45d"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"ERC-20 contract address (0x...)"},"chain":{"type":"string","description":"Blockchain name","enum":["ethereum","base","arbitrum","optimism","polygon","bsc","avalanche"]}},"required":["address","chain"]}}}},"responses":{"200":{"description":"Simulation result with canBuy, canSell, verdict, revertReason"},"402":{"description":"Payment required -- x402 challenge"}}},"get":{"summary":"Get payment challenge","responses":{"402":{"description":"Payment required -- x402 challenge"}}}},"/health":{"get":{"summary":"Service health","responses":{"200":{"description":"Service status JSON"}}}},"/llms.txt":{"get":{"summary":"Agent-readable documentation","responses":{"200":{"description":"Plain text catalog"}}}}}}