{"openapi":"3.1.0","info":{"title":"agentkit0","version":"1.0.0","description":"x402 market intelligence + web extraction APIs for AI agents","x-guidance":"agentkit0 provides on-chain analytics for the x402 agentic commerce economy, plus LLM-ready web content extraction. Pay per call in USDC on Base. See /api/x402/pulse for ecosystem overview (free cached version at /api/x402/snapshot).","contact":{"url":"https://agentkit0.com"}},"servers":[{"url":"https://agentkit0.com"}],"paths":{"/api/x402/pulse":{"post":{"summary":"x402 ecosystem pulse (24h)","description":"Ecosystem-wide Base-mainnet stats: total USDC volume across all bazaar-registered sellers, active seller count, unique buyer count, avg ticket, top 10 sellers by volume, top 10 buyers by payment count, dormant-seller count.","operationId":"api_x402_pulse","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.01"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hours":{"type":"integer","description":"Window in hours (1-24)"}}}}}}}},"/api/x402/leaderboard":{"post":{"summary":"Top-earning x402 services","description":"Ranks all bazaar-registered Base-mainnet sellers by actual USDC received in a window. Returns rank, revenue, payment count, unique payers, and top services per address.","operationId":"api_x402_leaderboard","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.05"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hours":{"type":"integer","description":"Window in hours (1-24)"},"top":{"type":"integer","description":"Top N (1-50)"}}}}}}}},"/api/x402/whales":{"post":{"summary":"Top-spending x402 agents","description":"Aggregates x402 payments by buyer wallet. Returns top N spenders with total USDC spent, payment count, unique sellers, and their top seller.","operationId":"api_x402_whales","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.05"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hours":{"type":"integer","description":"Window in hours (1-24)"},"top":{"type":"integer","description":"Top N (1-50)"}}}}}}}},"/api/x402/earner":{"post":{"summary":"Per-seller revenue deep-dive","description":"For a payTo address, returns USDC earned, payment count, unique payers, avg/median ticket, top 10 payers with totals, 20 most recent payments. Competitor research.","operationId":"api_x402_earner","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.02"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Ethereum address (0x...)"},"hours":{"type":"integer","description":"Window in hours (1-168)"}},"required":["address"]}}}}}},"/api/x402/spender":{"post":{"summary":"Per-buyer profile","description":"For an agent/wallet, returns total USDC spent, unique sellers paid, top recipients with their services, recent payments, and x402_seller_ratio (confidence the wallet is an x402-active agent).","operationId":"api_x402_spender","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.02"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Ethereum address (0x...)"},"hours":{"type":"integer","description":"Window in hours (1-168)"}},"required":["address"]}}}}}},"/api/x402/compare":{"post":{"summary":"Head-to-head seller comparison","description":"Side-by-side comparison of 2-5 seller addresses: revenue, payment count, unique payers, avg ticket, payments per hour, top service. Returns winners per metric.","operationId":"api_x402_compare","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.03"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addresses":{"type":"array","description":"Array of 2-5 Ethereum addresses"},"hours":{"type":"integer","description":"Window in hours (1-24)"}},"required":["addresses"]}}}}}},"/api/x402/opportunities":{"post":{"summary":"x402 opportunity finder","description":"Ranks x402 service categories by observed paid demand, seller concentration, buyer diversity, and pricing gaps. Use it to decide what paid API to build next.","operationId":"api_x402_opportunities","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.10"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hours":{"type":"integer","description":"Window in hours (1-24)"},"top":{"type":"integer","description":"Top N categories (1-25)"}}}}}}}},"/api/x402/buyer-leads":{"post":{"summary":"High-spending x402 buyer leads","description":"Finds wallets spending on x402 services and returns lead signals by category, spend, payment count, and top seller affinity.","operationId":"api_x402_buyer-leads","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.10"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hours":{"type":"integer","description":"Window in hours (1-24)"},"top":{"type":"integer","description":"Top N buyers (1-50)"},"category":{"type":"string","description":"Optional category filter"}}}}}}}},"/api/x402/pricing-report":{"post":{"summary":"x402 service pricing bands","description":"Returns price bands and sample services for all Bazaar services or one category. Use it to price a new x402 endpoint against current marketplace supply.","operationId":"api_x402_pricing-report","tags":["x402-intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.10"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Category or all (default all)"}}}}}}}},"/api/web/markdown":{"post":{"summary":"URL → LLM-ready Markdown","description":"Fetch any URL and return clean Markdown via Mozilla Readability + Turndown (same pipeline as Jina Reader). Returns title, byline, excerpt, reading time, and the extracted markdown.","operationId":"api_web_markdown","tags":["web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.004"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Target URL"},"maxLen":{"type":"integer","description":"Max markdown chars (default 50000)"}},"required":["url"]}}}}}},"/api/web/scrape":{"post":{"summary":"URL → clean text + metadata","description":"Readability-backed extraction. Returns title, byline, excerpt, cleaned text, OG metadata, canonical, favicon.","operationId":"api_web_scrape","tags":["web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.003"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Target URL"},"maxTextLen":{"type":"integer","description":"Max text chars (default 20000)"}},"required":["url"]}}}}}},"/api/web/links":{"post":{"summary":"URL → all outbound links","description":"Extract all outbound anchors from a URL with text, internal/external classification, and rel attributes.","operationId":"api_web_links","tags":["web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.002"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Target URL"},"max":{"type":"integer","description":"Max links returned (default 500)"}},"required":["url"]}}}}}},"/api/crypto/validate":{"post":{"summary":"Multi-chain crypto address validator","description":"Validate crypto addresses across 9 chains: EVM (EIP-55 checksum), Bitcoin (all formats), Solana (ed25519), Litecoin, Dogecoin, Tron, Ripple, Cosmos, Cardano. Pure compute.","operationId":"api_crypto_validate","tags":["utility"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.002"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Address to validate"},"chain":{"type":"string","description":"Chain hint (evm|btc|sol|ltc|doge|trx|xrp|cosmos|ada)"}},"required":["address"]}}}}}},"/api/tokens/count":{"post":{"summary":"LLM token counter + cost estimator","description":"Count tokens using o200k_base for GPT-4o/o1/o3, cl100k_base for older GPT-4/3.5, cl100k approximation for Claude. Returns token count and estimated USD cost per million tokens.","operationId":"api_tokens_count","tags":["utility"],"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.001"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","payTo":"0xc794070cF310AB3766a8A3903fC6d50e082c3D65","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxTimeoutSeconds":300}}]},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required (x402)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text to tokenize"},"model":{"type":"string","description":"Model name (default gpt-4o)"}},"required":["text"]}}}}}}},"components":{"schemas":{}}}