{"uid":"cap_4p2ovYYrL6HyyUcnmAiYZ","slug":"chaink9-portfolio-screen-token-risk-check-for-wallet-holdings-6ca08748","name":"ChainK9 Portfolio Screen: Token Risk Check for Wallet Holdings","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/portfolio-screen?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":["wallet","tokens"],"properties":{"chain":{"enum":["bsc","eth","base","arc"],"type":"string","description":"bsc (BNB Smart Chain, the default), eth (Ethereum) or base (Base)"},"tokens":{"type":"string","description":"Comma-separated token addresses, one to twenty"},"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet whose balances to read"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"wallet":{"type":"string"},"coverage":{"type":"string"},"evidence":{"type":"object","properties":{"block":{"type":"integer"},"chain_id":{"type":"integer"}}},"positions":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"balance":{"type":"string"},"latest_scan":{},"stored_verdict":{"type":"string"},"stale_or_missing":{"type":"boolean"}}}}}}}}}},"responseSchema":{"type":"json","example":{"wallet":"0x00000000000000000000000000000000000caFe1","coverage":"Supplied assets and stored scans only.","evidence":{"block":1,"chain_id":56},"positions":[{"token":"0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82","balance":"100","latest_scan":null,"stored_verdict":"unknown","stale_or_missing":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1d1TUdpznmOpXODAIJQSt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns stored risk verdicts and balances for up to 20 tokens in a wallet, flagging honeypots and unsafe tokens detected via sandbox fork-and-trade simulation on BSC, Ethereum, or Base.","exampleAgentPrompt":"Can you screen the tokens in my wallet 0xAbCd1234...5678 on BNB Smart Chain — specifically check these token addresses 0xTokenA,0xTokenB — and tell me if any are honeypots or flagged as unsafe?","exampleUseCases":[{"title":"Pre-trade honeypot check for new token","prompt":"Before I buy this token on BSC — 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 — can you check my wallet 0x00000000000000000000000000000000000caFe1 and tell me if ChainK9 has flagged it as a honeypot or unsafe?"},{"title":"Portfolio safety audit before withdrawing","prompt":"I want to withdraw some holdings from my wallet 0xABCDEF1234567890abcdef1234567890abcdef12 on Ethereum — can you screen these five tokens 0xTok1,0xTok2,0xTok3,0xTok4,0xTok5 and tell me if any have been flagged as risky or have stale scan data?"},{"title":"Trading bot pre-execution risk filter","prompt":"My bot is about to trade tokens 0xAAA111,0xBBB222,0xCCC333 on Base using wallet 0x1111222233334444555566667777888899990000 — quickly check if any are honeypots or have unknown verdicts before it executes."}],"resultDescription":"Returns a JSON object containing the wallet address, a coverage note, evidence metadata (block number, chain ID), and an array of positions — each with the token address, current balance, the latest scan result (if available), a stored verdict (e.g. 'unknown', 'safe', 'honeypot'), and a flag indicating whether the scan data is stale or missing.","failureModes":["Missing or invalid wallet address returns a validation error","Invalid token address format causes rejection","Chain not in supported enum (bsc, eth, base, arc) returns error","More than 20 tokens supplied may be rejected or truncated","Stale or missing scan data is surfaced via stale_or_missing:true rather than returning an error","Payment failure via x402 results in 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need to screen an existing wallet's token holdings for risk, especially before executing trades or withdrawals. It is ideal for trading bots and portfolio agents that need fast, cheap ($0.005/call) risk verdicts on known wallet positions across BSC, Ethereum, or Base. Prefer this over static code-analysis tools because ChainK9 actually simulates buy/sell in a forked sandbox, catching behavioral honeypots that pass code inspection. Choose this when you already have a wallet address and token list, rather than when you need a deep on-demand scan of a brand-new unknown token.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:32:05.937Z","isFirstParty":false,"canonicalSlug":"chaink9-portfolio-screen-token-risk-check-for-wallet-holdings-6ca08748"}