{"openapi":"3.1.0","info":{"title":"x402 recommend","version":"0.2.0","description":"Which x402 API should my agent call? Describe the task in plain words (need=) and get up to 5 x402 APIs ranked by relevance plus CDP Bazaar-reported 30-day usage (unique payers, repeat ratio, last call; sellers paid via other facilitators may show 0; sweeper-like usage is flagged and not rewarded), each re-checked right now for a 402 payment challenge (unless probe=0), with price, network, payTo, method, example input and risk flags. Mainnets only unless network= asks. $0.002 per call; 400/404/5xx are not charged.","x-guidance":"Call GET /recommend?need=<task in plain words> (optional limit=1-5, network=base|solana|CAIP-2|any, max_price=<USD>, probe=0) or POST /recommend with JSON {need, limit, network, max_price, probe} to find which x402 API to call for a task. Each pick has URL, method, price, payTo, example input, CDP Bazaar-reported 30-day usage with risk flags, and a live 402 check. Any unpaid request returns 402 first. After payment is verified, bad parameters (400), no results (404) and upstream failures (502/504) are not settled, so not charged.","contact":{"email":"deeng@mail.grokbot.com"}},"servers":[{"url":"https://x402-recommend.agentpageread.workers.dev"}],"paths":{"/recommend":{"get":{"operationId":"recommendX402Api","summary":"Recommend live x402 APIs for a task","tags":["Discovery"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x6CEC0Bd3Dfe86d5fd6d7190e5479199B0B1F8c5E"},"parameters":[{"name":"need","in":"query","required":true,"description":"Task in plain words","schema":{"type":"string","minLength":1,"maxLength":300},"example":"web search"},{"name":"limit","in":"query","required":false,"description":"Number of picks","schema":{"type":"integer","minimum":1,"maximum":5,"default":3}},{"name":"network","in":"query","required":false,"description":"Only offers on this network: CAIP-2 or base|solana|polygon|arbitrum|optimism|avalanche|any. Default: any mainnet, Base offer preferred. Testnets only when named.","schema":{"type":"string"}},{"name":"max_price","in":"query","required":false,"description":"Only offers with a known USD price at or below this (USD per call)","schema":{"type":"number"}},{"name":"probe","in":"query","required":false,"description":"0 to skip the live 402 re-check (faster; live_check.checked=false)","schema":{"type":"string","enum":["0","1"],"default":"1"}}],"responses":{"200":{"description":"Ranked picks with evidence, live check and limits","content":{"application/json":{"schema":{"type":"object","required":["need","picks","meta"],"properties":{"need":{"type":"string"},"filters":{"type":"object"},"picks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"method":{"type":"string"},"description":{"type":"string"},"service":{"type":["string","null"]},"offer":{"type":"object","properties":{"network":{"type":"string"},"price_usd":{"type":["number","null"]},"amount_atomic":{"type":["string","null"]},"asset":{"type":"string"},"asset_symbol":{"type":["string","null"]},"payTo":{"type":"string"},"scheme":{"type":"string"},"known_stablecoin":{"type":"boolean"}}},"example_input":{"type":["object","null"]},"evidence":{"type":"object","description":"CDP Bazaar-reported 30-day usage only; sellers paid via other facilitators may show 0","properties":{"usage_source":{"type":"string"},"cdp_bazaar_calls_30d":{"type":"integer"},"cdp_bazaar_unique_payers_30d":{"type":"integer"},"repeat_ratio":{"type":["number","null"]},"last_called_at":{"type":["string","null"]},"days_since_last_call":{"type":["integer","null"]},"flags":{"type":"array","items":{"type":"string","enum":["SELLER_DESCRIPTION_UNVERIFIED","NO_CDP_BAZAAR_USAGE_30D","FEW_CDP_BAZAAR_PAYERS_30D","CALLS_ABOUT_EQUAL_PAYERS","UNIFORM_ACROSS_SELLER_ENDPOINTS","NO_CALLS_LAST_7D"]}}}},"live_check":{"type":"object","properties":{"checked":{"type":"boolean"},"http_status":{"type":["integer","null"]},"payment_challenge":{"type":"boolean"},"latency_ms":{"type":"integer"}}},"score":{"type":"number"},"relevance_rank":{"type":"integer"}}}},"dropped_not_live":{"type":"array","items":{"type":"object"}},"meta":{"type":"object"}}},"example":{"need":"web search","picks":[{"url":"https://websearch.use.x402atlas.com/search","method":"GET","offer":{"network":"eip155:8453","price_usd":0.01,"asset_symbol":"USDC","payTo":"0xF752eEB75d3Bea24AA867ad93bfd8EF5a2F431B9"},"evidence":{"usage_source":"cdp_bazaar_quality","cdp_bazaar_calls_30d":102,"cdp_bazaar_unique_payers_30d":27,"repeat_ratio":3.8,"last_called_at":"2026-10-19T08:29:56.063Z","days_since_last_call":1,"flags":["SELLER_DESCRIPTION_UNVERIFIED"]},"live_check":{"checked":true,"http_status":402,"payment_challenge":true,"latency_ms":243}}],"meta":{"generated_at":"2026-10-21T06:18:34.666Z","note":"Real captured result (first pick only), 2026-10-21. Usage = CDP Bazaar-reported counts."}}}}},"400":{"description":"Bad parameters, checked after payment verification; settlement cancelled (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No matching live offers (not charged)"},"502":{"description":"Discovery source failed (not charged)"},"504":{"description":"Discovery source timed out (not charged)"}}},"post":{"operationId":"recommendX402ApiPost","summary":"Same as GET, with a JSON body","tags":["Discovery"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}],"network":"eip155:8453","payTo":"0x6CEC0Bd3Dfe86d5fd6d7190e5479199B0B1F8c5E"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["need"],"properties":{"need":{"type":"string","minLength":1,"maxLength":300},"limit":{"type":"integer","minimum":1,"maximum":5},"network":{"type":"string"},"max_price":{"type":"number"},"probe":{"type":"integer","enum":[0,1]}}},"example":{"need":"web search","limit":3}}}},"responses":{"200":{"description":"Ranked picks with evidence, live check and limits","content":{"application/json":{"schema":{"type":"object","required":["need","picks","meta"],"properties":{"need":{"type":"string"},"filters":{"type":"object"},"picks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"method":{"type":"string"},"description":{"type":"string"},"service":{"type":["string","null"]},"offer":{"type":"object","properties":{"network":{"type":"string"},"price_usd":{"type":["number","null"]},"amount_atomic":{"type":["string","null"]},"asset":{"type":"string"},"asset_symbol":{"type":["string","null"]},"payTo":{"type":"string"},"scheme":{"type":"string"},"known_stablecoin":{"type":"boolean"}}},"example_input":{"type":["object","null"]},"evidence":{"type":"object","description":"CDP Bazaar-reported 30-day usage only; sellers paid via other facilitators may show 0","properties":{"usage_source":{"type":"string"},"cdp_bazaar_calls_30d":{"type":"integer"},"cdp_bazaar_unique_payers_30d":{"type":"integer"},"repeat_ratio":{"type":["number","null"]},"last_called_at":{"type":["string","null"]},"days_since_last_call":{"type":["integer","null"]},"flags":{"type":"array","items":{"type":"string","enum":["SELLER_DESCRIPTION_UNVERIFIED","NO_CDP_BAZAAR_USAGE_30D","FEW_CDP_BAZAAR_PAYERS_30D","CALLS_ABOUT_EQUAL_PAYERS","UNIFORM_ACROSS_SELLER_ENDPOINTS","NO_CALLS_LAST_7D"]}}}},"live_check":{"type":"object","properties":{"checked":{"type":"boolean"},"http_status":{"type":["integer","null"]},"payment_challenge":{"type":"boolean"},"latency_ms":{"type":"integer"}}},"score":{"type":"number"},"relevance_rank":{"type":"integer"}}}},"dropped_not_live":{"type":"array","items":{"type":"object"}},"meta":{"type":"object"}}},"example":{"need":"web search","picks":[{"url":"https://websearch.use.x402atlas.com/search","method":"GET","offer":{"network":"eip155:8453","price_usd":0.01,"asset_symbol":"USDC","payTo":"0xF752eEB75d3Bea24AA867ad93bfd8EF5a2F431B9"},"evidence":{"usage_source":"cdp_bazaar_quality","cdp_bazaar_calls_30d":102,"cdp_bazaar_unique_payers_30d":27,"repeat_ratio":3.8,"last_called_at":"2026-10-19T08:29:56.063Z","days_since_last_call":1,"flags":["SELLER_DESCRIPTION_UNVERIFIED"]},"live_check":{"checked":true,"http_status":402,"payment_challenge":true,"latency_ms":243}}],"meta":{"generated_at":"2026-10-21T06:18:34.666Z","note":"Real captured result (first pick only), 2026-10-21. Usage = CDP Bazaar-reported counts."}}}}},"400":{"description":"Bad parameters, checked after payment verification; settlement cancelled (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"No matching live offers (not charged)"},"502":{"description":"Discovery source failed (not charged)"},"504":{"description":"Discovery source timed out (not charged)"}}}},"/":{"get":{"operationId":"about","summary":"Human/agent-readable description and example","security":[],"responses":{"200":{"description":"Text or JSON description"}}}},"/llms.txt":{"get":{"operationId":"llms","summary":"Plain-text description for LLM agents","security":[],"responses":{"200":{"description":"text"}}}},"/health":{"get":{"operationId":"health","summary":"Health check","security":[],"responses":{"200":{"description":"ok"}}}},"/openapi.json":{"get":{"operationId":"openapi","summary":"This document","security":[],"responses":{"200":{"description":"OpenAPI"}}}}}}