{"openapi":"3.1.0","info":{"title":"Vedetta x402 Gateway","description":"Vedetta — pay-per-call market intelligence for AI agents, based on Korra (korra.finance). Start FREE with 4 zero-auth funnel endpoints (/v1/route, /v1/korra/calls|/news|/lean — mirrored on /sol/v1/*), then escalate to 16 x402-paid endpoints: cross-asset divergence screener ($0.03), signal history ($0.01), and 14 live analyst desk reads at $0.09 flat (consensus, ask, pulse, equity, macro, prediction, theme, trend, news-read, house-view, event, odds, social, narrative). Settled via x402 micropayments in USDC on Base (/v1/*) and Solana (/sol/v1/*, ExactSvm) — no API key, no subscription, payment settles only on 2xx delivery. Install: /install (Hermes Agent skill, Base MCP agent card, raw x402). On-chain identity: ERC-8004 agentId 60532 on Base + 1463 on Solana — agent card at /.well-known/agent-card.json. Also reachable as a free chat agent on Fetch.ai Agentverse / ASI:One (search \"Vedetta\"). Descriptive research, not financial advice.","contact":{"name":"Vedetta","url":"https://vedetta.dethboy.com/","email":"vedetta@dethboy.com"},"version":"2.14.1","x-guidance":"Vedetta sells pay-per-call crypto, US stock, and macro market intelligence over the x402 payment protocol — USDC on Base (/v1/*) and Solana (/sol/v1/*). No signup, no API key — payment is authentication. FREE CONVERSION FUNNEL (0 USD, IP rate-limited on both /v1/* and /sol/v1/*): (1) GET /v1/route?task=... (60/min/IP) picks the exact paid endpoint + params for any plain-English task; (2) GET /v1/track-record (20/min/IP) verifiable signal/call log; (3) GET /v1/korra/calls (60/min/IP) Korra open/resolved calls (redacted open_calls); (4) GET /v1/korra/news (30/min/IP) Korra scored news; (5) GET /v1/korra/lean (20/min/IP) Korra lean gauges (FEAR_GREED full). PAID x402 TIER (unthrottled, settles only on 2xx delivery): GET /v1/feed|/v1/snapshot ($0.01), FREE GET /v1/track-record, GET /v1/history ($0.01), GET /v1/screener ($0.03), and 14 live analyst desk endpoints at a flat $0.09 (consensus, ask, pulse, equity, macro, prediction, theme, trend, news-read, house-view, event, odds, social, narrative). Machine catalogs: /.well-known/x402.json (Base), /.well-known/x402-sol.json (Solana), /registry.json, /llms.txt. On-chain identity (ERC-8004): /.well-known/agent-card.json (agentId 60532 on Base, 1463 on Solana). Descriptive research, not financial advice.","x-agent-card":"https://vedetta.dethboy.com/.well-known/agent-card.json","x-erc8004":{"base":{"agentId":60532,"registry":"eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432"},"solana":{"agentId":1463,"registry":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:8oo4dC4JvBLwy5tGgiH3WwK4B9PWxL9Z4XjA2jzkQMbQ"}},"x-payment-rails":{"base":{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","prefix":"/v1","catalog":"https://vedetta.dethboy.com/.well-known/x402.json"},"solana":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","prefix":"/sol/v1","catalog":"https://vedetta.dethboy.com/.well-known/x402-sol.json","enabled":true}}},"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 ($0.09). 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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/ask) or Solana (/sol/v1/ask) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/ask"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/ask"}]}}},"/v1/consensus":{"get":{"tags":["consensus"],"summary":"Consensus Endpoint","description":"Divergence verdict ($0.09). 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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/consensus) or Solana (/sol/v1/consensus) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/consensus"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/consensus"}]}}},"/v1/equity":{"get":{"tags":["probes"],"summary":"Equity","description":"Live divergence read on a US stock ticker ($0.09) — 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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/equity) or Solana (/sol/v1/equity) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/equity"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/equity"}]}}},"/v1/macro":{"get":{"tags":["probes"],"summary":"Macro","description":"Live analyst read on a macro instrument ($0.09: 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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/macro) or Solana (/sol/v1/macro) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/macro"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/macro"}]}}},"/v1/prediction":{"get":{"tags":["probes"],"summary":"Prediction","description":"Falsifiable analyst prediction ($0.09): claim + confidence + falsifier.\nAudit resolution honesty via free /v1/track-record.","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/prediction) or Solana (/sol/v1/prediction) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/prediction"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/prediction"}]}}},"/v1/theme":{"get":{"tags":["probes"],"summary":"Theme Endpoint","description":"Deep-dive on a tracked market theme/narrative ($0.09).","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/theme) or Solana (/sol/v1/theme) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/theme"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/theme"}]}}},"/v1/trend":{"get":{"tags":["probes"],"summary":"Trend","description":"Price-vs-sentiment trajectory over a window ($0.09).","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/trend) or Solana (/sol/v1/trend) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/trend"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/trend"}]}}},"/v1/news-read":{"get":{"tags":["probes"],"summary":"News Read","description":"Most significant market-moving story on an asset + the sentiment read on it ($0.09).","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/news-read) or Solana (/sol/v1/news-read) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/news-read"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/news-read"}]}}},"/v1/pulse":{"get":{"tags":["probes"],"summary":"Pulse","description":"Market-wide regime read ($0.09) — 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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/pulse) or Solana (/sol/v1/pulse) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/pulse"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/pulse"}]}}},"/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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/house-view) or Solana (/sol/v1/house-view) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/house-view"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/house-view"}]}}},"/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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/event) or Solana (/sol/v1/event) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/event"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/event"}]}}},"/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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/odds) or Solana (/sol/v1/odds) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/odds"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/odds"}]}}},"/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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/social) or Solana (/sol/v1/social) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/social"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/social"}]}}},"/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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/narrative) or Solana (/sol/v1/narrative) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.090000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/narrative"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/narrative"}]}}},"/v1/screener":{"get":{"tags":["snapshot"],"summary":"Screener","description":"Cross-asset divergence screener ($0.03) from CACHED signals (cost rule:\nnever fires an analyst question).","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/screener) or Solana (/sol/v1/screener) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/screener"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/screener"}]}}},"/v1/history":{"get":{"tags":["snapshot"],"summary":"History Endpoint","description":"Cached signal history ($0.01) — 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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/history) or Solana (/sol/v1/history) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/history"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/history"}]}}},"/v1/snapshot":{"get":{"tags":["snapshot"],"summary":"Snapshot","description":"Paid $0.01 CACHED-ONLY snapshot: never fires an analyst question.\nInspect signal_age_minutes/stale and upgrade to /v1/consensus ($0.09)\nwhen stale=true or before executing a trade.","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/snapshot) or Solana (/sol/v1/snapshot) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/snapshot"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/snapshot"}]}}},"/v1/feed":{"get":{"tags":["snapshot"],"summary":"Feed Endpoint","description":"Paid $0.01 cached post stream — instant return, zero analyst cost.\nEscalate to a $0.09 live read when something moves.","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 and PAYMENT-REQUIRED header; settle in USDC on Base (/v1/feed) or Solana (/sol/v1/feed) and retry."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}],"networks":[{"network":"eip155:8453","payTo":"0x21E16F1bc3aA847236354C8193D0cB21cF412eFA","path":"/v1/feed"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","payTo":"4kEdSopjVayXZ8DpAe6G3fVEFYDj6cny6AjWEEWr3Hdq","path":"/sol/v1/feed"}]}}},"/v1/track-record":{"get":{"tags":["free-funnel","track-record"],"summary":"Track Record","description":"FREE verifiable call log and transparency stats (rate-limited).","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"}}}},"429":{"description":"Too Many Requests — exceeds 20 req/min/IP free tier limit. Includes Retry-After header; repeated 429 bursts trigger a 5-15 min soft-ban."}},"security":[],"x-rate-limit":{"limit_per_minute_per_ip":20,"window_seconds":60,"soft_ban_seconds":"300-900 on repeated 429 bursts","solana_mirror":"/sol/v1/track-record"}}},"/v1/route":{"get":{"tags":["free-funnel","router"],"summary":"Route Task","description":"FREE (60/min/IP) task router: free-text task in → the right endpoint,\nexact params and price out. Local matching only — NEVER fires an analyst\nquestion (cost rule) and adds no latency. Automatically returns /sol/v1/*\nURLs when called via /sol/v1/route.","operationId":"route_task_v1_route_get","parameters":[{"name":"task","in":"query","required":false,"schema":{"type":"string","default":"","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"}}}},"429":{"description":"Too Many Requests — exceeds 60 req/min/IP free tier limit. Includes Retry-After header; repeated 429 bursts trigger a 5-15 min soft-ban."}},"security":[],"x-rate-limit":{"limit_per_minute_per_ip":60,"window_seconds":60,"soft_ban_seconds":"300-900 on repeated 429 bursts","solana_mirror":"/sol/v1/route"}}},"/v1/korra/calls":{"get":{"tags":["free-funnel","korra"],"summary":"Korra Calls","description":"FREE Korra open/resolved calls proxy (?asset= optional); open_calls redacted.","operationId":"korra_calls_v1_korra_calls_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"}}}},"429":{"description":"Too Many Requests — exceeds 60 req/min/IP free tier limit. Includes Retry-After header; repeated 429 bursts trigger a 5-15 min soft-ban."}},"security":[],"x-rate-limit":{"limit_per_minute_per_ip":60,"window_seconds":60,"soft_ban_seconds":"300-900 on repeated 429 bursts","solana_mirror":"/sol/v1/korra/calls"}}},"/v1/korra/news":{"get":{"tags":["free-funnel","korra"],"summary":"Korra News","description":"FREE Korra scored news proxy (?asset= optional).","operationId":"korra_news_v1_korra_news_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"}}}},"429":{"description":"Too Many Requests — exceeds 30 req/min/IP free tier limit. Includes Retry-After header; repeated 429 bursts trigger a 5-15 min soft-ban."}},"security":[],"x-rate-limit":{"limit_per_minute_per_ip":30,"window_seconds":60,"soft_ban_seconds":"300-900 on repeated 429 bursts","solana_mirror":"/sol/v1/korra/news"}}},"/v1/korra/lean":{"get":{"tags":["free-funnel","korra"],"summary":"Korra Lean","description":"FREE Korra lean gauge proxy (?asset= optional); FEAR_GREED full, others teaser.","operationId":"korra_lean_v1_korra_lean_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"}}}},"429":{"description":"Too Many Requests — exceeds 20 req/min/IP free tier limit. Includes Retry-After header; repeated 429 bursts trigger a 5-15 min soft-ban."}},"security":[],"x-rate-limit":{"limit_per_minute_per_ip":20,"window_seconds":60,"soft_ban_seconds":"300-900 on repeated 429 bursts","solana_mirror":"/sol/v1/korra/lean"}}},"/v1/organic-traffic":{"get":{"tags":["free-funnel","traffic"],"summary":"Organic Traffic Endpoint","description":"FREE (30/min/IP) — organic inbound + settlement-only paid totals.\nPaid = on-chain USDC to payTos only (HTTP 200 ≠ paid). Platform tags best-effort.\nDescriptive ops view only — not financial advice. No secrets / no raw IPs.","operationId":"organic_traffic_endpoint_v1_organic_traffic_get","parameters":[{"name":"window","in":"query","required":false,"schema":{"type":"string","default":"24h","title":"Window"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":80,"title":"Limit"}},{"name":"rail","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Rail"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Kind"}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Platform"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"newest","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"description":"Too Many Requests — exceeds 30 req/min/IP free tier limit. Includes Retry-After header; repeated 429 bursts trigger a 5-15 min soft-ban."}},"security":[],"x-rate-limit":{"limit_per_minute_per_ip":30,"window_seconds":60,"soft_ban_seconds":"300-900 on repeated 429 bursts","solana_mirror":"/sol/v1/organic-traffic"}}}},"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":"free-funnel","description":"Free, zero-auth entry & discovery endpoints (IP rate-limited, mirrored on /sol/v1/*): /v1/route plus /v1/korra/calls|/news|/lean partner proxies."},{"name":"consensus","description":"Sentiment-vs-price divergence verdicts with confidence ($0.09) — contrarian market intelligence."},{"name":"analyst","description":"Live analyst desk reads ($0.09): free-form questions answered fresh in ~10-180s."},{"name":"probes","description":"Focused live analyst probes ($0.09 flat): market-wide pulse, US equities, macro, predictions, themes, trends, news, house view, event triggers, Polymarket/Kalshi odds, social sentiment, and narrative rotation."},{"name":"snapshot","description":"Cached signals: paid /v1/snapshot ($0.01), cross-asset /v1/screener ($0.03) and backtest /v1/history ($0.01). Free: /v1/track-record + /v1/korra/*."},{"name":"track-record","description":"Free verifiable logged signal and call stats for transparency."},{"name":"router","description":"Free task router: plain-English task in, the exact paid endpoint + params + price out."}]}