{"uid":"cap_9vh8qXMErxVl1axeV-vJj","slug":"api-hyperd-ai-37eab163","name":"HyperD Token Security Risk Score","description":"","url":"https://api.hyperd.ai/api/token/security?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["contract"],"properties":{"chain":{"type":"string"},"contract":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","contract":"0xdAC17F958D2ee523a2206206994597C13D831ec7"}},"output":{"type":"object"}},"response":{"raw":{"buyTax":0,"isInDex":true,"isProxy":false,"sellTax":0,"tokenName":"Tether USD","isHoneypot":false,"isMintable":true,"topHolders":[{"tag":"","address":"0xf977814e90da44bfa03b6295a0616a897441acec","balance":"20468227098.883709","percent":"0.210859059830640440","is_locked":0,"is_contract":0},{"tag":"","address":"0x47ac0fb4f2d84898e4d9e7b4dab3c24507a6d503","balance":"9184997799.482302","percent":"0.094621776042877936","is_locked":0,"is_contract":0},{"tag":"","address":"0x835678a611b28684005a5e2233695fb6cbbb0007","balance":"5876489264.174121","percent":"0.060538267206160983","is_locked":0,"is_contract":0},{"tag":"","address":"0x6c96de32cea08842dcc4058c14d3aaad7fa41dee","balance":"3672949651.257286","percent":"0.037837899028960261","is_locked":0,"is_contract":1},{"tag":"","address":"0x5754284f345afc66a98fbb0a0afe71e0f007b949","balance":"3471590437.047257","percent":"0.035763541812214370","is_locked":0,"is_contract":0}],"holderCount":14605067,"tokenSymbol":"USDT","isOpenSource":true,"ownerAddress":"0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828","creatorAddress":"0x36928500bc1dcd7af6a2b4008875cc336b927d57"},"band":"warning","query":{"chain":"ethereum","contract":"0xdAC17F958D2ee523a2206206994597C13D831ec7"},"score":38,"sources":["GoPlus Security"],"findings":[{"code":"blacklist","severity":"medium","description":"Contract has a blacklist function"},{"code":"transfer_pausable","severity":"medium","description":"Owner can pause all transfers"},{"code":"mintable","severity":"medium","description":"Owner can mint additional tokens (dilution risk)"},{"code":"concentrated_holders","severity":"medium","description":"Top holder owns 21.1% of supply"}],"timestamp":"2026-06-06T04:33:31.889Z","disclaimer":"This score is heuristic. It catches obvious risks but is not a substitute for full contract audit. Critical decisions should consider additional sources (TokenSniffer, Honeypot.is, manual review)."}},"exampleRequest":{"chain":"ethereum","contract":"0xdAC17F958D2ee523a2206206994597C13D831ec7"},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5QCd522gEuDJurbnFuOWo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a 0-100 security risk score for an on-chain token contract, combining GoPlus data with heuristics for honeypot detection, mint/owner permissions, holder concentration, and buy/sell taxes.","exampleAgentPrompt":"Before I swap into this token, can you run a security risk check on contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum and tell me the risk score, whether it's a honeypot, and what the buy/sell taxes look like?","exampleUseCases":null,"resultDescription":"A 0-100 security risk score for the queried token contract, along with individual signals including honeypot detection status, mint and owner permission flags, holder concentration analysis, and buy/sell tax percentages — sourced from GoPlus plus proprietary heuristics.","failureModes":["Invalid or unrecognized contract address returns an error or empty result","Unsupported chain identifier causes a 400 or similar error","GoPlus upstream outage may degrade or delay results","Newly deployed contracts with no on-chain history may have incomplete scores","Missing required 'contract' query parameter returns a validation error"],"whenToPreferThis":"Use this endpoint when you need a quick, aggregated token-level security signal before a trade or investment decision — especially to catch honeypots, dangerous permissions, or tax traps. Prefer this over the full pre-trade contract audit endpoint when you need only the token security score without Sourcify or DefiLlama composition, or when latency and cost are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:45:37.562Z","isFirstParty":false,"canonicalSlug":"api-hyperd-ai-37eab163"}