{"openapi":"3.1.0","info":{"title":"x402 DEX data, agent utilities & Uniswap v4 hook risk API","version":"1.0.0","description":"Pay-per-call (x402/USDC on Base) market-data, geocoding, randomness and hook-risk endpoints. Free demo route included.","x-guidance":"Paid endpoints accept BOTH the x402 V2 protocol and MPP (Machine Payments Protocol) on the same routes for the same price: call without payment to receive a 402 carrying an x402 PAYMENT-REQUIRED challenge and an MPP WWW-Authenticate: Payment challenge, pay with whichever you support (e.g. @x402/fetch or mppx), retry. USDC on base (eip155:8453). No account, no API key.","contact":{"email":"donny.nguyen.business@gmail.com"}},"x-service-info":{"categories":["data","blockchain","search","web"],"docs":{"homepage":"https://x402.donnyautomation.com","apiReference":"https://x402.donnyautomation.com/openapi.json"}},"servers":[{"url":"https://x402.donnyautomation.com"}],"paths":{"/call":{"get":{"summary":"Cross-DEX price, liquidity & arbitrage spread (BSC)","description":"Real-time DEX market data & cross-exchange arbitrage spread API for BSC/BNB Chain. Live on-chain token pair prices, liquidity/TVL and best buy-sell quotes across PancakeSwap v2, PancakeSwap v3 (all fee tiers), Biswap and ApeSwap in one call. Returns per-venue price feed, gross arbitrage spread (bps + USD), optimal trade size and block number. For trading bots, DeFi agents, price oracles and market monitoring. GET; pair=SYM/SYM (e.g. WBNB/USDC), optional fee=v3 tier. $0.01/call.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"priceUsd":"$0.01","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair SYM/SYM; first symbol is the USD-priceable side (e.g. WBNB/USDC).","example":"WBNB/USDC"},{"name":"fee","in":"query","required":false,"schema":{"type":"string"},"description":"Optional PancakeSwap v3 fee tier (100|500|2500|10000). Omit to probe all tiers + v2."}],"responses":{"200":{"description":"Per-venue prices, best buy/sell, gross spread (bps/USD), optimal input, liquidity, block number.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getCall"}},"/v4hooks":{"get":{"summary":"Uniswap v4 hook security scan / custody-risk decode (Base)","description":"Uniswap v4 hook security scanner & rug-check API (Base mainnet). Pre-trade safety gate for DEX routers, token scanners and trading bots: decodes all 14 hook permission bits from the address (v4-core Hooks.sol), flags swap custody, fee-taking and EIP-1967 upgradeable hooks, verifies source via Basescan/Sourcify/Blockscout consensus. Returns custody class (PASSIVE|FLOW_CONTROL|FEE_TAKING|SWAP_CUSTODY|OPAQUE), risk flags, verification state. Capability analysis - never outputs SAFE. $0.01/call.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"priceUsd":"$0.01","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"Uniswap v4 hook contract address on Base mainnet."}],"responses":{"200":{"description":"Custody class, permission bits, upgradeability, verified-source consensus, risk flags.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getV4hooks"}},"/demo/v4hooks/{address}":{"get":{"summary":"FREE demo of the v4 hook scan (rate-limited 10/min/IP)","security":[],"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Same payload as /v4hooks.","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limited."}},"operationId":"getDemoV4hooksByAddress"}},"/price":{"get":{"summary":"Live token price in USD by ticker symbol or contract address","description":"Live token price in USD by ticker symbol or contract address - any ERC-20, not a fixed list. Real-time spot price read from DEX pools at call time, current market data an LLM cannot know from training. What is this token worth right now. Returns priceUsd, the pair it was priced through, the USD liquidity backing that quote and a confidence rating, so a thin-pool number is never passed off as a market price. Onchain market data for trading bots, price oracles and DeFi agents. BSC / BNB Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"BEP-20 token symbol on BSC (e.g. CAKE, WBNB, BTCB, ETH, LINK, BSW)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPrice"}},"/liquidity":{"get":{"summary":"DEX liquidity, market depth and TVL by venue for a trading pair","description":"DEX liquidity, market depth and TVL by venue for a trading pair - how deep is this pool, and where is the liquidity. Per-venue liquidity in USD, both pool reserves, each venue share of total depth, and the deepest venue to trade against. Live onchain pool state at call time, including stablecoin liquidity. For slippage estimation, order routing, market-making and liquidity analytics agents. BSC / BNB Chain: PancakeSwap v2, PancakeSwap v3 fee tiers, Biswap, ApeSwap.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM (e.g. WBNB/USDT, CAKE/USDT)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getLiquidity"}},"/reserves":{"get":{"summary":"Raw AMM pool reserves and live pool state for a trading pair","description":"Raw AMM pool reserves and live pool state for a trading pair. Constant-product and concentrated-liquidity (Uniswap v3 style) pools: both reserves, pool mid price, fee tier in bps, and USD TVL per venue at a stated block. The underlying onchain numbers for anyone computing their own quotes, price impact, slippage or arbitrage math. BSC / BNB Chain across PancakeSwap v2, PancakeSwap v3, Biswap and ApeSwap.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM (e.g. WBNB/USDT)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getReserves"}},"/route":{"get":{"summary":"Best execution price across DEXs","description":"Best execution price across DEXs - which DEX is cheapest to buy on and which pays most to sell into. Compares live prices across every venue quoting the pair and returns the buy venue, the sell venue, the cross-exchange spread in bps, the fee-adjusted gross arbitrage spread and an optimal trade size. Smart order routing and cross-DEX arbitrage data for trading bots and DeFi execution agents. BSC / BNB Chain: PancakeSwap v2 and v3, Biswap, ApeSwap.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM (e.g. WBNB/USDT)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getRoute"}},"/risk":{"get":{"summary":"Thin liquidity warning for a trading pair before you trade it","description":"Thin liquidity warning for a trading pair before you trade it. Classifies market depth DEEP, MODERATE, SHALLOW or VERY_THIN from live pool TVL, counts how many venues can actually route the trade, measures how concentrated liquidity is in the largest venue, and flags single-venue markets and wide cross-venue spreads. Pre-trade depth check on BSC / BNB Chain. Liquidity depth analysis only - not a contract audit or honeypot check.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM (e.g. CAKE/USDT). Or pass symbol= to default the quote to USDT."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getRisk"}},"/slippage":{"get":{"summary":"Price impact and slippage for a specific trade size on BSC / BNB Chain","description":"Price impact and slippage for a specific trade size on BSC / BNB Chain - what will my trade actually get, not just the spot price. Simulates the swap against live pool reserves on every venue and returns the best execution venue, amount out, price impact in bps, the pool fee separately, and what correct routing saves versus picking the best quoted price. Pre-trade execution check for trading bots, DEX aggregators and DeFi execution agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM (e.g. WBNB/USDT)."},{"name":"amountUsd","in":"query","required":true,"schema":{"type":"string"},"description":"Trade size in USD, e.g. 10000. Required unless amountIn is given instead."},{"name":"amountIn","in":"query","required":false,"schema":{"type":"string"},"description":"Trade size denominated in the FIRST pair symbol instead of USD, e.g. 12.5 for 12.5 WBNB. An alternative to amountUsd; supplying either one is enough."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getSlippage"}},"/scan":{"get":{"summary":"Live cross","description":"Live cross-DEX arbitrage scanner for BSC / BNB Chain. Scans every liquid pair across PancakeSwap v2 and v3 fee tiers, Biswap and ApeSwap and returns ranked cross-venue spreads: where to buy, where to sell, spread in bps, optimal trade size and gross USD at that size. GROSS, before gas and MEV. Venues below a liquidity floor are excluded, so a spread against a dust pool is never reported as an opportunity. For arbitrage bots and DeFi execution agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"minSpreadBps","in":"query","required":true,"schema":{"type":"string"},"description":"Minimum gross spread to report (default 10). Also minVenueTvlUsd (default 1000) and limit."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getScan"}},"/gas":{"get":{"summary":"Live gas prices across BNB Chain, Polygon, Arbitrum, Base, Avalanche and Optimism, converted to USD and sorted cheapest","description":"Live gas prices across BNB Chain, Polygon, Arbitrum, Base, Avalanche and Optimism, converted to USD and sorted cheapest-first. Returns gas price in gwei, base fee, and the actual USD cost of a transfer, an ERC-20 transfer and a swap on each chain. Gwei is NOT comparable across chains because the gas token differs in price; pricing in USD is the only ranking that answers where a transaction really costs least. For bridging, routing and execution-timing agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string"},"description":"Pass `all` for every chain ranked cheapest-first, or one of bsc, polygon, arbitrum, base, avalanche, optimism. Omitting it also returns all six, but a parameterless request is treated as a catalogue crawler and goes straight to the paywall — send chain=all to use the free tier."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getGas"}},"/polygon/price":{"get":{"summary":"Live token price in USD by ticker symbol or contract address on Polygon PoS","description":"Live token price in USD by ticker symbol or contract address on Polygon PoS - any ERC-20, not a fixed list. Real-time spot price read from QuickSwap, SushiSwap and Uniswap v3 pools at call time. What is this token worth right now. Returns priceUsd, the pair used, the USD liquidity backing the quote and a confidence rating, so a thin-pool number is never passed off as a market price. Onchain market data for trading bots and price oracles on Polygon / MATIC / POL.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol on Polygon PoS (e.g. WMATIC, WETH, WBTC, USDC, USDT, DAI, LINK)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonPrice"}},"/polygon/liquidity":{"get":{"summary":"DEX liquidity, market depth and TVL by venue for a trading pair on Polygon PoS","description":"DEX liquidity, market depth and TVL by venue for a trading pair on Polygon PoS - how deep is this pool, and where is the liquidity. Per-venue liquidity in USD across QuickSwap, SushiSwap and Uniswap v3, both pool reserves, each venue share of total depth, and the deepest venue to trade against. Live onchain pool state for WMATIC, WETH, WBTC, USDC, USDT, DAI, LINK, including stablecoin liquidity. For slippage estimation and order routing agents on Polygon / MATIC / POL.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Polygon PoS (e.g. WMATIC/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonLiquidity"}},"/polygon/reserves":{"get":{"summary":"Raw AMM pool reserves and live pool state for a trading pair on Polygon PoS","description":"Raw AMM pool reserves and live pool state for a trading pair on Polygon PoS. Constant-product and concentrated-liquidity (Uniswap v3 style) pools across QuickSwap, SushiSwap and Uniswap v3: both reserves, pool mid price, fee tier in bps, and USD TVL per venue at a stated block. The underlying onchain numbers for computing your own quotes, price impact, slippage or arbitrage math on Polygon / MATIC / POL.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Polygon PoS (e.g. WMATIC/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonReserves"}},"/polygon/route":{"get":{"summary":"Best execution price across DEXs on Polygon PoS","description":"Best execution price across DEXs on Polygon PoS - which DEX is cheapest to buy on and which pays most to sell into. Compares live prices across QuickSwap, SushiSwap and Uniswap v3 and returns the buy venue, the sell venue, the cross-exchange spread in bps, the fee-adjusted gross arbitrage spread and an optimal trade size. Smart order routing and cross-DEX arbitrage data for trading and execution agents on Polygon / MATIC / POL.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Polygon PoS (e.g. WMATIC/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonRoute"}},"/polygon/risk":{"get":{"summary":"Thin liquidity warning for a Polygon PoS trading pair before you trade it","description":"Thin liquidity warning for a Polygon PoS trading pair before you trade it. Classifies market depth DEEP, MODERATE, SHALLOW or VERY_THIN from live pool TVL across QuickSwap, SushiSwap and Uniswap v3, counts how many venues can actually route the trade, measures concentration in the largest venue, and flags single-venue markets and wide spreads. Pre-trade depth check. Depth analysis only - not a contract audit or honeypot check.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Polygon PoS (e.g. WMATIC/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonRisk"}},"/polygon/slippage":{"get":{"summary":"Price impact and slippage for a specific trade size on Polygon PoS","description":"Price impact and slippage for a specific trade size on Polygon PoS - what will my trade actually get, not just the spot price. Simulates the swap against live reserves across QuickSwap, SushiSwap and Uniswap v3 and returns the best execution venue, amount out, price impact in bps, the pool fee separately, and what correct routing saves versus picking the best quoted price. Pre-trade execution check for trading bots and DEX aggregators on Polygon / MATIC / POL.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Polygon PoS (e.g. WMATIC/USDC)."},{"name":"amountUsd","in":"query","required":true,"schema":{"type":"string"},"description":"Trade size in USD, e.g. 10000. Required unless amountIn is given instead."},{"name":"amountIn","in":"query","required":false,"schema":{"type":"string"},"description":"Trade size denominated in the FIRST pair symbol instead of USD. An alternative to amountUsd; supplying either one is enough."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonSlippage"}},"/polygon/scan":{"get":{"summary":"Live cross","description":"Live cross-DEX arbitrage scanner for Polygon PoS. Scans every liquid pair across QuickSwap, SushiSwap and Uniswap v3 and returns ranked cross-venue spreads: where to buy, where to sell, spread in bps, optimal trade size and gross USD at that size. GROSS, before gas and MEV. Venues below a liquidity floor are excluded, so a spread against a dust pool is never reported as an opportunity. For arbitrage bots on Polygon / MATIC / POL.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"minSpreadBps","in":"query","required":true,"schema":{"type":"string"},"description":"Minimum gross spread to report (default 10). Also minVenueTvlUsd (default 1000) and limit."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getPolygonScan"}},"/arbitrum/price":{"get":{"summary":"Live token price in USD by ticker symbol or contract address on Arbitrum One","description":"Live token price in USD by ticker symbol or contract address on Arbitrum One - any ERC-20, not a fixed list. Real-time spot price read from SushiSwap and Uniswap v3 fee tiers pools at call time. What is this token worth right now. Returns priceUsd, the pair used, the USD liquidity backing the quote and a confidence rating, so a thin-pool number is never passed off as a market price. Onchain market data for trading bots and price oracles on Arbitrum / ARB L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol on Arbitrum One (e.g. WETH, ARB, WBTC, USDC, USDT, LINK)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumPrice"}},"/arbitrum/liquidity":{"get":{"summary":"DEX liquidity, market depth and TVL by venue for a trading pair on Arbitrum One","description":"DEX liquidity, market depth and TVL by venue for a trading pair on Arbitrum One - how deep is this pool, and where is the liquidity. Per-venue liquidity in USD across SushiSwap and Uniswap v3 fee tiers, both pool reserves, each venue share of total depth, and the deepest venue to trade against. Live onchain pool state for WETH, ARB, WBTC, USDC, USDT, LINK, including stablecoin liquidity. For slippage estimation and order routing agents on Arbitrum / ARB L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Arbitrum One (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumLiquidity"}},"/arbitrum/reserves":{"get":{"summary":"Raw AMM pool reserves and live pool state for a trading pair on Arbitrum One","description":"Raw AMM pool reserves and live pool state for a trading pair on Arbitrum One. Constant-product and concentrated-liquidity (Uniswap v3 style) pools across SushiSwap and Uniswap v3 fee tiers: both reserves, pool mid price, fee tier in bps, and USD TVL per venue at a stated block. The underlying onchain numbers for computing your own quotes, price impact, slippage or arbitrage math on Arbitrum / ARB L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Arbitrum One (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumReserves"}},"/arbitrum/route":{"get":{"summary":"Best execution price across DEXs on Arbitrum One","description":"Best execution price across DEXs on Arbitrum One - which DEX is cheapest to buy on and which pays most to sell into. Compares live prices across SushiSwap and Uniswap v3 fee tiers and returns the buy venue, the sell venue, the cross-exchange spread in bps, the fee-adjusted gross arbitrage spread and an optimal trade size. Smart order routing and cross-DEX arbitrage data for trading and execution agents on Arbitrum / ARB L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Arbitrum One (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumRoute"}},"/arbitrum/risk":{"get":{"summary":"Thin liquidity warning for a Arbitrum One trading pair before you trade it","description":"Thin liquidity warning for a Arbitrum One trading pair before you trade it. Classifies market depth DEEP, MODERATE, SHALLOW or VERY_THIN from live pool TVL across SushiSwap and Uniswap v3 fee tiers, counts how many venues can actually route the trade, measures concentration in the largest venue, and flags single-venue markets and wide spreads. Pre-trade depth check. Depth analysis only - not a contract audit or honeypot check.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Arbitrum One (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumRisk"}},"/arbitrum/slippage":{"get":{"summary":"Price impact and slippage for a specific trade size on Arbitrum One","description":"Price impact and slippage for a specific trade size on Arbitrum One - what will my trade actually get, not just the spot price. Simulates the swap against live reserves across SushiSwap and Uniswap v3 fee tiers and returns the best execution venue, amount out, price impact in bps, the pool fee separately, and what correct routing saves versus picking the best quoted price. Pre-trade execution check for trading bots and DEX aggregators on Arbitrum / ARB L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Arbitrum One (e.g. WETH/USDC)."},{"name":"amountUsd","in":"query","required":true,"schema":{"type":"string"},"description":"Trade size in USD, e.g. 10000. Required unless amountIn is given instead."},{"name":"amountIn","in":"query","required":false,"schema":{"type":"string"},"description":"Trade size denominated in the FIRST pair symbol instead of USD. An alternative to amountUsd; supplying either one is enough."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumSlippage"}},"/arbitrum/scan":{"get":{"summary":"Live cross","description":"Live cross-DEX arbitrage scanner for Arbitrum One. Scans every liquid pair across SushiSwap and Uniswap v3 fee tiers and returns ranked cross-venue spreads: where to buy, where to sell, spread in bps, optimal trade size and gross USD at that size. GROSS, before gas and MEV. Venues below a liquidity floor are excluded, so a spread against a dust pool is never reported as an opportunity. For arbitrage bots on Arbitrum / ARB L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"minSpreadBps","in":"query","required":true,"schema":{"type":"string"},"description":"Minimum gross spread to report (default 10). Also minVenueTvlUsd (default 1000) and limit."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getArbitrumScan"}},"/avalanche/price":{"get":{"summary":"Live token price in USD by ticker symbol or contract address on Avalanche C","description":"Live token price in USD by ticker symbol or contract address on Avalanche C-Chain - any ERC-20, not a fixed list. Real-time spot price read from Trader Joe, Pangolin and Uniswap v3 pools at call time. What is this token worth right now. Returns priceUsd, the pair used, the USD liquidity backing the quote and a confidence rating, so a thin-pool number is never passed off as a market price. Onchain market data for trading bots and price oracles on Avalanche / AVAX C-Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol on Avalanche C-Chain (e.g. WAVAX, WETH, WBTC, USDC, USDT)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalanchePrice"}},"/avalanche/liquidity":{"get":{"summary":"DEX liquidity, market depth and TVL by venue for a trading pair on Avalanche C","description":"DEX liquidity, market depth and TVL by venue for a trading pair on Avalanche C-Chain - how deep is this pool, and where is the liquidity. Per-venue liquidity in USD across Trader Joe, Pangolin and Uniswap v3, both pool reserves, each venue share of total depth, and the deepest venue to trade against. Live onchain pool state for WAVAX, WETH, WBTC, USDC, USDT, including stablecoin liquidity. For slippage estimation and order routing agents on Avalanche / AVAX C-Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Avalanche C-Chain (e.g. WAVAX/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalancheLiquidity"}},"/avalanche/reserves":{"get":{"summary":"Raw AMM pool reserves and live pool state for a trading pair on Avalanche C","description":"Raw AMM pool reserves and live pool state for a trading pair on Avalanche C-Chain. Constant-product and concentrated-liquidity (Uniswap v3 style) pools across Trader Joe, Pangolin and Uniswap v3: both reserves, pool mid price, fee tier in bps, and USD TVL per venue at a stated block. The underlying onchain numbers for computing your own quotes, price impact, slippage or arbitrage math on Avalanche / AVAX C-Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Avalanche C-Chain (e.g. WAVAX/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalancheReserves"}},"/avalanche/route":{"get":{"summary":"Best execution price across DEXs on Avalanche C","description":"Best execution price across DEXs on Avalanche C-Chain - which DEX is cheapest to buy on and which pays most to sell into. Compares live prices across Trader Joe, Pangolin and Uniswap v3 and returns the buy venue, the sell venue, the cross-exchange spread in bps, the fee-adjusted gross arbitrage spread and an optimal trade size. Smart order routing and cross-DEX arbitrage data for trading and execution agents on Avalanche / AVAX C-Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Avalanche C-Chain (e.g. WAVAX/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalancheRoute"}},"/avalanche/risk":{"get":{"summary":"Thin liquidity warning for a Avalanche C","description":"Thin liquidity warning for a Avalanche C-Chain trading pair before you trade it. Classifies market depth DEEP, MODERATE, SHALLOW or VERY_THIN from live pool TVL across Trader Joe, Pangolin and Uniswap v3, counts how many venues can actually route the trade, measures concentration in the largest venue, and flags single-venue markets and wide spreads. Pre-trade depth check. Depth analysis only - not a contract audit or honeypot check.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Avalanche C-Chain (e.g. WAVAX/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalancheRisk"}},"/avalanche/slippage":{"get":{"summary":"Price impact and slippage for a specific trade size on Avalanche C","description":"Price impact and slippage for a specific trade size on Avalanche C-Chain - what will my trade actually get, not just the spot price. Simulates the swap against live reserves across Trader Joe, Pangolin and Uniswap v3 and returns the best execution venue, amount out, price impact in bps, the pool fee separately, and what correct routing saves versus picking the best quoted price. Pre-trade execution check for trading bots and DEX aggregators on Avalanche / AVAX C-Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Avalanche C-Chain (e.g. WAVAX/USDC)."},{"name":"amountUsd","in":"query","required":true,"schema":{"type":"string"},"description":"Trade size in USD, e.g. 10000. Required unless amountIn is given instead."},{"name":"amountIn","in":"query","required":false,"schema":{"type":"string"},"description":"Trade size denominated in the FIRST pair symbol instead of USD. An alternative to amountUsd; supplying either one is enough."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalancheSlippage"}},"/avalanche/scan":{"get":{"summary":"Live cross","description":"Live cross-DEX arbitrage scanner for Avalanche C-Chain. Scans every liquid pair across Trader Joe, Pangolin and Uniswap v3 and returns ranked cross-venue spreads: where to buy, where to sell, spread in bps, optimal trade size and gross USD at that size. GROSS, before gas and MEV. Venues below a liquidity floor are excluded, so a spread against a dust pool is never reported as an opportunity. For arbitrage bots on Avalanche / AVAX C-Chain.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"minSpreadBps","in":"query","required":true,"schema":{"type":"string"},"description":"Minimum gross spread to report (default 10). Also minVenueTvlUsd (default 1000) and limit."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getAvalancheScan"}},"/optimism/price":{"get":{"summary":"Live token price in USD by ticker symbol or contract address on OP Mainnet","description":"Live token price in USD by ticker symbol or contract address on OP Mainnet - any ERC-20, not a fixed list. Real-time spot price read from SushiSwap and Uniswap v3 fee tiers pools at call time. What is this token worth right now. Returns priceUsd, the pair used, the USD liquidity backing the quote and a confidence rating, so a thin-pool number is never passed off as a market price. Onchain market data for trading bots and price oracles on Optimism / OP L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol on OP Mainnet (e.g. WETH, OP, WBTC, USDC, USDT, DAI)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismPrice"}},"/optimism/liquidity":{"get":{"summary":"DEX liquidity, market depth and TVL by venue for a trading pair on OP Mainnet","description":"DEX liquidity, market depth and TVL by venue for a trading pair on OP Mainnet - how deep is this pool, and where is the liquidity. Per-venue liquidity in USD across SushiSwap and Uniswap v3 fee tiers, both pool reserves, each venue share of total depth, and the deepest venue to trade against. Live onchain pool state for WETH, OP, WBTC, USDC, USDT, DAI, including stablecoin liquidity. For slippage estimation and order routing agents on Optimism / OP L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on OP Mainnet (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismLiquidity"}},"/optimism/reserves":{"get":{"summary":"Raw AMM pool reserves and live pool state for a trading pair on OP Mainnet","description":"Raw AMM pool reserves and live pool state for a trading pair on OP Mainnet. Constant-product and concentrated-liquidity (Uniswap v3 style) pools across SushiSwap and Uniswap v3 fee tiers: both reserves, pool mid price, fee tier in bps, and USD TVL per venue at a stated block. The underlying onchain numbers for computing your own quotes, price impact, slippage or arbitrage math on Optimism / OP L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on OP Mainnet (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismReserves"}},"/optimism/route":{"get":{"summary":"Best execution price across DEXs on OP Mainnet","description":"Best execution price across DEXs on OP Mainnet - which DEX is cheapest to buy on and which pays most to sell into. Compares live prices across SushiSwap and Uniswap v3 fee tiers and returns the buy venue, the sell venue, the cross-exchange spread in bps, the fee-adjusted gross arbitrage spread and an optimal trade size. Smart order routing and cross-DEX arbitrage data for trading and execution agents on Optimism / OP L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on OP Mainnet (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismRoute"}},"/optimism/risk":{"get":{"summary":"Thin liquidity warning for a OP Mainnet trading pair before you trade it","description":"Thin liquidity warning for a OP Mainnet trading pair before you trade it. Classifies market depth DEEP, MODERATE, SHALLOW or VERY_THIN from live pool TVL across SushiSwap and Uniswap v3 fee tiers, counts how many venues can actually route the trade, measures concentration in the largest venue, and flags single-venue markets and wide spreads. Pre-trade depth check. Depth analysis only - not a contract audit or honeypot check.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on OP Mainnet (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismRisk"}},"/optimism/slippage":{"get":{"summary":"Price impact and slippage for a specific trade size on OP Mainnet","description":"Price impact and slippage for a specific trade size on OP Mainnet - what will my trade actually get, not just the spot price. Simulates the swap against live reserves across SushiSwap and Uniswap v3 fee tiers and returns the best execution venue, amount out, price impact in bps, the pool fee separately, and what correct routing saves versus picking the best quoted price. Pre-trade execution check for trading bots and DEX aggregators on Optimism / OP L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on OP Mainnet (e.g. WETH/USDC)."},{"name":"amountUsd","in":"query","required":true,"schema":{"type":"string"},"description":"Trade size in USD, e.g. 10000. Required unless amountIn is given instead."},{"name":"amountIn","in":"query","required":false,"schema":{"type":"string"},"description":"Trade size denominated in the FIRST pair symbol instead of USD. An alternative to amountUsd; supplying either one is enough."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismSlippage"}},"/optimism/scan":{"get":{"summary":"Live cross","description":"Live cross-DEX arbitrage scanner for OP Mainnet. Scans every liquid pair across SushiSwap and Uniswap v3 fee tiers and returns ranked cross-venue spreads: where to buy, where to sell, spread in bps, optimal trade size and gross USD at that size. GROSS, before gas and MEV. Venues below a liquidity floor are excluded, so a spread against a dust pool is never reported as an opportunity. For arbitrage bots on Optimism / OP L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"minSpreadBps","in":"query","required":true,"schema":{"type":"string"},"description":"Minimum gross spread to report (default 10). Also minVenueTvlUsd (default 1000) and limit."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getOptimismScan"}},"/base/price":{"get":{"summary":"Live token price in USD by ticker symbol or contract address on Base","description":"Live token price in USD by ticker symbol or contract address on Base - any ERC-20, not a fixed list. Real-time spot price read from BaseSwap, SushiSwap and Uniswap v3 pools at call time. What is this token worth right now. Returns priceUsd, the pair used, the USD liquidity backing the quote and a confidence rating, so a thin-pool number is never passed off as a market price. Onchain market data for trading bots and price oracles on Base L2 / Coinbase L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Token symbol on Base (e.g. WETH, cbBTC, USDC, DAI)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBasePrice"}},"/base/liquidity":{"get":{"summary":"DEX liquidity, market depth and TVL by venue for a trading pair on Base","description":"DEX liquidity, market depth and TVL by venue for a trading pair on Base - how deep is this pool, and where is the liquidity. Per-venue liquidity in USD across BaseSwap, SushiSwap and Uniswap v3, both pool reserves, each venue share of total depth, and the deepest venue to trade against. Live onchain pool state for WETH, cbBTC, USDC, DAI, including stablecoin liquidity. For slippage estimation and order routing agents on Base L2 / Coinbase L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Base (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBaseLiquidity"}},"/base/reserves":{"get":{"summary":"Raw AMM pool reserves and live pool state for a trading pair on Base","description":"Raw AMM pool reserves and live pool state for a trading pair on Base. Constant-product and concentrated-liquidity (Uniswap v3 style) pools across BaseSwap, SushiSwap and Uniswap v3: both reserves, pool mid price, fee tier in bps, and USD TVL per venue at a stated block. The underlying onchain numbers for computing your own quotes, price impact, slippage or arbitrage math on Base L2 / Coinbase L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Base (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBaseReserves"}},"/base/route":{"get":{"summary":"Best execution price across DEXs on Base","description":"Best execution price across DEXs on Base - which DEX is cheapest to buy on and which pays most to sell into. Compares live prices across BaseSwap, SushiSwap and Uniswap v3 and returns the buy venue, the sell venue, the cross-exchange spread in bps, the fee-adjusted gross arbitrage spread and an optimal trade size. Smart order routing and cross-DEX arbitrage data for trading and execution agents on Base L2 / Coinbase L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Base (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBaseRoute"}},"/base/risk":{"get":{"summary":"Thin liquidity warning for a Base trading pair before you trade it","description":"Thin liquidity warning for a Base trading pair before you trade it. Classifies market depth DEEP, MODERATE, SHALLOW or VERY_THIN from live pool TVL across BaseSwap, SushiSwap and Uniswap v3, counts how many venues can actually route the trade, measures concentration in the largest venue, and flags single-venue markets and wide spreads. Pre-trade depth check. Depth analysis only - not a contract audit or honeypot check.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Base (e.g. WETH/USDC)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBaseRisk"}},"/base/slippage":{"get":{"summary":"Price impact and slippage for a specific trade size on Base","description":"Price impact and slippage for a specific trade size on Base - what will my trade actually get, not just the spot price. Simulates the swap against live reserves across BaseSwap, SushiSwap and Uniswap v3 and returns the best execution venue, amount out, price impact in bps, the pool fee separately, and what correct routing saves versus picking the best quoted price. Pre-trade execution check for trading bots and DEX aggregators on Base L2 / Coinbase L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"pair","in":"query","required":true,"schema":{"type":"string"},"description":"Token pair as SYM/SYM on Base (e.g. WETH/USDC)."},{"name":"amountUsd","in":"query","required":true,"schema":{"type":"string"},"description":"Trade size in USD, e.g. 10000. Required unless amountIn is given instead."},{"name":"amountIn","in":"query","required":false,"schema":{"type":"string"},"description":"Trade size denominated in the FIRST pair symbol instead of USD. An alternative to amountUsd; supplying either one is enough."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBaseSlippage"}},"/base/scan":{"get":{"summary":"Live cross","description":"Live cross-DEX arbitrage scanner for Base. Scans every liquid pair across BaseSwap, SushiSwap and Uniswap v3 and returns ranked cross-venue spreads: where to buy, where to sell, spread in bps, optimal trade size and gross USD at that size. GROSS, before gas and MEV. Venues below a liquidity floor are excluded, so a spread against a dust pool is never reported as an opportunity. For arbitrage bots on Base L2 / Coinbase L2.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"minSpreadBps","in":"query","required":true,"schema":{"type":"string"},"description":"Minimum gross spread to report (default 10). Also minVenueTvlUsd (default 1000) and limit."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getBaseScan"}},"/geocode":{"get":{"summary":"Forward geocoding API","description":"Forward geocoding API - convert a street address, city or place name to latitude and longitude coordinates. Worldwide coverage via OpenStreetMap Nominatim. Returns lat, lon, display name, structured address parts, bounding box and an importance score, so an ambiguous match is visible instead of silently wrong. Results ranked by confidence; no match returns 404, never a guessed coordinate. For mapping, logistics, delivery, travel and location-aware AI agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Street address or place name, e.g. \"1600 Amphitheatre Parkway, Mountain View\" or \"Eiffel Tower, Paris\". Max 300 chars."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getGeocode"}},"/reverse-geocode":{"get":{"summary":"Reverse geocoding API","description":"Reverse geocoding API - convert latitude and longitude coordinates to a street address and place name. Worldwide coverage via OpenStreetMap Nominatim. Returns the display name and structured address (road, city, state, postcode, country) at that point, plus place type and category. Coordinates in the ocean or unmapped return 404, never a fabricated address. For mapping, logistics, delivery tracking, geofencing and location-aware AI agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"string"},"description":"Latitude, -90..90 (e.g. 48.8584)."},{"name":"lon","in":"query","required":true,"schema":{"type":"string"},"description":"Longitude, -180..180 (e.g. 2.2945)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getReverseGeocode"}},"/random":{"get":{"summary":"Cryptographically secure random number generator API","description":"Cryptographically secure random number generator API - CSPRNG randomness for AI agents that are deterministic or sandboxed and cannot generate their own. Uniform random integers in any min-max range (rejection-sampled, so no modulo bias) or raw random bytes returned as hex and base64. For nonces, session tokens, unique IDs, sampling, shuffling, lotteries and simulations. Generated server-side; the response states its source and limits plainly.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"bytes","in":"query","required":false,"schema":{"type":"string"},"description":"Random bytes to return, 1..1024 (default 32). Returned as hex and base64url."},{"name":"min","in":"query","required":false,"schema":{"type":"string"},"description":"With max: return uniform integers in [min, max] inclusive instead of bytes."},{"name":"max","in":"query","required":false,"schema":{"type":"string"},"description":"Upper bound (inclusive) for integer mode. Must be greater than min."},{"name":"count","in":"query","required":false,"schema":{"type":"string"},"description":"How many integers, 1..1000 (default 1). Integer mode only."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getRandom"}},"/markdown":{"get":{"summary":"Web article and PDF to Markdown converter API","description":"Web article and PDF to Markdown converter API - fetch any public URL and get clean Markdown plus title, byline, site name, excerpt and word count. HTML is extracted with Firefox reader-mode rules (Readability); PDFs return their text layer with page count. Honest failures: image-only PDFs return no_text_layer, client-rendered app shells return not_extractable - never an empty page passed off as the article. For AI agents, research pipelines, summarizers and content ingestion.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"Public http(s) URL of an article or PDF, e.g. https://en.wikipedia.org/wiki/Markdown. Private and internal hosts are refused. Fetch cap 8 MB, output cap 400K chars."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getMarkdown"}},"/weather":{"get":{"summary":"Weather API","description":"Weather API - current conditions and up to a 7-day forecast for any coordinates worldwide. Returns temperature, feels-like, humidity, precipitation, wind speed, gusts and direction now, plus daily highs, lows, precipitation totals and probability. Every condition carries both the standard WMO code and a plain-text description, with units stated explicitly. Model forecast, and the response says so. Pair with /geocode to go from a place name to coordinates.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"string"},"description":"Latitude, -90..90 (e.g. 40.7128)."},{"name":"lon","in":"query","required":true,"schema":{"type":"string"},"description":"Longitude, -180..180 (e.g. -74.0060)."},{"name":"days","in":"query","required":false,"schema":{"type":"string"},"description":"Forecast days, 1..7 (default 3)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getWeather"}},"/search":{"get":{"summary":"Web search API","description":"Web search API - free-text query to ranked organic results, each with title, real destination URL, display URL and snippet. Sponsored rows are excluded. Returns up to 25 results; count is a maximum, not a guarantee, because a row whose destination cannot be resolved is dropped rather than guessed at. Results are not fetched or verified, and the response says so. Pair with /markdown to turn any result URL into clean Markdown.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search terms, max 500 characters (e.g. x402 protocol)."},{"name":"count","in":"query","required":false,"schema":{"type":"string"},"description":"Maximum results, 1..25 (default 10)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getSearch"}},"/suggest":{"get":{"summary":"Search autocomplete and keyword research API","description":"Search autocomplete and keyword research API - what people actually type into a search box for any topic. Returns live Google Autocomplete completions, expanded across question modifiers (how, what, why, is, can, does) and comparison modifiers (vs, or), then split into suggestions, questions and comparisons. Off-topic rows that drop the original term are filtered out and counted, so the list stays about your query. Demand signal for SEO, content planning and market research agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Topic or search terms, max 200 characters (e.g. electric vehicles)."},{"name":"depth","in":"query","required":false,"schema":{"type":"string"},"description":"\"full\" (default) expands across 15 question and comparison modifiers; \"basic\" returns completions for the query alone."},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Two-letter market code, default us (e.g. gb, de, jp)."},{"name":"lang","in":"query","required":false,"schema":{"type":"string"},"description":"Language code, default en."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getSuggest"}},"/holidays":{"get":{"summary":"Public and bank holiday API for 100+ countries, and the business","description":"Public and bank holiday API for 100+ countries, and the business-day answer behind it. Returns every holiday for a country and year with local and English names, whether it is nationwide, and which regions observe it. Pass a date and it also answers directly: is this a business day, and if not, what are the next and previous ones - weekends and holidays both counted, walked across year boundaries. For settlement, SLA, payroll, scheduling and logistics agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string"},"description":"ISO 3166-1 alpha-2 country code, e.g. US, GB, DE, JP."},{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"YYYY-MM-DD. Adds the isBusinessDay answer plus next and previous business days."},{"name":"year","in":"query","required":false,"schema":{"type":"string"},"description":"Calendar year 1975..2100 (default: current year). Ignored when date is given."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getHolidays"}},"/feed":{"get":{"summary":"RSS, Atom and RDF feed to clean JSON","description":"RSS, Atom and RDF feed to clean JSON. Any public feed URL returns the feed title, link, description and last-updated, plus items with title, real destination link, id, author, categories and the published date both verbatim and normalised to ISO 8601. Each summary comes back twice: the feed HTML as published, and a plain-text rendering an agent can put straight into a prompt. An unparseable date is null rather than an invented timestamp. Private and internal hosts are refused.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"Public http(s) URL of an RSS 2.0, Atom or RDF feed. Private and internal hosts are refused. Fetch cap 8 MB."},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"Maximum items, 1..100 (default 20). totalItems reports how many the feed actually held."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getFeed"}},"/ip":{"get":{"summary":"IP geolocation API","description":"IP geolocation API - country, region, city, postcode, coordinates, timezone and network for any public IPv4 or IPv6 address, plus the field that decides whether to believe any of it. Datacentre, VPN, proxy and Tor detection is returned first, and when the upstream does not supply it the answer says unknown rather than clean - a missing signal is never reported as a negative one. ASN, org, ISP and domain are included so a hosting provider stays visible.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"priceUsd":"$0.003","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"ip","in":"query","required":true,"schema":{"type":"string"},"description":"Public IPv4 or IPv6 address, e.g. 8.8.8.8. Private, loopback, link-local and reserved ranges are refused."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getIp"}},"/lei":{"get":{"summary":"Legal Entity Identifier (LEI) lookup from the GLEIF golden copy","description":"Legal Entity Identifier (LEI) lookup from the GLEIF golden copy. Search by company NAME, not just by identifier - knowing the LEI already is the hard part. Returns the LEI, registered legal name, previous names, legal form, jurisdiction, legal and headquarters addresses, and the registration record. Status comes back as a lapsed flag: LAPSED, RETIRED and ANNULLED entities are returned rather than hidden, because a filtered record and no record look identical. For KYC and compliance agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"priceUsd":"$0.03","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Legal entity name, max 200 chars. Include the suffix for a precise match, e.g. \"Apple Inc.\" rather than \"Apple\"."},{"name":"lei","in":"query","required":false,"schema":{"type":"string"},"description":"Exact 20-character LEI for a single record. Use instead of q."},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"Maximum name-search results, 1..50 (default 10)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getLei"}},"/treasury":{"get":{"summary":"US Treasury par yield curve API","description":"US Treasury par yield curve API - every constant-maturity rate from 1 month to 30 years for any published business day, plus the spreads nobody wants to compute themselves. 2s10s, 3m10y and 5s30s are returned with an explicit inversion flag, because the real question is whether the curve is inverted, not what fourteen numbers are. A tenor Treasury did not publish that day is null, never zero. For macro, rates, credit and risk agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"priceUsd":"$0.03","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"latest","in":"query","required":false,"schema":{"type":"string"},"description":"Pass latest=1 for the most recent published curve. Use instead of date, not with it."},{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"YYYY-MM-DD business day, for a specific past day. A non-publication day returns 404 with the available range, not the nearest guess."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getTreasury"}},"/sanctions":{"get":{"summary":"OFAC sanctions screening","description":"OFAC sanctions screening. Checks a person or company against the US Treasury SDN and Consolidated lists - 19,600+ designated parties, 40,000+ names including every alias - and returns the matched record with its sanctions programs, designation remarks and a match score. Word order does not matter, because OFAC stores people as \"SURNAME, Given\" and your caller will not. A list that cannot be loaded returns 503, never a clear. For KYC, payments and compliance agents.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"priceUsd":"$0.01","currency":"USDC","network":"eip155:8453","protocols":[{"mpp":{"method":"evm","intent":"charge","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}},{"x402":{}}]},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"description":"Person or company name to screen, max 200 chars. Word order does not matter."},{"name":"minScore","in":"query","required":false,"schema":{"type":"string"},"description":"Match threshold 0.1..1 (default 0.6). 1.0 is an exact name-token match."},{"name":"type","in":"query","required":false,"schema":{"type":"string"},"description":"Filter to individual, entity, vessel or aircraft."},{"name":"limit","in":"query","required":false,"schema":{"type":"string"},"description":"Maximum matches returned, 1..50 (default 10)."}],"responses":{"200":{"description":"JSON payload — see the x402 Bazaar output example for this route.","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"x402 V2 payment challenge (PAYMENT-REQUIRED header, base64 JSON)."}},"operationId":"getSanctions"}}}}