{"openapi":"3.1.0","info":{"title":"Agent Data Bench","version":"0.1.0","description":"Pay-per-call data and compute endpoints for AI agents, settled with x402 (USDC on Base). No accounts or API keys: call the endpoint, receive 402 with a PAYMENT-REQUIRED header, pay, retry. POST /api/v1/feedback is free and needs no payment.","contact":{"name":"Agent Data Bench","url":"https://x402.deepsense.stream"}},"servers":[{"url":"https://x402.deepsense.stream"}],"x-x402":{"network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","facilitator":"https://facilitator.payai.network","prices":{"tokenRisk":"$0.01","webExtract":"$0.005","mailInbox":"$0.02","mailMessages":"$0.005","jsonRepair":"$0.002","utility":"$0.001","jsonSchema":"$0.002","marketPools":"$0.003","marketPool":"$0.002","marketOhlcv":"$0.002","marketHolders":"$0.003","marketNewPools":"$0.005","marketTrades":"$0.003","marketTraders":"$0.005","marketSearch":"$0.002","marketGas":"$0.001","walletHoldings":"$0.005","walletProfile":"$0.005"}},"paths":{"/api/v1/web/extract":{"get":{"operationId":"get_api_v1_web_extract","summary":"Turn a web page into an LLM-ready document: markdown, JSON-LD, headings, tables, chunks","description":"Turn a public web page into an LLM-ready document: clean markdown with nav/cookie/script boilerplate removed, parsed JSON-LD, OpenGraph, heading outline, tables, link graph, word and token counts, and embedding-ready chunks. Query: url (required), format=markdown, include=jsonld,headings,tables,links,chunks,openGraph. SSRF-guarded, 2MB cap, honours robots.txt.","tags":["web","scrape","extract","markdown","readability"],"x-payment-info":{"protocol":"x402","price":"$0.005","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"url":"https://example.com","title":"Example Domain","text":"…","wordCount":24}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/json/repair":{"post":{"operationId":"post_api_v1_json_repair","summary":"Repair almost-JSON from LLMs (fences, smart quotes, comments, trailing commas) and parse it","description":"Repair almost-JSON produced by LLMs: strips markdown code fences, normalises smart quotes, removes comments and trailing commas, then parses. Returns the parsed value plus the list of repairs applied, or a precise parse error. Pure computation, no upstream data.","tags":["json","repair","parsing","llm-output","developer-tools"],"x-payment-info":{"protocol":"x402","price":"$0.002","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"ok":true,"value":{"a":1},"repairs":["stripped markdown code fence","removed trailing commas"]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string"}}}}}}}},"/api/v1/ping":{"get":{"operationId":"get_api_v1_ping","summary":"Health ping: ok, service, ISO timestamp, epoch milliseconds","description":"Zero-dependency health ping for agents: returns ok, service name, ISO timestamp and epoch milliseconds. Use it to verify an x402 client end to end in under a millisecond. No upstream, no storage.","tags":["ping","health","status","smoke-test","uptime"],"x-payment-info":{"protocol":"x402","price":"$0.001","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"ok":true,"service":"agent-data-bench","timestamp":"2026-10-19T16:00:00.000Z","epochMs":1760889600000}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/time":{"get":{"operationId":"get_api_v1_time","summary":"Current time for any IANA timezone (default UTC), DST-correct","description":"Current time for any IANA timezone (default UTC): ISO 8601, epoch seconds and milliseconds, local wall-clock string, weekday and weekday index, UTC offset in minutes. DST-correct because it uses the system tz database.","tags":["time","timezone","clock","utc","date"],"x-payment-info":{"protocol":"x402","price":"$0.001","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"iso":"2026-10-19T16:00:00.000Z","epochMs":1760889600000,"timezone":"UTC","weekday":"Mon","utcOffsetMinutes":0}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/uuid":{"get":{"operationId":"get_api_v1_uuid","summary":"Cryptographically random UUID v4 identifiers (1..100 per call)","description":"Cryptographically random UUID v4 identifiers. Ask for 1 to 100 in one paid call. Useful for idempotency keys, request ids, test fixtures and agent-to-agent correlation.","tags":["uuid","random","identifier","idempotency","crypto"],"x-payment-info":{"protocol":"x402","price":"$0.001","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"uuids":["3f1c9a7e-5b2d-4c8f-9a1e-7d6b5c4a3928"],"count":1}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/hash":{"post":{"operationId":"post_api_v1_hash","summary":"Hash text with sha256/sha512/sha1/md5, return hex and base64","description":"Hash text with sha256 (default), sha512, sha1 or md5 and get hex plus base64 in one call. Handy for agents that must fingerprint prompts, files or payloads without a local crypto library.","tags":["hash","sha256","checksum","digest","fingerprint"],"x-payment-info":{"protocol":"x402","price":"$0.001","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"algo":"sha256","hex":"b94d27b9…","base64":"uU0nuZNN…","inputBytes":11}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","maxLength":200000},"algo":{"type":"string","enum":["sha256","sha512","sha1","md5"],"default":"sha256"}}}}}}}},"/api/v1/base64":{"post":{"operationId":"post_api_v1_base64","summary":"Encode UTF-8 text to base64 or decode base64 back to UTF-8","description":"Encode UTF-8 text to base64 or decode base64 back to UTF-8, with byte counts. Lets an agent move binary-ish payloads through JSON without shipping a codec.","tags":["base64","encode","decode","binary","codec"],"x-payment-info":{"protocol":"x402","price":"$0.001","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"action":"encode","output":"aGVsbG8gd29ybGQ=","outputBytes":11}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input"],"properties":{"input":{"type":"string","maxLength":500000},"action":{"type":"string","enum":["encode","decode"],"default":"encode"}}}}}}}},"/api/v1/json/schema":{"post":{"operationId":"post_api_v1_json_schema","summary":"Infer a JSON Schema (draft 2020-12) from an example JSON value","description":"Infer a JSON Schema (draft 2020-12) from an example JSON value: nested objects, arrays, required keys, integer vs number, and string formats (date, date-time, email, uri, uuid). Useful for tool definitions and structured-output contracts.","tags":["json","schema","inference","developer-tools","structured-output"],"x-payment-info":{"protocol":"x402","price":"$0.002","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["value"],"properties":{"value":{}}}}}}}},"/api/v1/market/pools":{"get":{"operationId":"get_api_v1_market_pools","summary":"Ranked DEX pools with price, liquidity, volume, price change and holder forensics","description":"Ranked DEX pools for Solana, Base and Ethereum: normalised price, market cap, liquidity, buy/sell volume, price change and holder forensics (top-10, sniper, insider, bundle, dev). Filter by liquidity, market cap, volume, trades, holders and top-10 concentration; sort by tradeCount, priceChange or createdAt. Numeric output, no RPC or token decimals to handle.","tags":["crypto","dex","market-data","liquidity","trading"],"x-payment-info":{"protocol":"x402","price":"$0.003","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"sol","interval":"24h","count":1,"pools":[{"pool":"BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez","tokenInfo":{"symbol":"Bonk"},"priceUsd":0.00000289,"marketCapUsd":254382451.3,"liquidityUsd":137092.67,"volumeUsd":81359.24,"priceChangePct":4.12}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/pool":{"get":{"operationId":"get_api_v1_market_pool","summary":"One DEX pool by address, with 5m/1h/6h/24h reports and token metadata","description":"One DEX pool by address: token metadata on both sides, price, market cap, liquidity, LP burned percent, bonding-curve progress, and volume/price-change reports for 5m, 15m, 30m, 1h, 4h, 6h, 12h and 24h. Use it to price a pair, check depth before a trade, or resolve a token address to its deepest market.","tags":["crypto","dex","market-data","pool","liquidity"],"x-payment-info":{"protocol":"x402","price":"$0.002","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"sol","pool":{"pool":"Bqnp…JGez","priceUsd":0.00000289},"reports":[{"interval":"24h","volumeUsd":81359.24}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/ohlcv":{"get":{"operationId":"get_api_v1_market_ohlcv","summary":"OHLCV candles from 1s to 1d buckets for any DEX pool","description":"OHLCV candles for any DEX pool, from 1 second to 1 day buckets, newest N returned oldest-first with numeric open/high/low/close/volume. Drop-in for backtests, indicator calculations and chart rendering without running an indexer or decoding swap events.","tags":["crypto","ohlcv","candles","timeseries","backtest"],"x-payment-info":{"protocol":"x402","price":"$0.002","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"base","interval":"5m","count":1,"candles":[{"timestamp":1792483800,"open":2383.68,"high":2398.05,"low":2383.61,"close":2383.68,"volume":2446.64}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/holders":{"get":{"operationId":"get_api_v1_market_holders","summary":"Top token holders with balance, percent of supply and tags","description":"Top token holders with wallet, balance, percent of supply, labels/tags and first-seen time. Percent of supply is computed for you from total supply, so the result is ready for concentration checks, whale tracking or airdrop analysis. Works for Solana SPL and ERC-20 tokens on Base and Ethereum.","tags":["crypto","holders","whales","concentration","token"],"x-payment-info":{"protocol":"x402","price":"$0.003","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"base","token":"0x4200000000000000000000000000000000000006","count":1,"holders":[{"wallet":"0x86D8…c8d6","amount":"3292.79","pctOfSupply":0.1317}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/new-pools":{"get":{"operationId":"get_api_v1_market_new_pools","summary":"Just-launched and bonding-curve tokens with volume, trade counts and holder forensics","description":"Just-launched and bonding-curve tokens on Solana, Base and Ethereum: curve progress, price, market cap, liquidity, volume, trade counts and sniper/insider/bundle/dev holding percentages. Filter by liquidity, market cap, trades, holders, top-10 concentration and curve range; sort by createdAt or curvePercent. The only feed that carries trade counts for pre-graduation pairs.","tags":["crypto","new-pairs","memecoin","sniper","dex"],"x-payment-info":{"protocol":"x402","price":"$0.005","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"sol","orderBy":"createdAt","count":1,"pools":[{"pool":"A4yC…vmxH","curvePct":0,"trades":1,"holderForensics":{"top10HolderPct":0.03}}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/trades":{"get":{"operationId":"get_api_v1_market_trades","summary":"Exact DEX prints for a pool with maker, USD size, bot label and time filters","description":"Exact DEX prints for a pool: side, price, USD/token/quote amounts, maker, tx hash and bot label. Filter by minimum USD, maker, time range and side; return oldest or newest first, up to 500 prints. Complements the OHLCV route for backtests, wash-trade checks, copy-trade research and transaction-level audits.","tags":["crypto","trades","dex","tape","onchain"],"x-payment-info":{"protocol":"x402","price":"$0.003","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"base","pool":"0x6c56…1372","count":1,"trades":[{"timestamp":1792484375,"side":"sell","usdAmount":235.98,"maker":"0x292D…0b2f"}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/traders":{"get":{"operationId":"get_api_v1_market_traders","summary":"Per-wallet PnL leaderboard for a pool or token","description":"Per-wallet results for a pool or token: bought/sold volume and counts, realized PnL, remaining balance, hold duration and bot/KOL labels. Sort by PnL, filter to up to 30 wallets, and page the leaderboard. Use it to find smart money in a token, benchmark a wallet or size a copy-trade set.","tags":["crypto","traders","pnl","smart-money","copy-trade"],"x-payment-info":{"protocol":"x402","price":"$0.005","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"sol","count":1,"traders":[{"wallet":"VTHS…cof6Z","pnlUsd":-1.2e-7,"bought":{"usdAmount":1.5,"trades":1}}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/search":{"get":{"operationId":"get_api_v1_market_search","summary":"Resolve a symbol, name or address to the best-liquidity DEX pools","description":"Resolve a token symbol, name or address to DEX pools on Solana, Base or Ethereum: pool, token, dex, price, liquidity, market cap and 24h volume, best liquidity first. Use it to turn a ticker into a tradeable pool address before calling pool, ohlcv, trades or holders.","tags":["crypto","search","dex","token","resolve"],"x-payment-info":{"protocol":"x402","price":"$0.002","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"sol","query":"BONK","count":1,"results":[{"pool":"Bqnp…JGez","symbol":"Bonk","liquidityUsd":137092.67}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/market/gas":{"get":{"operationId":"get_api_v1_market_gas","summary":"Gas and priority-fee ladder plus native price for Solana, Base or Ethereum","description":"Fee inputs for the next transaction: gas ladder for Base or Ethereum (slow/normal/fast, priority fee, max fee, EIP-1559 base fee) or the priority-fee ladder for Solana, plus the native token price. One call for the numbers a transaction builder needs.","tags":["crypto","gas","fees","evm","solana"],"x-payment-info":{"protocol":"x402","price":"$0.001","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"base","unit":"gwei","slow":0.011,"normal":0.01808,"fast":0.02818,"nativePriceUsd":2383.73}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/wallet/holdings":{"get":{"operationId":"get_api_v1_wallet_holdings","summary":"Token balances held by a wallet (no USD valuation)","description":"Every token a wallet holds on Solana, Base or Ethereum, with balance, symbol, decimals, bought/sold volume and last update. No USD valuation is claimed: spam tokens carry fabricated prices upstream, so price a holding with the market routes. Sorted by balance and capped by limit.","tags":["crypto","wallet","holdings","balances","onchain"],"x-payment-info":{"protocol":"x402","price":"$0.005","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"base","wallet":"0x86D8…c8d6","totalHoldings":2,"holdings":[{"symbol":"WETH","balance":"3292.79"}]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/wallet/profile":{"get":{"operationId":"get_api_v1_wallet_profile","summary":"Wallet status, top holdings, related wallets and recent transaction activity","description":"Wallet overview from indexed activity: online/offline status and last active time, top holdings with USD value, related wallets linked by token flows (inflow/outflow counts), and the latest trades or transfers. Works on Solana, Base and Ethereum for wallets the indexer has seen.","tags":["crypto","wallet","analytics","smart-money","onchain"],"x-payment-info":{"protocol":"x402","price":"$0.005","network":"eip155:8453","payTo":"0xD1E706Dfbad15Cd78053696E67b5c148C2A5cFd5","scheme":"exact"},"responses":{"200":{"description":"Paid response","content":{"application/json":{"example":{"chain":"base","wallet":"0x86D8…c8d6","status":"offline","topHoldings":[{"symbol":"aBasWETH","valueUsd":1657.46}],"relatedWallets":[]}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required (see PAYMENT-REQUIRED header)"}}}},"/api/v1/feedback":{"post":{"operationId":"post_api_v1_feedback","summary":"Free structured capability request: tell us what data or tool you wish existed","description":"Tell us what data or tool you wish existed. Structured capability request: use case, missing endpoint, needs, optional contact. No payment, no account. Every submission is read; high-demand requests get built.","tags":["feedback","requests","agents","roadmap"],"security":[],"x-payment-info":{"protocol":"none","price":"free"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["useCase"],"properties":{"agent":{"type":"string"},"useCase":{"type":"string"},"needs":{"type":"string"},"missingEndpoint":{"type":"string"},"contact":{"type":"string"},"rating":{"type":"integer","minimum":1,"maximum":5}}}}}},"responses":{"201":{"description":"Stored (free, no payment)","content":{"application/json":{"example":{"id":"uuid","received":true}}}},"400":{"description":"Invalid input"},"429":{"description":"Rate limited"}}}}}}