{"uid":"cap_S0dGCdVLhUwTunDa4EjxB","slug":"chaink9-risk-changes-api-f590bc31","name":"ChainK9 Risk Changes API","description":"Token risk checks for BNB Smart Chain, Ethereum and Base, for AI agents and trading bots. ChainK9 forks the chain and really buys and sells a token in a sandbox before you do, so a honeypot is caught by what it does, not by what its code looks like.","url":"https://api.chaink9.com/risk-changes?utm_source=zero.xyz","method":"GET","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":["token"],"properties":{"chain":{"enum":["bsc","eth","base","arc"],"type":"string","description":"bsc (BNB Smart Chain, the default), eth (Ethereum) or base (Base)"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Token with at least two stored scans on that chain"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"after":{"type":"object","properties":{"block":{"type":"integer"},"verdict":{"type":"string"},"scanned_at":{"type":"string"}}},"token":{"type":"string"},"before":{"type":"object","properties":{"block":{"type":"integer"},"verdict":{"type":"string"},"scanned_at":{"type":"string"}}},"changes":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"after":{"type":"object","properties":{"status":{"type":"string"}}},"before":{"type":"object","properties":{"status":{"type":"string"}}},"module":{"type":"string"}}}},"coverage":{"type":"string"},"pair_changed":{"type":"boolean"},"proxy_changed":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"after":{"block":2,"verdict":"caution","scanned_at":"2026-10-18T00:10:00Z"},"token":"0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82","before":{"block":1,"verdict":"ok","scanned_at":"2026-10-18T00:00:00Z"},"changes":[{"kind":"changed","after":{"status":"warn"},"before":{"status":"pass"},"module":"sell_tax"}],"coverage":"Stored reports only.","pair_changed":false,"proxy_changed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Rc9n0w_K6hJOzjb4MUfJK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a diff of token risk assessment changes between the two most recent stored scans on BNB Smart Chain, Ethereum, or Base","exampleAgentPrompt":"Has the risk status of the token at 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 on BNB Smart Chain changed since it was last scanned — did it pick up any new warnings like a sell tax or honeypot flag?","exampleUseCases":[{"title":"Pre-trade safety check for trading bot","prompt":"Before my bot buys the token at 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 on Ethereum, check if its risk verdict has changed since the last scan — especially any new honeypot or sell tax warnings."},{"title":"Portfolio token health monitoring","prompt":"I'm holding 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 on BNB Smart Chain — can you check ChainK9 to see if its risk assessment has degraded or if any new risk modules flagged since the previous scan?"},{"title":"Alert on proxy contract change","prompt":"Check if the token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base has had its proxy contract changed or its risk verdict flipped between the last two scans."}],"resultDescription":"A JSON object showing the token address, the 'before' and 'after' scan verdicts with block numbers and timestamps, an array of changed risk modules (each with module name, kind of change, and before/after status), a coverage note, and boolean flags indicating whether the liquidity pair or proxy contract changed between scans.","failureModes":["Token has fewer than two stored scans — returns an error or empty result as diff is not computable","Invalid token address format — rejected by pattern validation","Unsupported chain specified — rejected by enum validation","Token not found on the specified chain — no data returned","Payment via x402 fails or is insufficient — request rejected before processing"],"whenToPreferThis":"Use this endpoint when you need to detect changes in a token's risk profile between two points in time rather than a full current risk report. It is ideal for trading bots and monitoring agents that have already seen a prior scan and want to know if anything has degraded — particularly useful for catching newly emerged honeypot behavior, sell tax increases, proxy upgrades, or pair swaps. Prefer this over a full risk scan endpoint when you want a lightweight diff rather than a complete re-assessment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:41:55.094Z","isFirstParty":false,"canonicalSlug":"chaink9-risk-changes-api-f590bc31"}