{"openapi":"3.1.0","info":{"title":"Vedetta x402 Gateway","description":"Vedetta — pay-per-call market intelligence for AI agents. Live analyst answers, sentiment-vs-price divergence verdicts (crypto AND US stocks), market-wide pulse, prediction-market odds, social sentiment, news reads, narrative rotation, event probes, a half-cent task router, cached snapshots, signal history and a verifiable track record. x402 micropayments in USDC on Base — no API key, no subscription, HTTP 402 per call, prices from $0.005; every live analyst read under $0.10. Install: /install (Hermes Agent skill, Base MCP agent card, raw x402). Also reachable as a free chat agent on Fetch.ai Agentverse / ASI:One (search \"Vedetta\") for a cached-signal teaser that routes to these same priced endpoints. Descriptive research, not financial advice.","contact":{"name":"Vedetta","url":"https://vedetta.dethboy.com/","email":"vedetta@dethboy.com"},"version":"2.11.3","x-guidance":"Vedetta sells pay-per-call crypto/stock/macro market intelligence over the x402 payment protocol (USDC on Base). No signup, no API key — payment is authentication. Call any /v1/* route unpaid and the HTTP 402 response body is a machine-readable offer (price, network, payTo); settle with any x402 client and retry. Spend path: GET /v1/route?task=... ($0.005) picks the right endpoint for a plain-English task; cached reads $0.005-$0.03; every live analyst read a flat $0.09. Payment settles only on a successful 2xx answer — a 5xx/504 costs nothing. Machine catalogs: /.well-known/x402.json, /registry.json, /llms.txt. Descriptive research, not financial advice."},"paths":{"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/ask":{"get":{"tags":["analyst"],"summary":"Ask","description":"Live analyst query. Latency = the analyst's reply time (plus queue if busy).","operationId":"ask_v1_ask_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","title":"Q"}},{"name":"asset","in":"query","required":false,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/consensus":{"get":{"tags":["consensus"],"summary":"Consensus Endpoint","description":"Divergence verdict. Cached read fresh → ~10s. Cached read missing/stale →\na live analyst refresh runs inside this call first (adds 10-90s).","operationId":"consensus_endpoint_v1_consensus_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/equity":{"get":{"tags":["probes"],"summary":"Equity","description":"Live divergence read on a US stock ticker — the desk covers equities too.","operationId":"equity_v1_equity_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/macro":{"get":{"tags":["probes"],"summary":"Macro","description":"Live analyst read on a macro instrument (SPX, VIX, US10Y, GOLD, OIL...).","operationId":"macro_v1_macro_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/prediction":{"get":{"tags":["probes"],"summary":"Prediction","description":"Falsifiable analyst prediction: claim + confidence + falsifier.\nAudit resolution honesty via /v1/track-record ($0.01).","operationId":"prediction_v1_prediction_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}},{"name":"horizon","in":"query","required":false,"schema":{"type":"string","default":"7d","title":"Horizon"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/theme":{"get":{"tags":["probes"],"summary":"Theme Endpoint","description":"Deep-dive on a tracked market theme/narrative.","operationId":"theme_endpoint_v1_theme_get","parameters":[{"name":"theme","in":"query","required":true,"schema":{"type":"string","title":"Theme"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/trend":{"get":{"tags":["probes"],"summary":"Trend","description":"Price-vs-sentiment trajectory over a window.","operationId":"trend_v1_trend_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}},{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"7d","title":"Window"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/news-read":{"get":{"tags":["probes"],"summary":"News Read","description":"Most significant market-moving story on an asset + the sentiment read on it.","operationId":"news_read_v1_news_read_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/pulse":{"get":{"tags":["probes"],"summary":"Pulse","description":"Market-wide regime read — no asset parameter.","operationId":"pulse_v1_pulse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/house-view":{"get":{"tags":["probes"],"summary":"House View","operationId":"house_view_v1_house_view_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/event":{"get":{"tags":["probes"],"summary":"Event","operationId":"event_v1_event_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/odds":{"get":{"tags":["probes"],"summary":"Odds","operationId":"odds_v1_odds_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/social":{"get":{"tags":["probes"],"summary":"Social","operationId":"social_v1_social_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/narrative":{"get":{"tags":["probes"],"summary":"Narrative","operationId":"narrative_v1_narrative_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}]}}},"/v1/screener":{"get":{"tags":["snapshot"],"summary":"Screener","description":"Cross-asset divergence screener from CACHED signals (cost rule: never\nfires an analyst question). The one cross-asset view the desk's\none-asset-per-reply format can't produce live — the cache can.","operationId":"screener_v1_screener_get","parameters":[{"name":"only","in":"query","required":false,"schema":{"type":"string","title":"Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]}}},"/v1/snapshot":{"get":{"tags":["snapshot"],"summary":"Snapshot","description":"CACHED-ONLY (cost rule): never fires an analyst question. The $0.02\nentry point — check signal_age_minutes/stale and escalate to /v1/consensus\nif you need guaranteed freshness.","operationId":"snapshot_v1_snapshot_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]}}},"/v1/history":{"get":{"tags":["snapshot"],"summary":"History Endpoint","description":"Cached signal history — backtest fodder. Zero analyst cost (cost rule).","operationId":"history_endpoint_v1_history_get","parameters":[{"name":"asset","in":"query","required":true,"schema":{"type":"string","title":"Asset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/v1/feed":{"get":{"tags":["snapshot"],"summary":"Feed Endpoint","description":"Cached post stream — instant return, no long-poll, no freshness promise.\nZero analyst cost (cost rule). Poll cheaply; escalate to a live read.","operationId":"feed_endpoint_v1_feed_get","parameters":[{"name":"since_id","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Since Id"}},{"name":"asset","in":"query","required":false,"schema":{"type":"string","title":"Asset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]}}},"/v1/track-record":{"get":{"tags":["track-record"],"summary":"Track Record","operationId":"track_record_v1_track_record_get","parameters":[{"name":"asset","in":"query","required":false,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/v1/route":{"get":{"tags":["router"],"summary":"Route Task","description":"Half-cent task router: free-text task in → the right endpoint, exact\nparams and price out. Local matching only — NEVER fires an analyst\nquestion (cost rule) and adds no latency.","operationId":"route_task_v1_route_get","parameters":[{"name":"task","in":"query","required":true,"schema":{"type":"string","title":"Task"}},{"name":"asset","in":"query","required":false,"schema":{"type":"string","title":"Asset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required — machine-readable x402 offer (price, network, payTo) in the response body; settle in USDC on Base and retry the request."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"consensus","description":"Sentiment-vs-price divergence verdicts with confidence — contrarian market intelligence."},{"name":"analyst","description":"Live analyst desk reads: free-form questions answered in ~10-180s."},{"name":"probes","description":"Cheap single-topic live probes: pulse, house view, events, odds, social, narrative."},{"name":"snapshot","description":"Cached signals — the cheapest entry point, no freshness guarantee."},{"name":"track-record","description":"Verifiable logged signal and call stats for transparency."},{"name":"router","description":"Half-cent task router: free-text task in, the right endpoint + params + price out."}]}