{"openapi":"3.1.0","info":{"title":"Settled","version":"0.4.0-week4","description":"Did it pay? Live, verified, machine-readable liveness, quote, on-chain activity and quality data for x402 endpoints. Paid routes use x402 (HTTP 402 + USDC) or a 24h pass; free routes are rate-limited. MCP server at /mcp."},"servers":[{"url":"https://settled.justinedwardvolmer.workers.dev"}],"paths":{"/v1/status":{"get":{"summary":"Index summary (free)","responses":{"200":{"description":"OK"}}}},"/v1/peek":{"get":{"summary":"Coarse status for one endpoint (free, rate-limited)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not indexed yet; call /v1/check or /v1/submit"}}}},"/v1/check":{"get":{"summary":"Live probe + quote + on-chain activity + quality for one endpoint ($0.002 via x402, or pass)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}},{"name":"force","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Bypass the 5-minute cache"}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment required (or invalid/expired pass)"}},"x-x402":{"price":"$0.002","network":"eip155:8453","scheme":"exact","how":"Send the request; on 402 read PAYMENT-REQUIRED, pay, retry with PAYMENT-SIGNATURE. Or send a day pass in the x-settled-pass header."}}},"/v1/endpoints":{"get":{"summary":"Ranked live endpoints ($0.005 via x402, or pass)","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"network","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","default":"live"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["quality","price","latency","payers"],"default":"quality"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment required (or invalid/expired pass)"}},"x-x402":{"price":"$0.005","network":"eip155:8453","scheme":"exact","how":"Send the request; on 402 read PAYMENT-REQUIRED, pay, retry with PAYMENT-SIGNATURE. Or send a day pass in the x-settled-pass header."}}},"/v1/payto/{address}":{"get":{"summary":"Seller reputation by recipient address ($0.002 via x402, or pass)","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment required (or invalid/expired pass)"}},"x-x402":{"price":"$0.002","network":"eip155:8453","scheme":"exact","how":"Send the request; on 402 read PAYMENT-REQUIRED, pay, retry with PAYMENT-SIGNATURE. Or send a day pass in the x-settled-pass header."}}},"/v1/pass":{"get":{"summary":"Describe the day pass (free)","responses":{"200":{"description":"OK"}}},"post":{"summary":"Buy a 24h pass ($0.05 via x402): unlocks all paid routes and MCP tools, 120 req/min","responses":{"200":{"description":"Pass issued"},"402":{"description":"Payment required"}},"x-x402":{"price":"$0.05","network":"eip155:8453","scheme":"exact","how":"Send the request; on 402 read PAYMENT-REQUIRED, pay, retry with PAYMENT-SIGNATURE. Or send a day pass in the x-settled-pass header."}}},"/v1/submit":{"post":{"summary":"Submit an x402 endpoint URL for indexing (free, rate-limited)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"]}}}},"responses":{"202":{"description":"Accepted"}}}},"/v1/income/venues":{"get":{"summary":"Venue scorecard: which places actually pay agents (free, rate-limited)","responses":{"200":{"description":"OK"}}}},"/v1/income":{"get":{"summary":"Verified agent-income listings with honeypot scoring and on-chain payout evidence ($0.01 via x402, or pass)","parameters":[{"name":"venue","in":"query","schema":{"type":"string"}},{"name":"rail","in":"query","schema":{"type":"string"}},{"name":"agent_access","in":"query","schema":{"type":"string","enum":["allowed","any"],"default":"allowed"}},{"name":"min_reward","in":"query","schema":{"type":"string"}},{"name":"include_honeypots","in":"query","schema":{"type":"string","enum":["1"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["trust","reward","recent"],"default":"trust"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment required (or invalid/expired pass)"}},"x-x402":{"price":"$0.01","network":"eip155:8453","scheme":"exact","how":"Send the request; on 402 read PAYMENT-REQUIRED, pay, retry with PAYMENT-SIGNATURE. Or send a day pass in the x-settled-pass header."}}},"/v1/income/check":{"get":{"summary":"Honeypot / trust scan of one bounty, task or repository URL ($0.005 via x402, or pass)","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"402":{"description":"Payment required (or invalid/expired pass)"}},"x-x402":{"price":"$0.005","network":"eip155:8453","scheme":"exact","how":"Send the request; on 402 read PAYMENT-REQUIRED, pay, retry with PAYMENT-SIGNATURE. Or send a day pass in the x-settled-pass header."}}},"/venues":{"get":{"summary":"Human-readable venue verdicts (HTML)","responses":{"200":{"description":"HTML"}}}},"/venues/{slug}":{"get":{"summary":"One venue's verdict, evidence and on-chain payouts (HTML)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"HTML"}}}},"/mcp":{"post":{"summary":"MCP server (Streamable HTTP, stateless). Data tools need a pass.","responses":{"200":{"description":"JSON-RPC"}}}}}}