{"name":"UnlockBot API","version":"2.4.2","stable_docs":"https://unlockbot.surge.sh/api/","stable_pointer":"https://unlockbot.surge.sh/api.json","mcp_package":"npx -y https://unlockbot.surge.sh/mcp/onchain-intel-x402.tgz","mcp_registry":"sh.surge.unlockbot/onchain-intel","description":"Pay-per-call crypto risk data for AI agents over x402: pre-trade checks, token safety / honeypot screening, whale exchange flows, token unlock risk, wallet profiles. No API key, no signup: pay a few cents of USDC per call.","x402":{"version":2,"scheme":"exact","network":"eip155:8453","network_name":"Base mainnet","asset":"USDC","payTo":"0x21e4F3c6EcDb0F0CADC59511BF675B9BcBbeD304","facilitator":"https://facilitator.payai.network"},"endpoints":[{"method":"GET","path":"/pre-trade-check","price_usdc":"0.05","summary":"Pre-trade check / rug check before buying a token: honeypot, token safety, unlocks, whale + smart money flows, one buy/avoid verdict","example":"https://zeg5gyw3v84q.hostc.app/pre-trade-check?chain=ethereum&address=0xCa14007Eff0dB1f8135f4C25B34De49AB0d42766","demo":"https://zeg5gyw3v84q.hostc.app/demo/pre-trade-check","params":{"chain":"required string one of ethereum|base|arbitrum: EVM chain the token lives on","address":"required string: Token contract address"}},{"method":"GET","path":"/token-safety","price_usdc":"0.03","summary":"Honeypot & rug check / token safety scanner: buy-sell tax, mint, blacklist, proxy, owner, LP lock, holders (ERC-20 on Base, Ethereum, Arbitrum)","example":"https://zeg5gyw3v84q.hostc.app/token-safety?chain=base&address=0x940181a94A35A4569E4529A3CDfB74e38FD98631","demo":"https://zeg5gyw3v84q.hostc.app/demo/token-safety","params":{"chain":"required string one of ethereum|base|arbitrum: EVM chain the token lives on","address":"required string: Token contract address"}},{"method":"GET","path":"/whale-flows","price_usdc":"0.02","summary":"Whale alerts & smart money exchange flows: large CEX deposits/withdrawals, net inflow/outflow, top movers","example":"https://zeg5gyw3v84q.hostc.app/whale-flows?symbol=STRK&hours=24","demo":"https://zeg5gyw3v84q.hostc.app/demo/whale-flows","params":{"symbol":"optional string one of AERO|ARB|EIGEN|ENA|STRK|ZETA|ZK|ZRO: Tracked token ticker (alternative to chain+address)","chain":"optional string one of ethereum|base|arbitrum: Chain (with address)","address":"optional string: Token contract (with chain)","hours":"optional integer: Look-back window (Base is limited to 5h by free public RPCs)","min":"optional number: Minimum transfer size in tokens (default: curated whale threshold or 0.01% of supply)"}},{"method":"GET","path":"/unlock-risk","price_usdc":"0.01","summary":"Token unlock / vesting risk: next unlock size vs circulating supply, CEX inflows, sell-pressure score","example":"https://zeg5gyw3v84q.hostc.app/unlock-risk?symbol=STRK","demo":"https://zeg5gyw3v84q.hostc.app/demo/unlock-risk","params":{"symbol":"required string one of APT|ARB|EIGEN|ENA|PYTH|STRK|ZETA|ZK|ZRO: Token ticker"}},{"method":"GET","path":"/unlocks/upcoming","price_usdc":"0.02","summary":"Token unlock calendar: upcoming vesting unlocks in the next N days, sized vs supply","example":"https://zeg5gyw3v84q.hostc.app/unlocks/upcoming?days=30","demo":"https://zeg5gyw3v84q.hostc.app/demo/unlocks/upcoming","params":{"days":"optional integer: Window in days"}},{"method":"GET","path":"/wallet-profile","price_usdc":"0.05","summary":"Wallet profiler: smart money / exchange / bot label, balances, activity across Ethereum, Base, Arbitrum","example":"https://zeg5gyw3v84q.hostc.app/wallet-profile?address=0x28C6c06298d514Db089934071355E5743bf21d60","demo":"https://zeg5gyw3v84q.hostc.app/demo/wallet-profile","params":{"address":"required string: Wallet address"}},{"method":"GET","path":"/token-price","price_usdc":"0.005","summary":"Token price API: real-time DEX price, liquidity, volume, FDV for any ERC-20 (Base, Ethereum, Arbitrum)","example":"https://zeg5gyw3v84q.hostc.app/token-price?chain=base&address=0x940181a94A35A4569E4529A3CDfB74e38FD98631","demo":"https://zeg5gyw3v84q.hostc.app/demo/token-price","params":{"chain":"required string one of ethereum|base|arbitrum: EVM chain the token lives on","address":"required string: Token contract address"}},{"method":"GET","path":"/new-tokens","price_usdc":"0.02","summary":"New token launches feed with auto honeypot / rug screening (new DEX pools, sniping research)","example":"https://zeg5gyw3v84q.hostc.app/new-tokens?chain=base&hours=6&limit=10","demo":"https://zeg5gyw3v84q.hostc.app/demo/new-tokens","params":{"chain":"optional string one of ethereum|base|arbitrum: Chain","hours":"optional integer: Look-back window","limit":"optional integer: Max tokens","screen":"optional boolean: Run safety screen on top 10"}},{"method":"GET","path":"/yields","price_usdc":"0.01","summary":"DeFi yields / best APY finder by asset and chain with risk notes (stablecoin yield, lending, LP)","example":"https://zeg5gyw3v84q.hostc.app/yields?asset=USDC&chain=base&limit=10","demo":"https://zeg5gyw3v84q.hostc.app/demo/yields","params":{"asset":"optional string: Token symbol in the pool, e.g. USDC","chain":"optional string one of ethereum|base|arbitrum|optimism|polygon|solana|bsc|avalanche: Chain filter","min_tvl":"optional number: Minimum TVL in USD","stablecoin":"optional boolean: Stablecoin pools only","limit":"optional integer: Max pools"}},{"method":"GET","path":"/gas","price_usdc":"0.001","summary":"Gas price / gas fee tracker + forecast for Ethereum, Base, Arbitrum ($0.001, cheapest call)","example":"https://zeg5gyw3v84q.hostc.app/gas?chain=ethereum","demo":"https://zeg5gyw3v84q.hostc.app/demo/gas","params":{"chain":"optional string one of ethereum|base|arbitrum: Chain"}},{"method":"GET","path":"/crypto-news","price_usdc":"0.01","summary":"Crypto news API with headline sentiment per token / topic","example":"https://zeg5gyw3v84q.hostc.app/crypto-news?q=bitcoin&limit=10","demo":"https://zeg5gyw3v84q.hostc.app/demo/crypto-news","params":{"q":"optional string: Comma-separated keywords (token name/ticker/topic)","limit":"optional integer: Max articles"}},{"method":"GET","path":"/due-diligence","price_usdc":"0.05","summary":"Token due diligence report (DD) in Markdown for LLM agents: rug check, honeypot, holders, whales, unlocks, news","example":"https://zeg5gyw3v84q.hostc.app/due-diligence?chain=ethereum&address=0xCa14007Eff0dB1f8135f4C25B34De49AB0d42766","demo":"https://zeg5gyw3v84q.hostc.app/demo/due-diligence","params":{"chain":"required string one of ethereum|base|arbitrum: EVM chain the token lives on","address":"required string: Token contract address"}},{"method":"GET","path":"/address-check","price_usdc":"0.005","summary":"Scam / phishing / sanctioned (OFAC) address check before sending funds or approving (AML screening)","example":"https://zeg5gyw3v84q.hostc.app/address-check?address=0x098B716B8Aaf21512996dC57EB0615e2383E2f96","demo":"https://zeg5gyw3v84q.hostc.app/demo/address-check","params":{"address":"required string: Address to screen","chain":"optional string one of ethereum|base|arbitrum: Chain context"}},{"method":"GET","path":"/tx-explain","price_usdc":"0.01","summary":"Transaction explainer / decoder: plain-English swaps, transfers, approvals (flags unlimited approvals)","example":"https://zeg5gyw3v84q.hostc.app/tx-explain?chain=base&hash=0xbb45307b75671c41aafcbf97974497de6ea5194ee40437283f96f7148b68d7b0","demo":"https://zeg5gyw3v84q.hostc.app/demo/tx-explain","params":{"chain":"required string one of ethereum|base|arbitrum: Chain","hash":"required string: Transaction hash"}},{"method":"GET","path":"/stablecoin-peg","price_usdc":"0.002","summary":"Stablecoin depeg monitor: USDC, USDT, DAI, USDe, FDUSD, PYUSD vs $1 ($0.002)","example":"https://zeg5gyw3v84q.hostc.app/stablecoin-peg?","demo":"https://zeg5gyw3v84q.hostc.app/demo/stablecoin-peg","params":{}},{"method":"GET","path":"/polymarket","price_usdc":"0.005","summary":"Polymarket odds / prediction market probabilities by keyword","example":"https://zeg5gyw3v84q.hostc.app/polymarket?q=bitcoin&limit=5","demo":"https://zeg5gyw3v84q.hostc.app/demo/polymarket","params":{"q":"optional string: Comma-separated keywords","limit":"optional integer: Max markets"}},{"method":"GET","path":"/ens","price_usdc":"0.002","summary":"ENS resolver: .eth name to address and reverse lookup, avatar ($0.002)","example":"https://zeg5gyw3v84q.hostc.app/ens?q=vitalik.eth","demo":"https://zeg5gyw3v84q.hostc.app/demo/ens","params":{"q":"required string: ENS name or 0x address"}},{"method":"GET","path":"/liquidation-risk","price_usdc":"0.005","summary":"Liquidation risk / health factor monitor for Aave v3 & Spark positions by address ($0.005)","example":"https://zeg5gyw3v84q.hostc.app/liquidation-risk?address=0x52e31ea3c6367e2f777276cf75d42673b3786034","demo":"https://zeg5gyw3v84q.hostc.app/demo/liquidation-risk","params":{"address":"required string: Borrower wallet address","chain":"optional string one of ethereum|base|arbitrum: Limit to one chain (default: all)"}},{"method":"GET","path":"/approvals-audit","price_usdc":"0.01","summary":"Token approvals audit / revoke checker: risky & unlimited ERC-20 allowances for a wallet ($0.01)","example":"https://zeg5gyw3v84q.hostc.app/approvals-audit?address=0x28C6c06298d514Db089934071355E5743bf21d60&chain=ethereum","demo":"https://zeg5gyw3v84q.hostc.app/demo/approvals-audit","params":{"address":"required string: Wallet address","chain":"optional string one of ethereum|base|arbitrum: Chain"}},{"method":"GET","path":"/governance","price_usdc":"0.005","summary":"DAO governance feed: active Snapshot proposals & vote results for Aave, Uniswap, Arbitrum, Optimism, Lido + 25 more ($0.005)","example":"https://zeg5gyw3v84q.hostc.app/governance?state=active&limit=10","demo":"https://zeg5gyw3v84q.hostc.app/demo/governance","params":{"dao":"optional string: Comma-separated DAO names or Snapshot space ids","state":"optional string one of active|closed|pending|all: Proposal state","limit":"optional integer: Max proposals"}},{"method":"GET","path":"/swap-risk","price_usdc":"0.005","summary":"Swap MEV / sandwich risk estimate + recommended slippage for a proposed trade ($0.005)","example":"https://zeg5gyw3v84q.hostc.app/swap-risk?chain=ethereum&token=0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984&amount_usd=50000&slippage_pct=3","demo":"https://zeg5gyw3v84q.hostc.app/demo/swap-risk","params":{"chain":"required string one of ethereum|base|arbitrum: EVM chain the token lives on","token":"required string: Token you buy or sell","amount_usd":"required number: Trade size in USD","slippage_pct":"optional number: Your slippage tolerance %"}}],"free_trial":"GET /gas with header X-Free-Trial: true -> one free call per client","free":["/","/health","/recommend?goal=...","/symbols","/demo","/demo/{endpoint}","/openapi.json","/llms.txt","/tools.json","/mcp","/.well-known/x402","/.well-known/x402.json","/.well-known/agent-card.json","/.well-known/mcp/server-card.json"],"conventions":{"success":"{ ok: true, endpoint, version, as_of, query, partial, warnings, data }","error":"{ ok: false, error: { code, message, hint } }","charged_only_on":"HTTP 200 after successful settlement","not_charged":"400 bad_request, 429, 503 upstream_unavailable"},"docs":{"openapi":"https://zeg5gyw3v84q.hostc.app/openapi.json","llms":"https://zeg5gyw3v84q.hostc.app/llms.txt","tools":"https://zeg5gyw3v84q.hostc.app/tools.json"},"contact":"saylor@mail.grokbot.com","disclaimer":"Informational only, not financial advice."}