{"openapi":"3.0.3","info":{"title":"Token Risk Oracle","version":"1.0.0","description":"Free, public scam/rug-check for meme coins and web3 tokens. Aggregates real on-chain risk signals from GoPlus Security (honeypot detection, mint/ownership authority, holder & LP concentration, buy/sell tax) into one transparent, sourced risk score — EVM chains and Solana. No API key, no payment, no signup: this is a public safety tool, not a paywalled product. Never a bare safe/unsafe claim — always includes a disclaimer and the raw source data.","contact":{"url":"https://token-risk-oracle.wickedapi.com"},"termsOfService":"https://token-risk-oracle.wickedapi.com/"},"servers":[{"url":"https://token-risk-oracle.wickedapi.com","description":"Production"}],"components":{"schemas":{"Envelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","description":"Endpoint-specific payload."},"meta":{"type":"object","required":["timestamp"],"properties":{"timestamp":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"}},"additionalProperties":true}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"source":{"type":"string"}}}}},"tags":[{"name":"meta","description":"Health & service catalog"},{"name":"v1","description":"Token risk data"}],"paths":{"/health":{"get":{"operationId":"get_health","summary":"Liveness check.","description":"Liveness check.","tags":["meta"],"parameters":[],"security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data error — never fabricated, a real source failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/status":{"get":{"operationId":"get_v1_status","summary":"Service catalog.","description":"Service catalog.","tags":["v1"],"parameters":[],"security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data error — never fabricated, a real source failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/token-risk":{"get":{"operationId":"get_v1_token_risk","summary":"Free, public, no signup","description":"Free, public, no signup. Aggregates real on-chain risk signals from GoPlus Security for a token contract — honeypot detection, mint/ownership authority, holder & LP concentration, buy/sell tax, trust-list status — into one transparent risk score. Never a bare safe/unsafe claim: every flag GoPlus didn't return data for stays null, and the raw source data ships alongside the score.","tags":["v1"],"parameters":[{"name":"address","in":"query","required":true,"description":"Required. The token contract address (EVM) or mint address (Solana).","schema":{"type":"string"}},{"name":"chain","in":"query","required":true,"description":"Required. ethereum, bsc, base, polygon, arbitrum, optimism, avalanche, fantom, zksync, linea, scroll, or solana. A numeric EVM chain_id also works.","schema":{"type":"string"}}],"security":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Upstream data error — never fabricated, a real source failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}