{"uid":"cap_KHjAgLJuF5HttFlZhHNyO","slug":"chaink9-liquidity-report-api-8407de90","name":"ChainK9 Liquidity Report 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/liquidity-report?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"},"holders":{"type":"string","description":"Optional comma-separated LP holder addresses, maximum ten"},"pinklock_ids":{"type":"string","description":"Optional, BSC only: comma-separated PinkLock V2 lock IDs, maximum ten unique decimal IDs; only simple time locks counted"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"pair":{"type":"string"},"block":{"type":"integer"},"token":{"type":"string"},"chain_id":{"type":"integer"},"coverage":{"type":"string"},"burned_lp":{"type":"string"},"lp_supply":{"type":"string"},"block_hash":{"type":"string"},"observed_at":{"type":"string"},"lock_evidence":{},"reserve_token":{"type":"string"},"reserve_wrapped":{"type":"string"},"unattributed_lp":{"type":"string"},"requested_holders":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"share_bps":{"type":"string"},"lp_balance":{"type":"string"},"account_kind":{"type":"string"},"withdrawal_authority":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"pair":"0x00000000000000000000000000000000000caFe1","block":1,"token":"0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82","chain_id":56,"coverage":"Requested holders; optional supported simple lock evidence overlaps ownership balances.","burned_lp":"1","lp_supply":"100","block_hash":"0x…","observed_at":"2026-10-18T00:00:00Z","lock_evidence":null,"reserve_token":"100","reserve_wrapped":"100","unattributed_lp":"49","requested_holders":[{"address":"0x00000000000000000000000000000000000caFe1","share_bps":"5000","lp_balance":"50","account_kind":"EOA","withdrawal_authority":"Redemption not simulated"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vAd8tjYVTSbxVZQhPNrt5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a live sandbox buy/sell simulation on a token to detect honeypots and assess liquidity risk on BNB Smart Chain, Ethereum, and Base","exampleAgentPrompt":"Before I buy, can you run a ChainK9 honeypot and liquidity check on token 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 on BNB Smart Chain?","exampleUseCases":[{"title":"Honeypot check before memecoin buy","prompt":"I'm about to buy this BSC token at 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 — can you simulate a buy and sell in a sandbox to check if it's a honeypot before I put money in?"},{"title":"Liquidity lock verification for DeFi investment","prompt":"Check whether liquidity is locked for Ethereum token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — I want to see the LP holder breakdown and any lock evidence before I commit funds."},{"title":"Trading bot pre-trade risk filter","prompt":"My trading bot is about to open a position on Base token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — run a full liquidity and honeypot risk report so I can decide whether to proceed."}],"resultDescription":"A JSON snapshot containing the trading pair address, block number and hash, chain ID, LP supply, burned LP amount, unattributed LP, token and wrapped-asset reserve sizes, lock evidence, and a per-holder breakdown with LP balance, share in basis points, account kind (EOA/contract), and withdrawal authority status — all captured at a specific block from a live fork simulation.","failureModes":["Invalid or non-existent token address returns an error or empty result","Unsupported chain value returns a validation error","Token with no liquidity pool may return null pair or empty reserves","PinkLock IDs not found on BSC return null lock_evidence","Rate limiting or payment failure (x402) if USDC balance is insufficient","Simulation failure if the forked chain state is temporarily unavailable"],"whenToPreferThis":"Choose ChainK9 over static code-analysis honeypot checkers when you need behavioral proof — it actually forks the chain and executes real buy/sell transactions in a sandbox, so it catches honeypots that manipulate runtime behavior rather than hiding it in code. Prefer this when trading on BSC, Ethereum, or Base and needing LP holder distribution, burned LP accounting, and optional PinkLock verification in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:45:44.489Z","isFirstParty":false,"canonicalSlug":"chaink9-liquidity-report-api-8407de90"}