{"slug":"1gateway-dev-v1-x402-recommend-fceea1","title":"Use when an agent must pick a paid x402 API for a task","host":"1gateway.dev","method":"GET","resource":"https://1gateway.dev/v1/x402/recommend","category":"market","description":"Use when an agent must pick a paid x402 API for a task. Input: q (task in plain words or keywords), optional max_price (USD), network (base, solana or CAIP-2), limit (1-20). Output: JSON ranked endpoints: resource URL, method, description, price, networks, seller, 30-day payers and calls (Bazaar), s","price_listed":0.009,"price_asked":0.009,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":784,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"include_flagged":"true","limit":5,"max_price":0.02,"network":"base","q":"base token honeypot check"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"include_flagged":{"description":"false drops routes flagged scanner_like or uniform_payers (suspected probes / wash); default true (flagged routes are kept but ranked lower)","enum":["true","false"],"examples":["true"],"type":"string"},"limit":{"description":"Number of results (default 8)","examples":[5],"maximum":20,"minimum":1,"type":"integer"},"max_price":{"description":"Only endpoints priced at or below this many USD per call","examples":[0.02],"maximum":1000,"minimum":0,"type":"number"},"network":{"description":"Only endpoints that accept this network: base, solana, polygon, arbitrum, optimism, ethereum, avalanche, worldchain, monad, or a CAIP-2 id (eip155:8453)","examples":["base"],"pattern":"^[A-Za-z0-9:]{2,60}$","type":"string"},"q":{"description":"What the API should do, in plain words or keywords (e.g. 'korean apartment prices', 'convert pdf to markdown'). Text only: never fetched as a URL","examples":["base token honeypot check"],"maxLength":300,"type":"string"}},"required":["q"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"as_of":{"type":"string"},"flag_definitions":{"properties":{"few_payers":{"type":"string"},"inactive_14d":{"type":"string"},"scanner_like":{"type":"string"},"thin_description":{"type":"string"},"trivial_route":{"type":"string"},"uniform_payers":{"type":"string"}},"type":"object"},"index":{"properties":{"bazaar_crawled_at":{"type":"string"},"bazaar_resources_crawled":{"type":"integer"},"inclusion":{"type":"string"},"routes":{"type":"integer"},"sellers":{"type":"integer"},"version":{"type":"string"},"x402scan_crawled_at":{"type":"string"},"x402scan_sellers_crawled":{"type":"integer"}},"type":"object"},"matched_total":{"type":"integer"},"operator_disclosure":{"type":"string"},"query":{"properties":{"include_flagged":{"type":"boolean"},"limit":{"type":"integer"},"max_price":{"type":["number","null"]},"network":{"type":["string","null"]},"q":{"type":"string"},"terms":{"items":{"type":"string"},"type":"array"}},"type":"object"},"ranking":{"type":"string"},"results":{"items":{"properties":{"demand":{"properties":{"bazaar_last_called":{"type":["string","null"]},"bazaar_route_calls_30d":{"type":"integer"},"bazaar_route_payers_30d":{"type":"integer"},"x402scan_seller_buyers_30d":{"type":["integer","null"]},"x402scan_seller_tx_30d":{"type":["integer","null"]},"x402scan_seller_volume_usd_30d":{"type":["integer","null"]}},"type":"object"},"description":{"type":"string"},"flags":{"items":{"type":"string"},"type":"array"},"matched_terms":{"items":{"type":"string"},"type":"array"},"method":{"type":"string"},"networks":{"items":{"type":"string"},"type":"array"},"price_usd":{"type":"number"},"rank":{"type":"integer"},"resource":{"type":"string"},"score":{"type":"number"},"seller":{"properties":{"host":{"type":"string"},"pay_to":{"type":"string"}},"type":"object"},"service_name":{"type":["string","null"]},"tags":{"items":{"type":"string"},"type":"array"},"text_match":{"type":"number"}},"type":"object"},"type":"array"},"sources":{"type":"string"}},"required":["as_of","query","matched_total","results","index","ranking","flag_definitions","operator_disclosure","sources"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.009,"price_match":true,"latency_ms":784,"error":null}],"description_full":"Use when an agent must pick a paid x402 API for a task. Input: q (task in plain words or keywords), optional max_price (USD), network (base, solana or CAIP-2), limit (1-20). Output: JSON ranked endpoints: resource URL, method, description, price, networks, seller, 30-day payers and calls (Bazaar), seller buyers (x402scan), wash/quality flags, score, index as_of. Same rules for every seller. Example: ?q=base+token+honeypot+check&max_price=0.02","last_updated":"2026-10-18T16:45:04.36Z","schemes":["exact"]}