{"openapi":"3.1.0","info":{"title":"Dynamic Feed — Live Data for AI","description":"Fresh, current data that AI models lack — 18 live verticals, 50 commercially-clean tools, over one REST APIor a keyless MCP endpoint. Sourced ONLY from feeds verified for commercial redistribution — the world's authoritative public instruments (NASA, NOAA, USGS, CISA, FAA, US Treasury/OFAC, FDA, the World Bank, CelesTrak) plus measurements we make ourselves: multi-model weather + air quality, space weather & live satellite positioning, natural hazards (quakes, wildfires, drought, global disasters), security advisories + actively-exploited CVEs, software versions & EOL, sanctions & regulatory filings, shipping & maritime chokepoints, China markets & macro, measured AI-provider latency, the open-model ecosystem, and a ground-truth layer (reality_check, detect_drift, whats_changed_since_your_training, current_time). PLUS a robot/agent situational-awareness API (POST /v1/awareness) returning Ed25519-signed, Bitcoin-anchored go/caution/no-go verdicts. The power is cross-domain: ask what no single source can answer. Every datapoint carries a provenance + freshness envelope so it's citeable. Free API key at POST /signup; MCP is keyless.","contact":{"name":"Dynamic Feed","url":"https://dynamicfeed.ai/"},"version":"1.0.0"},"servers":[{"url":"https://dynamicfeed.ai"}],"paths":{"/":{"get":{"summary":"Home","description":"Serve the marketing landing page (with live demo widget).","operationId":"home__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/info":{"get":{"summary":"Info","operationId":"info_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/worldcup":{"get":{"tags":["sports"],"summary":"Worldcup Route","description":"2026 FIFA World Cup fixtures + final results (openfootball, public domain). Keyless — powers the\nhomepage World Cup section and any agent. See also the keyless `world_cup` MCP tool.","operationId":"worldcup_route_worldcup_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/batch":{"post":{"tags":["agent"],"summary":"V1 Batch","description":"Run up to 20 read-only data-tool calls in ONE request — cuts agent round-trips. Keyless.\nBody: {\"calls\":[{\"tool\":\"current_weather\",\"args\":{\"city\":\"London\"}}, {\"tool\":\"earthquakes\",\"args\":{}}]}.\nReturns {\"results\":[{\"tool\",\"ok\",\"data\"|\"error\"}, ...]} in the same order. Tool names are the keyless\nMCP tools; POST with no `calls` returns the available list. Each call has its own 20s deadline, so a\nslow upstream degrades that one item rather than blocking the batch.","operationId":"v1_batch_v1_batch_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/drift":{"post":{"tags":["agent"],"summary":"V1 Drift","description":"Drift detection — audit an AI's stated facts against live ground-truth, graded by severity. Keyless.\nBody: {\"claims\":[\"The latest Python is 3.11\",\"Node.js is on 18\"]} or {\"text\":\"<an LLM answer>\"}.\nReturns {checked, drifted_count, overall, results:[{claim, status, drifted, severity, correction, source}]}.","operationId":"v1_drift_v1_drift_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/guard":{"post":{"tags":["agent"],"summary":"V1 Guard","description":"Pre-answer guard — the anti-hallucination middleware. POST the draft answer your AI is about to\nsend; get back a verdict of \"pass\" or \"revise\" plus the exact corrections, so you can fix it BEFORE\nthe user sees it. Keyless. Wrap it around any LLM response pipeline.\nBody: {\"answer\":\"<the draft answer text>\"} or {\"claims\":[\"...\",\"...\"]}.\nReturns {verdict:\"pass\"|\"revise\", checked, issues:[{claim, subject, severity, correction, source}],\nconfirmed, unverifiable, guidance}. Only claims that CONTRADICT live data trigger \"revise\"; opinions\nand facts no live feed can cover pass through untouched. Verifies prices, software versions, market\nopen/closed and service up/down against Dynamic Feed's live ground-truth.","operationId":"v1_guard_v1_guard_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/sources":{"get":{"tags":["agent"],"summary":"V1 Sources","description":"The authoritative source catalog — every upstream feed Dynamic Feed serves, with its publisher,\nofficial URL, licence, whether commercial use + redistribution is permitted, update cadence, and the\ntools it backs. Keyless. Proof that every datapoint is commercially clean and citeable.","operationId":"v1_sources_v1_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/explain":{"post":{"tags":["agent"],"summary":"V1 Explain","description":"Explain the source / chain of custody for one subject. Pass ?subject= (GET) or {\"subject\":\"...\"}\n(POST) — a tool name (earthquakes), a source (USGS), or a topic. Returns the upstream source(s),\nlicence, official URL, update cadence and the full custody trail (origin -> ingest -> normalize ->\nserve, plus sign/anchor for awareness), so you can trace and verify where a number came from. Keyless.","operationId":"v1_explain_v1_explain_post","parameters":[{"name":"subject","in":"query","required":false,"schema":{"type":"string","default":"","title":"Subject"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agent"],"summary":"V1 Explain","description":"Explain the source / chain of custody for one subject. Pass ?subject= (GET) or {\"subject\":\"...\"}\n(POST) — a tool name (earthquakes), a source (USGS), or a topic. Returns the upstream source(s),\nlicence, official URL, update cadence and the full custody trail (origin -> ingest -> normalize ->\nserve, plus sign/anchor for awareness), so you can trace and verify where a number came from. Keyless.","operationId":"v1_explain_v1_explain_post","parameters":[{"name":"subject","in":"query","required":false,"schema":{"type":"string","default":"","title":"Subject"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/snapshot":{"get":{"tags":["agent"],"summary":"V1 Snapshot","description":"Historical world-state — what Dynamic Feed reported on a given day. ?date=YYYY-MM-DD returns that\nday's stored snapshot (the cross-domain world_pulse digest); no date returns today's, captured on\nread. Honest about coverage: a date before the earliest snapshot returns the available range, never\na fabricated past. Keyless. The auditable companion to the signed/Bitcoin-anchored awareness layer.","operationId":"v1_snapshot_v1_snapshot_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/anchor/daily":{"get":{"tags":["robot"],"summary":"V1 Anchor Daily","description":"L2 — the day's world-state snapshot anchored to the Bitcoin blockchain (one hash per day, free &\nbatched via OpenTimestamps): an immortal, tamper-proof record of what Dynamic Feed reported. Anchors\non first call (idempotent), then returns the proof. ?date=YYYY-MM-DD; keyless.","operationId":"v1_anchor_daily_v1_anchor_daily_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/watchlist":{"get":{"tags":["agent"],"summary":"V1 Watchlist Get","description":"Your saved watchlist — the subjects/tools you monitor. ?pull=true runs every watched tool and\nreturns each one's CURRENT value in a single call (your whole dashboard at once). Per-user, keyed by\nyour API key (X-API-Key).","operationId":"v1_watchlist_get_v1_watchlist_get","parameters":[{"name":"pull","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Pull"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["agent"],"summary":"V1 Watchlist Post","description":"Add to or replace your watchlist. Body {\"label\":\"BTC\",\"tool\":\"cite\",\"args\":{\"subject\":\"BTC\"}} adds\none item; body {\"items\":[...]} replaces the whole list (max 25). Each item's `tool` must be a real\nDynamic Feed tool. Per-user, keyed by your API key.","operationId":"v1_watchlist_post_v1_watchlist_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["agent"],"summary":"V1 Watchlist Delete","description":"Remove one item from your watchlist (?label=BTC) or clear it entirely (no label). Per-user.","operationId":"v1_watchlist_delete_v1_watchlist_delete","parameters":[{"name":"label","in":"query","required":false,"schema":{"type":"string","default":"","title":"Label"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stream":{"get":{"tags":["agent"],"summary":"V1 Stream","description":"Server-Sent Events stream of a LIVE value. Point an EventSource at\n/v1/stream?tool=<tool>&args=<json>&interval=<sec>&count=<n> and receive the tool's current value every\n`interval` seconds as a `value` event, until `count` updates or you disconnect. Keyless. Bounded for\nfair use: interval 5-300s, count 1-60. Example: /v1/stream?tool=cite&args={\"subject\":\"BTC\"}&interval=10","operationId":"v1_stream_v1_stream_get","parameters":[{"name":"tool","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tool"}},{"name":"args","in":"query","required":false,"schema":{"type":"string","default":"","title":"Args"}},{"name":"interval","in":"query","required":false,"schema":{"type":"number","default":15,"title":"Interval"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"post":{"tags":["agent"],"summary":"V1 Webhooks Create","description":"Register a webhook that fires when a tool's value CHANGES. Body:\n{\"url\":\"https://you.example/hook\",\"tool\":\"exploited_vulnerabilities\",\"args\":{}}. The URL is validated\nSSRF-safe (public http/https only). Returns a one-time `secret` — every delivery is HMAC-SHA256 signed\nwith it (header X-DynamicFeed-Signature: sha256=…), so you can verify it came from us. Per-user (X-API-Key).","operationId":"v1_webhooks_create_v1_webhooks_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agent"],"summary":"V1 Webhooks List","description":"List your webhook subscriptions (secrets are never returned). Per-user.","operationId":"v1_webhooks_list_v1_webhooks_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["agent"],"summary":"V1 Webhooks Delete","description":"Delete one of your webhook subscriptions by ?id=. Per-user.","operationId":"v1_webhooks_delete_v1_webhooks_delete","parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Id"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/test":{"post":{"tags":["agent"],"summary":"V1 Webhooks Test","description":"Send a signed TEST delivery to one of your subscriptions now — confirm your endpoint receives it and\nthe HMAC validates. Body: {\"id\": <subscription id>}. Per-user.","operationId":"v1_webhooks_test_v1_webhooks_test_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1":{"get":{"tags":["agent"],"summary":"V1 Index","description":"The Dynamic Feed agent & robot API at a glance — every /v1 capability, what it does, and a\ncopy-paste example. The fastest way for a developer (or an agent) to discover the whole surface.\nKeyless unless noted.","operationId":"v1_index_v1_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/awareness":{"post":{"tags":["robot"],"summary":"V1 Awareness","description":"Robot situational-awareness v1 — ONE call returns a go / caution / no-go verdict plus the grounded\nfacts behind it, for a robot (ground|humanoid|aerial|marine|orbital) at a location. NEVER blocks: the\nfeeds fan out under a hard deadline and any laggard is dropped with the snapshot flagged `degraded`\n(fail-safe → the verdict can never be `go` when degraded, it floors to `caution`). Keyless in v1.\n\nBody: {\"robot\":{\"id\",\"class\"},\"location\":{\"lat\",\"lon\",\"alt_m\"},\"radius_km\"?,\"domains\"?,\n\"max_staleness_s\"?,\"limits\"?,\"deadline_ms\"?,\"require_signed\"?}. Every response is signed with Ed25519\n(Rung B) — verify against GET /.well-known/keys. Anchor a snapshot's hash to Bitcoin via POST /v1/anchor (Rung C).","operationId":"v1_awareness_v1_awareness_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/preflight":{"post":{"tags":["robot"],"summary":"V1 Preflight","description":"Drone PRE-FLIGHT safety check — a preset over /v1/awareness for class=aerial. POST\n{\"location\":{\"lat\",\"lon\",\"alt_m\"?},\"radius_km\"?}. Returns a go / caution / no-go take-off verdict\nfused from wind & weather, air quality, space weather (GPS/comms integrity) and nearby hazards —\nEd25519-signed, hard-deadline (never hangs; degraded floors to caution). Keyless.","operationId":"v1_preflight_v1_preflight_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/road":{"post":{"tags":["robot"],"summary":"V1 Road","description":"Ground / autonomous-vehicle OVER-THE-HORIZON hazard check — a preset over /v1/awareness for\nclass=ground. POST {\"location\":{\"lat\",\"lon\"},\"radius_km\"?}. Returns a go / caution / no-go verdict\nfused from weather, air quality and nearby earthquakes/hazards along the route — signed, never hangs.\nKeyless.","operationId":"v1_road_v1_road_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/receipt":{"post":{"tags":["agent"],"summary":"V1 Receipt","description":"Compliance receipt — wrap any fact/claim/data in a timestamped, Ed25519-SIGNED record: provable\nevidence of what an AI was told (or asserted), and when. Body: {\"data\": <any JSON>} or {\"claim\":\"...\"}.\nReturns the receipt + a detached signature (verify against GET /.well-known/keys); anchor its hash to\nBitcoin via POST /v1/anchor. Keyless. The audit trail for regulated AI (fintech / legal / medical).","operationId":"v1_receipt_v1_receipt_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/anchor":{"post":{"tags":["robot"],"summary":"V1 Anchor","description":"Anchor a snapshot's hash to a public chain (Bitcoin, via OpenTimestamps) — returns a timestamp\nproof that the record existed at time T, independently verifiable, even against us. Body:\n{\"snapshot\": {...}} (its canonical SHA-256 is anchored) or {\"digest_hex\": \"<64-hex sha256>\"}.\nHashes ONLY, never data. Off the verdict hot path (Rung C).","operationId":"v1_anchor_v1_anchor_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/anchor/upgrade":{"post":{"tags":["robot"],"summary":"V1 Anchor Upgrade","description":"Upgrade a pending .ots proof to its Bitcoin block attestation (~1 block after anchoring).\nBody: {\"proof_ots_b64\": \"...\"}.","operationId":"v1_anchor_upgrade_v1_anchor_upgrade_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/signup":{"post":{"summary":"Signup","description":"Get a free API key instantly.","operationId":"signup_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_signup_signup_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/models":{"get":{"summary":"Models","description":"Search current AI models by price, context, capability. Cheapest first. (Requires API key.)","operationId":"models_models_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match model name/id","title":"Q"},"description":"match model name/id"},{"name":"provider","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"openai, anthropic, google, ...","title":"Provider"},"description":"openai, anthropic, google, ..."},{"name":"max_input_price","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"max USD per 1M input tokens","title":"Max Input Price"},"description":"max USD per 1M input tokens"},{"name":"min_context","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"min context window in tokens","title":"Min Context"},"description":"min context window in tokens"},{"name":"needs_vision","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"only models that accept images","title":"Needs Vision"},"description":"only models that accept images"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dataset":{"get":{"summary":"Dataset Index","description":"Open, free, crawlable snapshots of every feed (for AI training & research).\n\nThe real-time, filterable API + MCP endpoint remain the product; this is a\npublic snapshot so the data spreads into the corpus AIs learn from.","operationId":"dataset_index_dataset_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/models.json":{"get":{"summary":"Dataset Models","operationId":"dataset_models_dataset_models_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/servers.json":{"get":{"summary":"Dataset Servers","operationId":"dataset_servers_dataset_servers_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/status.json":{"get":{"summary":"Dataset Status","operationId":"dataset_status_dataset_status_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/news.json":{"get":{"summary":"Dataset News","operationId":"dataset_news_dataset_news_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/prices.json":{"get":{"summary":"Dataset Prices","operationId":"dataset_prices_dataset_prices_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/consensus.json":{"get":{"summary":"Dataset Consensus","operationId":"dataset_consensus_dataset_consensus_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/versions.json":{"get":{"summary":"Dataset Versions","operationId":"dataset_versions_dataset_versions_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dataset/advisories.json":{"get":{"summary":"Dataset Advisories","operationId":"dataset_advisories_dataset_advisories_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/servers":{"get":{"summary":"Servers","description":"Search the MCP server registry — find AI agent tools. Most-starred first. (Requires API key.)","operationId":"servers_servers_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match server name/description","title":"Q"},"description":"match server name/description"},{"name":"has_remote","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"only servers with a hosted/remote endpoint","title":"Has Remote"},"description":"only servers with a hosted/remote endpoint"},{"name":"min_stars","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"minimum GitHub stars","title":"Min Stars"},"description":"minimum GitHub stars"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/status":{"get":{"summary":"Status","description":"Live up/down/degraded status for major AI & dev services. Issues first. (Requires API key.)","operationId":"status_status_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ai | dev | infra | platform","title":"Category"},"description":"ai | dev | infra | platform"},{"name":"only_issues","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"only services currently degraded/down","title":"Only Issues"},"description":"only services currently degraded/down"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":100,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news":{"get":{"summary":"News","description":"Latest AI news & releases across providers. Newest first. (Requires API key.)","operationId":"news_news_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match title/summary","title":"Q"},"description":"match title/summary"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"OpenAI, Google AI, Hugging Face, ...","title":"Source"},"description":"OpenAI, Google AI, Hugging Face, ..."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":30,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/transit":{"get":{"summary":"Transit","description":"Live transit line status — 'is my line delayed right now?'. Issues first. (Requires API key.)","operationId":"transit_transit_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match line/system/description","title":"Q"},"description":"match line/system/description"},{"name":"system","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"e.g. 'Transport for London', 'BART'","title":"System"},"description":"e.g. 'Transport for London', 'BART'"},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"e.g. 'London'","title":"City"},"description":"e.g. 'London'"},{"name":"only_issues","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"only lines currently delayed/disrupted","title":"Only Issues"},"description":"only lines currently delayed/disrupted"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":300,"default":100,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/benchmarks":{"get":{"summary":"Benchmarks","description":"Measured latency & uptime per AI provider — our own data, fastest first. (Requires API key.)","operationId":"benchmarks_benchmarks_get","parameters":[{"name":"window_hours","in":"query","required":false,"schema":{"type":"integer","maximum":720,"minimum":1,"description":"rolling window in hours","default":24,"title":"Window Hours"},"description":"rolling window in hours"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/benchmarks/history":{"get":{"summary":"Benchmarks History","description":"The PERMANENT daily provider-latency & uptime archive — data Dynamic Feed measures itself and\nnever prunes, so it cannot be backfilled by anyone. Built for quant / eval / research use. Free keys\nget a 7-day sample; paid plans get the full history. (Requires API key.)","operationId":"benchmarks_history_benchmarks_history_get","parameters":[{"name":"provider","in":"query","required":false,"schema":{"type":"string","description":"filter to one provider, e.g. openai (optional)","default":"","title":"Provider"},"description":"filter to one provider, e.g. openai (optional)"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":1825,"minimum":1,"description":"lookback in days","default":90,"title":"Days"},"description":"lookback in days"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/prices":{"get":{"summary":"Prices","description":"Live market prices across crypto, stocks, indices, forex, commodities, metals\n& bonds — the current numbers AI models get wrong. Each row has its own `currency`\n(USD / points / quote ccy) and a 24h % change. Refreshed every few minutes. (Requires API key.)","operationId":"prices_prices_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match symbol or name, e.g. 'btc', 'nasdaq', 'eurusd'","title":"Q"},"description":"match symbol or name, e.g. 'btc', 'nasdaq', 'eurusd'"},{"name":"asset_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"crypto | metal | index | forex | commodity | stock | bond","title":"Asset Class"},"description":"crypto | metal | index | forex | commodity | stock | bond"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"exact symbol, e.g. BTC, SPX, NDX, EURUSD, WTI, AAPL, XAU","title":"Symbol"},"description":"exact symbol, e.g. BTC, SPX, NDX, EURUSD, WTI, AAPL, XAU"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":300,"default":100,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/prices/history":{"get":{"summary":"Prices History","description":"Proprietary price time-series for one instrument — recorded by Dynamic Feed,\navailable nowhere else. For charts & trend analysis. Oldest→newest. (Requires API key.)","operationId":"prices_history_prices_history_get","parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"instrument symbol, e.g. BTC, NDX, EURUSD, WTI, XAU","title":"Symbol"},"description":"instrument symbol, e.g. BTC, NDX, EURUSD, WTI, XAU"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":720,"minimum":1,"description":"how far back to return","default":24,"title":"Hours"},"description":"how far back to return"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"default":500,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/movers":{"get":{"summary":"Movers","description":"DERIVED signal — biggest 24h gainers or losers across the markets we track. Computed from\nDynamic Feed's own data & recorded history (not a raw source you can scrape). (Requires API key.)","operationId":"movers_movers_get","parameters":[{"name":"direction","in":"query","required":false,"schema":{"type":"string","description":"gainers | losers","default":"gainers","title":"Direction"},"description":"gainers | losers"},{"name":"asset_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"crypto | stock | index | forex | commodity | metal","title":"Asset Class"},"description":"crypto | stock | index | forex | commodity | metal"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":15,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/consensus":{"get":{"summary":"Consensus","description":"PROPRIETARY: real-time cross-exchange price consensus — the median price across\nseveral independent venues plus how tightly they agree (spread in basis points), the\nmin/max, and the per-venue breakdown. Tells an AI tool the real price AND whether to\ntrust it. Measured by Dynamic Feed; available nowhere else. (Requires API key.)","operationId":"consensus_consensus_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"exact symbol, e.g. BTC, ETH, SOL","title":"Symbol"},"description":"exact symbol, e.g. BTC, ETH, SOL"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/versions":{"get":{"summary":"Versions","description":"Latest stable versions & end-of-life dates for languages, runtimes, frameworks,\ndatabases & OSes. Answers 'what's the latest X?' and 'is version Y still supported?'.\nEach row has a `status` (supported/nearing-eol/end-of-life) + provenance. (Requires API key.)","operationId":"versions_versions_get","parameters":[{"name":"product","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"exact product, e.g. python, nodejs, postgresql","title":"Product"},"description":"exact product, e.g. python, nodejs, postgresql"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match a product name","title":"Q"},"description":"match a product name"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"language | runtime | framework | database | os | tool","title":"Category"},"description":"language | runtime | framework | database | os | tool"},{"name":"only_supported","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"exclude end-of-life release lines","title":"Only Supported"},"description":"exclude end-of-life release lines"},{"name":"only_lts","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"only long-term-support lines","title":"Only Lts"},"description":"only long-term-support lines"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":300,"default":100,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/advisories":{"get":{"summary":"Advisories","description":"Recent security advisories / CVEs — affected package, vulnerable version range, patched\nversion, severity & CVSS. Filter by package/ecosystem/severity. Newest first. Pairs with\n/versions: is my stack current AND safe? (Requires API key.)","operationId":"advisories_advisories_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match summary / package / CVE / GHSA id","title":"Q"},"description":"match summary / package / CVE / GHSA id"},{"name":"package","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"affected package name, e.g. lodash, requests","title":"Package"},"description":"affected package name, e.g. lodash, requests"},{"name":"ecosystem","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"npm | pip | maven | go | rubygems | nuget | composer | ...","title":"Ecosystem"},"description":"npm | pip | maven | go | rubygems | nuget | composer | ..."},{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"low | moderate | high | critical","title":"Severity"},"description":"low | moderate | high | critical"},{"name":"min_cvss","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"minimum CVSS score (0-10)","title":"Min Cvss"},"description":"minimum CVSS score (0-10)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/signals":{"get":{"summary":"Signals","description":"DERIVED proprietary signals computed from Dynamic Feed's recorded history — realized\nvolatility, price range, and how the cross-exchange spread is trending (widening/narrowing).\nBranded numbers only we have; richer as history accumulates. (Requires API key.)","operationId":"signals_signals_get","parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"instrument symbol, e.g. BTC, ETH, XAU, EURUSD","title":"Symbol"},"description":"instrument symbol, e.g. BTC, ETH, XAU, EURUSD"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":720,"minimum":1,"description":"window","default":24,"title":"Hours"},"description":"window"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market-hours":{"get":{"summary":"Market Hours","description":"Is the market open right now? Live open/closed + next open/close for major exchanges\n(plus crypto 24/7 and forex 24/5). Tells an AI whether a price is live or a closed-market\nlast-print. (Requires API key.)","operationId":"market_hours_market_hours_get","parameters":[{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"NYSE, NASDAQ, LSE, XETRA, TSE, HKEX, ASX, Crypto, Forex","title":"Market"},"description":"NYSE, NASDAQ, LSE, XETRA, TSE, HKEX, ASX, Crypto, Forex"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/rates":{"get":{"summary":"Rates","description":"Live US benchmark interest rates (Fed funds / SOFR / OBFR…) from the New York Fed — the\nrates models perpetually quote stale. (Requires API key.)","operationId":"rates_rates_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/iss":{"get":{"summary":"Iss","description":"Where the International Space Station is right now + who's aboard + orbital-latency floor.\n(Requires API key.)","operationId":"iss_iss_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/satellites":{"get":{"summary":"Satellites","description":"Satellite/constellation catalog (Starlink, GPS, stations…) with altitude, orbital period, and\na derived light-speed round-trip latency to ground — the physics floor for orbital networks. (Requires API key.)","operationId":"satellites_satellites_get","parameters":[{"name":"group","in":"query","required":false,"schema":{"type":"string","description":"starlink, stations, gps-ops, oneweb, galileo, weather, active, geo","default":"starlink","title":"Group"},"description":"starlink, stations, gps-ops, oneweb, galileo, weather, active, geo"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/satellite":{"get":{"summary":"Satellite","description":"Real-time position of ANY satellite by NORAD id — true SGP4 propagation of the latest live\nCelesTrak TLE to the current instant: exact lat/lon, altitude, velocity, ground-footprint radius,\nthe speed-of-light latency floor, and the TLE's age. Optionally a forward ground-track. (Requires API key.)","operationId":"satellite_satellite_get","parameters":[{"name":"norad_id","in":"query","required":true,"schema":{"type":"integer","description":"NORAD catalog number, e.g. 25544 (ISS), 20580 (Hubble), 44714 (a Starlink)","title":"Norad Id"},"description":"NORAD catalog number, e.g. 25544 (ISS), 20580 (Hubble), 44714 (a Starlink)"},{"name":"track_minutes","in":"query","required":false,"schema":{"type":"integer","maximum":360,"minimum":0,"description":"also return a predicted ground-track this many minutes ahead (0 = none)","default":0,"title":"Track Minutes"},"description":"also return a predicted ground-track this many minutes ahead (0 = none)"},{"name":"step_seconds","in":"query","required":false,"schema":{"type":"integer","maximum":600,"minimum":10,"description":"ground-track sampling step in seconds","default":60,"title":"Step Seconds"},"description":"ground-track sampling step in seconds"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/launches":{"get":{"summary":"Launches","description":"Upcoming rocket launches worldwide — name, provider, rocket, time, site. (Requires API key.)","operationId":"launches_launches_get","parameters":[{"name":"provider","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by provider, e.g. SpaceX","title":"Provider"},"description":"filter by provider, e.g. SpaceX"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"default":8,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/orbital-datacenters":{"get":{"summary":"Orbital Datacenters","description":"DATA CENTERS IN SPACE — a curated registry of compute/AI spacecraft in orbit (Starcloud's\nNVIDIA H100, ESA Φsat-2 AI edge, D-Orbit in-orbit cloud), each enriched with live orbital data\nand the speed-of-light latency floor for ground links. Data nowhere else. (Requires API key.)","operationId":"orbital_datacenters_orbital_datacenters_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/space-weather":{"get":{"summary":"Space Weather","description":"Full space-weather now-cast — NOAA R/S/G storm scales, geomagnetic Kp, solar wind (speed/\ndensity/Bz, the storm driver) and the latest solar X-ray flux/flare. Affects satellite comms &\ndrag, GPS, HF radio, power grids and orbital-compute radiation/power. (Requires API key.)","operationId":"space_weather_space_weather_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internet-outages":{"get":{"summary":"Internet Outages","description":"Live internet outages/degradations worldwide — where connectivity is disrupted right now and via\nwhich independent signal (BGP routing / active probing / network telescope). Real-time detection from\nCAIDA IODA. Answers \"is the internet down in country/network X right now?\". (Requires API key.)","operationId":"internet_outages_internet_outages_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","description":"country | region | asn","default":"country","title":"Scope"},"description":"country | region | asn"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"look-back window in hours","default":24,"title":"Hours"},"description":"look-back window in hours"},{"name":"only_outages","in":"query","required":false,"schema":{"type":"boolean","description":"only critical/warning vs all alert levels","default":true,"title":"Only Outages"},"description":"only critical/warning vs all alert levels"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter to one entity code (e.g. a country code)","title":"Entity"},"description":"filter to one entity code (e.g. a country code)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":30,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/earthquakes":{"get":{"summary":"Earthquakes","description":"Recent earthquakes worldwide (USGS) — magnitude, depth, location, PAGER impact alert, tsunami\nflag, felt reports and significance. Sorted by impact then magnitude. (Requires API key.)","operationId":"earthquakes_earthquakes_get","parameters":[{"name":"min_magnitude","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"minimum magnitude","default":2.5,"title":"Min Magnitude"},"description":"minimum magnitude"},{"name":"period","in":"query","required":false,"schema":{"type":"string","description":"hour | day | week | month","default":"day","title":"Period"},"description":"hour | day | week | month"},{"name":"tsunami_only","in":"query","required":false,"schema":{"type":"boolean","description":"only quakes flagged with tsunami potential","default":false,"title":"Tsunami Only"},"description":"only quakes flagged with tsunami potential"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":30,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/natural-events":{"get":{"summary":"Natural Events","description":"Active natural events worldwide (NASA EONET) — wildfires, severe storms, volcanoes, floods,\nsea/lake ice. \"What natural events are happening on Earth right now?\". (Requires API key.)","operationId":"natural_events_natural_events_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"wildfires | severeStorms | volcanoes | floods | seaLakeIce","title":"Category"},"description":"wildfires | severeStorms | volcanoes | floods | seaLakeIce"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"look-back window in days","default":30,"title":"Days"},"description":"look-back window in days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":30,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/wildfires":{"get":{"summary":"Wildfires","description":"Active US wildfires (NIFC WFIGS) — incident name, size in acres, % contained, cause, state and\nlocation. The 'how big / how contained' detail hotspot feeds can't give. Largest first. (Requires API key.)","operationId":"wildfires_wildfires_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter to a US state, e.g. CA, TX (2-letter)","title":"State"},"description":"filter to a US state, e.g. CA, TX (2-letter)"},{"name":"only_uncontained","in":"query","required":false,"schema":{"type":"boolean","description":"only fires below 100% containment","default":false,"title":"Only Uncontained"},"description":"only fires below 100% containment"},{"name":"min_acres","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"minimum incident size in acres","default":0,"title":"Min Acres"},"description":"minimum incident size in acres"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/global-disasters":{"get":{"summary":"Global Disasters Ep","description":"Worldwide multi-hazard disaster alerts (GDACS) — earthquakes, tropical cyclones, floods,\ndroughts, volcanoes — with a Green/Orange/Red humanitarian-impact level + affected countries.\nThe 'how bad, where, who's affected' severity layer. (Requires API key.)","operationId":"global_disasters_ep_global_disasters_get","parameters":[{"name":"alert_level","in":"query","required":false,"schema":{"type":"string","description":"Green;Orange;Red (semicolon-separated)","default":"Orange;Red","title":"Alert Level"},"description":"Green;Orange;Red (semicolon-separated)"},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"EQ | TC | FL | DR | VO | WF","title":"Event Type"},"description":"EQ | TC | FL | DR | VO | WF"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"country name or ISO3 (e.g. PHL)","title":"Country"},"description":"country name or ISO3 (e.g. PHL)"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"description":"look-back window in days","default":7,"title":"Days"},"description":"look-back window in days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/world-news":{"get":{"summary":"World News","description":"Latest worldwide news via Google News — broad global source coverage, localizable by country\nand language, strictly current (past your training cutoff). \"What is the world reporting about X\nright now?\" Omit `query` for top world headlines. Each article carries its source + publish time.\n(Requires API key.)","operationId":"world_news_world_news_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"topic/keyword to search, e.g. 'earthquake', 'OpenAI', 'election'; omit for top world headlines","default":"top stories","title":"Query"},"description":"topic/keyword to search, e.g. 'earthquake', 'OpenAI', 'election'; omit for top world headlines"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by source country (FIPS/2-letter, e.g. US, FR)","title":"Country"},"description":"filter by source country (FIPS/2-letter, e.g. US, FR)"},{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by language, e.g. English, Spanish","title":"Language"},"description":"filter by language, e.g. English, Spanish"},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"look-back window in hours","default":24,"title":"Hours"},"description":"look-back window in hours"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"latest | relevant | oldest | tone_positive | tone_negative","default":"latest","title":"Sort"},"description":"latest | relevant | oldest | tone_positive | tone_negative"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":75,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/china":{"get":{"summary":"China Ep","description":"China markets & macro AIs lack: Shanghai Composite + Hang Seng, A-share/China ETF proxies\n(CSI 300, MSCI China, internet, tech, consumer...), CNY/HKD & cross FX, and 12 World Bank macro\nseries + a derived trade balance. `metric` narrows the slice. (Requires API key.)","operationId":"china_ep_china_get","parameters":[{"name":"metric","in":"query","required":false,"schema":{"type":"string","description":"all | indices | fx | etfs | macro","default":"all","title":"Metric"},"description":"all | indices | fx | etfs | macro"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/shipping":{"get":{"summary":"Shipping Ep","description":"Global shipping & maritime: daily ship transits through the world's 28 chokepoints (Suez, Panama,\nHormuz, Malacca, Taiwan...) via IMF PortWatch, the ~2,065-port global registry, and LIVE Baltic vessel\npositions (AIS, Digitraffic) enriched with ship name/type/destination. (Requires API key.)","operationId":"shipping_ep_shipping_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","description":"chokepoints | ports | vessels","default":"chokepoints","title":"Scope"},"description":"chokepoints | ports | vessels"},{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"filter by name/country (chokepoints, ports) or ship name/destination (vessels)","default":"","title":"Query"},"description":"filter by name/country (chokepoints, ports) or ship name/destination (vessels)"},{"name":"region","in":"query","required":false,"schema":{"type":"string","description":"Baltic preset for scope=vessels: baltic, helsinki, stockholm, kiel, gdansk, copenhagen, riga, gulf-of-finland","default":"baltic","title":"Region"},"description":"Baltic preset for scope=vessels: baltic, helsinki, stockholm, kiel, gdansk, copenhagen, riga, gulf-of-finland"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":30,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/whats-new":{"get":{"summary":"Whats New Ep","description":"What an AI has missed since its training cutoff — a LIVE snapshot of the current world\n(trending model, live prices, top exploited CVE, latest versions, a headline, fastest AI API)\nwith a plain-English summary. The 'pulse' every connecting model can read. (Requires API key on\nREST; the same tool is keyless over MCP.)","operationId":"whats_new_ep_whats_new_get","parameters":[{"name":"cutoff","in":"query","required":false,"schema":{"type":"string","description":"your knowledge cutoff if known, e.g. 2024-10 (optional)","default":"","title":"Cutoff"},"description":"your knowledge cutoff if known, e.g. 2024-10 (optional)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/reality-check":{"get":{"summary":"Reality Check Ep","description":"Fact-check a statement against LIVE data — verdict (accurate / stale_or_wrong / current_value /\noutside_coverage) + the live value + source. The anti-hallucination check; covers prices, market hours,\nsoftware versions, service status. (Key on REST; same tool keyless over MCP.)","operationId":"reality_check_ep_reality_check_get","parameters":[{"name":"claim","in":"query","required":false,"schema":{"type":"string","description":"a statement to verify, e.g. \"BTC is $90,000\" or \"the market is open\"","default":"","title":"Claim"},"description":"a statement to verify, e.g. \"BTC is $90,000\" or \"the market is open\""},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/time":{"get":{"summary":"Time Ep","description":"Current date/time anywhere — an LLM has no clock. (Requires API key; keyless over MCP.)","operationId":"time_ep_time_get","parameters":[{"name":"tz","in":"query","required":false,"schema":{"type":"string","description":"IANA timezone, e.g. America/New_York (default UTC)","default":"UTC","title":"Tz"},"description":"IANA timezone, e.g. America/New_York (default UTC)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/convert":{"get":{"summary":"Convert Ep","description":"Convert money/crypto/metals at the LIVE rate. (Requires API key; keyless over MCP.)","operationId":"convert_ep_convert_get","parameters":[{"name":"amount","in":"query","required":false,"schema":{"type":"number","description":"amount to convert","default":1,"title":"Amount"},"description":"amount to convert"},{"name":"from_currency","in":"query","required":false,"schema":{"type":"string","description":"e.g. EUR, BTC, XAU","default":"USD","title":"From Currency"},"description":"e.g. EUR, BTC, XAU"},{"name":"to_currency","in":"query","required":false,"schema":{"type":"string","description":"e.g. USD, JPY, ETH","default":"USD","title":"To Currency"},"description":"e.g. USD, JPY, ETH"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/countdown":{"get":{"summary":"Countdown Ep","description":"Time until a live event (market open/close or next rocket launch). (Key on REST; keyless on MCP.)","operationId":"countdown_ep_countdown_get","parameters":[{"name":"event","in":"query","required":false,"schema":{"type":"string","description":"e.g. 'NYSE open' or 'next SpaceX launch'","default":"","title":"Event"},"description":"e.g. 'NYSE open' or 'next SpaceX launch'"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/world-pulse":{"get":{"summary":"World Pulse Ep","description":"What's happening on Earth right now — one cross-domain live digest. (Key on REST; keyless on MCP.)","operationId":"world_pulse_ep_world_pulse_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cite":{"get":{"summary":"Cite Ep","description":"A fresh, citeable source + timestamp for a current datapoint. (Key on REST; keyless on MCP.)","operationId":"cite_ep_cite_get","parameters":[{"name":"subject","in":"query","required":false,"schema":{"type":"string","description":"a software product (python, nodejs, kubernetes, ...) to cite its latest version","default":"","title":"Subject"},"description":"a software product (python, nodejs, kubernetes, ...) to cite its latest version"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ai-models":{"get":{"summary":"Ai Models Ep","description":"Current & trending AI models from the open-model ecosystem (Hugging Face) — name, org, task,\npopularity, release date. Complements /models (closed-flagship pricing & versions). (Requires API key.)","operationId":"ai_models_ep_ai_models_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"search a model name (e.g. llama, qwen, whisper)","title":"Query"},"description":"search a model name (e.g. llama, qwen, whisper)"},{"name":"org","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by org/author (e.g. meta-llama, deepseek-ai)","title":"Org"},"description":"filter by org/author (e.g. meta-llama, deepseek-ai)"},{"name":"task","in":"query","required":false,"schema":{"type":"string","description":"text-generation (default), text-to-image, ... or 'any'","default":"text-generation","title":"Task"},"description":"text-generation (default), text-to-image, ... or 'any'"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"trending | newest | downloads","default":"trending","title":"Sort"},"description":"trending | newest | downloads"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/exploited-vulnerabilities":{"get":{"summary":"Exploited Vulnerabilities","description":"Vulnerabilities CONFIRMED exploited in the wild (CISA KEV) — each enriched with its EPSS\nexploitation-probability score. The 'which CVEs actually matter right now' layer. (Requires API key.)","operationId":"exploited_vulnerabilities_exploited_vulnerabilities_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"match CVE id / name / description","title":"Query"},"description":"match CVE id / name / description"},{"name":"vendor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by vendor (e.g. Microsoft, Cisco)","title":"Vendor"},"description":"filter by vendor (e.g. Microsoft, Cisco)"},{"name":"product","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by product (e.g. Windows, PAN-OS)","title":"Product"},"description":"filter by product (e.g. Windows, PAN-OS)"},{"name":"ransomware_only","in":"query","required":false,"schema":{"type":"boolean","description":"only CVEs linked to ransomware campaigns","default":false,"title":"Ransomware Only"},"description":"only CVEs linked to ransomware campaigns"},{"name":"recent_days","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"only CVEs added to KEV in the last N days","default":0,"title":"Recent Days"},"description":"only CVEs added to KEV in the last N days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/airport-delays":{"get":{"summary":"Airport Delays","description":"Live FAA airport delays, ground stops, closures & ground-delay programs (US National Airspace\nSystem — keyless source). Empty/short list = airspace running normally. (Requires API key.)","operationId":"airport_delays_airport_delays_get","parameters":[{"name":"airport","in":"query","required":false,"schema":{"type":"string","description":"3-letter airport code, e.g. LGA, LAX (optional)","default":"","title":"Airport"},"description":"3-letter airport code, e.g. LGA, LAX (optional)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":60,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/drug-shortages":{"get":{"summary":"Drug Shortages","description":"US drug shortages from the FDA (openFDA — keyless source): is drug X in shortage right now, with\nstatus, reason and company. Informational — confirm clinically. (Requires API key.)","operationId":"drug_shortages_drug_shortages_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"drug / generic name, e.g. amoxicillin (optional)","default":"","title":"Query"},"description":"drug / generic name, e.g. amoxicillin (optional)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sanctions":{"get":{"summary":"Sanctions Screen","description":"Screen a name against the US OFAC SDN sanctions list (keyless OFAC source). A match means the party\nis sanctioned — legally binding the instant OFAC posts it; models can't know recent designations.\nConfirm the full OFAC entry before acting. (Requires API key.)","operationId":"sanctions_screen_sanctions_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string","description":"name to screen against the OFAC SDN list","default":"","title":"Name"},"description":"name to screen against the OFAC SDN list"},{"name":"program","in":"query","required":false,"schema":{"type":"string","description":"optional sanctions program filter, e.g. IRAN, CUBA, SDGT","default":"","title":"Program"},"description":"optional sanctions program filter, e.g. IRAN, CUBA, SDGT"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":25,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/federal-register":{"get":{"summary":"Federal Register","description":"Recent US Federal Register documents — rules, proposed rules, notices, executive orders (keyless\nNARA source). Answers what regulation took effect or what the President signed. (Requires API key.)","operationId":"federal_register_federal_register_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"text search","default":"","title":"Query"},"description":"text search"},{"name":"doc_type","in":"query","required":false,"schema":{"type":"string","description":"RULE | PRORULE | NOTICE | PRESDOCU","default":"","title":"Doc Type"},"description":"RULE | PRORULE | NOTICE | PRESDOCU"},{"name":"agency","in":"query","required":false,"schema":{"type":"string","description":"agency slug, e.g. securities-and-exchange-commission","default":"","title":"Agency"},"description":"agency slug, e.g. securities-and-exchange-commission"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/central-bank-rates":{"get":{"summary":"Central Bank Rates","description":"Current central-bank policy rates for major economies (BIS WS_CBPOL — keyless authoritative source).\nFills the gap left by the US-only interest_rates feed; ~24 jurisdictions, monthly, latest = current\nstance. Models routinely quote stale Fed/ECB levels. (Requires API key.)","operationId":"central_bank_rates_central_bank_rates_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"2-letter code (US, GB, JP, CN, XM=euro area) or blank for all major economies","default":"","title":"Country"},"description":"2-letter code (US, GB, JP, CN, XM=euro area) or blank for all major economies"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/food-prices":{"get":{"summary":"Food Prices","description":"FAO Food Price Index — the global food-inflation benchmark: monthly composite + meat/dairy/cereals/\noils/sugar sub-indices (2014-2016=100). The latest month is post-cutoff. (Requires API key.)","operationId":"food_prices_food_prices_get","parameters":[{"name":"months","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"default":12,"title":"Months"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/drought":{"get":{"summary":"Drought","description":"US drought severity — % of area in each D0-D4 class by week (U.S. Drought Monitor — keyless).\nNational or by state; a commodity-market mover and a hazard signal. (Requires API key.)","operationId":"drought_drought_get","parameters":[{"name":"area","in":"query","required":false,"schema":{"type":"string","description":"'total' (US national) or a state FIPS code","default":"total","title":"Area"},"description":"'total' (US national) or a state FIPS code"},{"name":"weeks","in":"query","required":false,"schema":{"type":"integer","maximum":52,"minimum":1,"default":6,"title":"Weeks"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/water-levels":{"get":{"summary":"Water Levels","description":"Real-time US river levels — gage height + streamflow from USGS (a keyless public-domain source):\nby state, USGS site number(s), or a curated set of major rivers. Rising gage = flood risk; unusually\nlow flow = drought. Each reading carries its USGS observation time. (Requires API key.)","operationId":"water_levels_water_levels_get","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string","description":"2-letter US state code, e.g. TX, CA (optional)","default":"","title":"State"},"description":"2-letter US state code, e.g. TX, CA (optional)"},{"name":"site","in":"query","required":false,"schema":{"type":"string","description":"USGS site number(s), comma-separated (optional)","default":"","title":"Site"},"description":"USGS site number(s), comma-separated (optional)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sports":{"get":{"summary":"Sports","description":"Global ATTENTION + official schedule for a sporting event/team/competition — e.g. the 2026 FIFA\nWorld Cup. Attention = daily Wikipedia article views by language edition, with 7-day momentum & peak;\nplus hosts, start/end dates and sport from Wikidata. Commercially-clean (Wikimedia Pageviews + Wikidata,\nCC0) — this is the neutral global-attention layer, NOT live scores, fixtures or odds. (Requires API key.)","operationId":"sports_sports_get","parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string","description":"event/team/competition, e.g. '2026 FIFA World Cup'","default":"2026 FIFA World Cup","title":"Topic"},"description":"event/team/competition, e.g. '2026 FIFA World Cup'"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":7,"description":"attention window in days","default":30,"title":"Days"},"description":"attention window in days"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"primary Wikipedia language edition (en, es, pt, fr, ...)","default":"en","title":"Lang"},"description":"primary Wikipedia language edition (en, es, pt, fr, ...)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recalls":{"get":{"summary":"Recalls","description":"US product recalls — food, drug & medical-device enforcement reports (openFDA, keyless, CC0).\n'Is product X recalled right now?' Class I = most serious; most-recent first. (Requires API key.)","operationId":"recalls_recalls_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"match the product description (brand/product), or blank for latest","default":"","title":"Query"},"description":"match the product description (brand/product), or blank for latest"},{"name":"category","in":"query","required":false,"schema":{"type":"string","description":"all | food | drug | device","default":"all","title":"Category"},"description":"all | food | drug | device"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/treasury-yields":{"get":{"summary":"Treasury Yields","description":"US Treasury daily par yield curve + 10Y-2Y / 10Y-3M spreads (the recession signal). Keyless\nsource, US public domain. (Requires API key.)","operationId":"treasury_yields_treasury_yields_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather-alerts":{"get":{"summary":"Weather Alerts","description":"Active US NWS weather alerts/warnings — life-safety watches/warnings/advisories. (Requires API key.)","operationId":"weather_alerts_weather_alerts_get","parameters":[{"name":"area","in":"query","required":false,"schema":{"type":"string","description":"2-letter US state (CA, TX...) or marine zone; blank = nationwide Severe/Extreme","default":"","title":"Area"},"description":"2-letter US state (CA, TX...) or marine zone; blank = nationwide Severe/Extreme"},{"name":"event","in":"query","required":false,"schema":{"type":"string","description":"filter by event type, e.g. Flood, Tornado, Heat","default":"","title":"Event"},"description":"filter by event type, e.g. Flood, Tornado, Heat"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/carbon-intensity":{"get":{"summary":"Carbon Intensity","description":"GB grid carbon intensity now + fuel mix + cleanest upcoming half-hour (NESO, CC-BY, keyless\nsource). (Requires API key.)","operationId":"carbon_intensity_carbon_intensity_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sec-filings":{"get":{"summary":"Sec Filings","description":"Recent SEC EDGAR filings for a US public company (8-K / 10-K / S-1 / Form 4). US public domain.\n(Requires API key.)","operationId":"sec_filings_sec_filings_get","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string","description":"US stock ticker, e.g. AAPL, NVDA, TSLA","default":"","title":"Ticker"},"description":"US stock ticker, e.g. AAPL, NVDA, TSLA"},{"name":"form","in":"query","required":false,"schema":{"type":"string","description":"filter by form: 8-K, 10-K, 10-Q, S-1, 4 ...","default":"","title":"Form"},"description":"filter by form: 8-K, 10-K, 10-Q, S-1, 4 ..."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"default":15,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/flights":{"get":{"summary":"Flights","description":"Live aircraft right now — real-time positions from the OpenSky Network. Filter by region\npreset and/or callsign. Airborne flights first. (Requires API key.)","operationId":"flights_flights_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"region preset: london, newyork, paris, tokyo, dubai, europe, usa, asia, ...","title":"Region"},"description":"region preset: london, newyork, paris, tokyo, dubai, europe, usa, asia, ..."},{"name":"callsign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"filter by flight callsign, e.g. BAW123","title":"Callsign"},"description":"filter by flight callsign, e.g. BAW123"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather":{"get":{"summary":"Weather","description":"Current weather anywhere — by city name (geocoded) or lat/lon. Temperature, feels-like,\nwind, humidity, precipitation & conditions, live from Open-Meteo. (Requires API key.)","operationId":"weather_weather_get","parameters":[{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"city name, e.g. London, Tokyo, New York","title":"City"},"description":"city name, e.g. London, Tokyo, New York"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"latitude (alternative to city)","title":"Lat"},"description":"latitude (alternative to city)"},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"longitude (alternative to city)","title":"Lon"},"description":"longitude (alternative to city)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/forecast":{"get":{"summary":"Forecast","description":"Multi-day weather forecast (up to 16 days) by city or lat/lon. (Requires API key.)","operationId":"forecast_forecast_get","parameters":[{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"city name","title":"City"},"description":"city name"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"}},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":16,"minimum":1,"default":7,"title":"Days"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/air-quality":{"get":{"summary":"Air Quality","description":"Current air quality (PM2.5/PM10, US & European AQI) by city or lat/lon. (Requires API key.)","operationId":"air_quality_air_quality_get","parameters":[{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"city name","title":"City"},"description":"city name"},{"name":"lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"}},{"name":"lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/advisories/check":{"get":{"summary":"Advisories Check","description":"Is this exact package@version vulnerable? FULL historical lookup across the entire OSV.dev\ncorpus (Google) — returns every matching advisory + the versions that fix it. (Requires API key.)","operationId":"advisories_check_advisories_check_get","parameters":[{"name":"package","in":"query","required":true,"schema":{"type":"string","description":"package name, e.g. lodash, requests, log4j","title":"Package"},"description":"package name, e.g. lodash, requests, log4j"},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"exact version, e.g. 4.17.10","title":"Version"},"description":"exact version, e.g. 4.17.10"},{"name":"ecosystem","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"npm | pip | maven | go | rubygems | nuget | cargo | composer","title":"Ecosystem"},"description":"npm | pip | maven | go | rubygems | nuget | cargo | composer"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/package-health":{"get":{"tags":["security"],"summary":"Package Health Ep","description":"Package health & security posture from deps.dev (Google Open Source Insights): latest version,\nlicense, known-advisory count, the OpenSSF Scorecard (0-10 + weakest checks) and popularity. The\n'should I depend on this?' check — pairs with /advisories/check and /versions. (Requires API key.)","operationId":"package_health_ep_package_health_get","parameters":[{"name":"package","in":"query","required":true,"schema":{"type":"string","description":"package name, e.g. lodash, requests, django","title":"Package"},"description":"package name, e.g. lodash, requests, django"},{"name":"ecosystem","in":"query","required":false,"schema":{"type":"string","description":"npm | pypi | go | maven | cargo | nuget | rubygems","default":"npm","title":"Ecosystem"},"description":"npm | pypi | go | maven | cargo | nuget | rubygems"},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"exact version (optional; defaults to latest)","title":"Version"},"description":"exact version (optional; defaults to latest)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/github-releases":{"get":{"tags":["dev"],"summary":"Github Releases Ep","description":"Latest GitHub releases for a repo (version, date, author, link) via the public atom feed —\nkeyless source, no rate limit. (Requires API key on REST; the MCP tool is keyless.)","operationId":"github_releases_ep_github_releases_get","parameters":[{"name":"repo","in":"query","required":true,"schema":{"type":"string","description":"owner/name, e.g. openai/openai-python","title":"Repo"},"description":"owner/name, e.g. openai/openai-python"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"max releases (1-25)","default":5,"title":"Limit"},"description":"max releases (1-25)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hacker-news":{"get":{"tags":["dev"],"summary":"Hacker News Ep","description":"Live Hacker News stories — the tech/AI attention layer. Optional case-insensitive title filter. (Requires API key.)","operationId":"hacker_news_ep_hacker_news_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","default":"","title":"Query"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","description":"top | new | best","default":"top","title":"Kind"},"description":"top | new | best"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"max stories (1-30)","default":10,"title":"Limit"},"description":"max stories (1-30)"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dns":{"get":{"tags":["dev"],"summary":"Dns Ep","description":"Live DNS records for a domain via Cloudflare DNS-over-HTTPS. (Requires API key.)","operationId":"dns_ep_dns_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"domain, e.g. example.com","title":"Name"},"description":"domain, e.g. example.com"},{"name":"type","in":"query","required":false,"schema":{"type":"string","description":"A | AAAA | MX | TXT | NS | CNAME | SOA | CAA","default":"A","title":"Type"},"description":"A | AAAA | MX | TXT | NS | CNAME | SOA | CAA"},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"tags":["agent"],"summary":"V1 Me","description":"Your key at a glance — plan, calls used today, daily quota and remaining. The per-user usage view\n(the keyless MCP endpoint is unmetered fair-use).","operationId":"v1_me_v1_me_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-rapidapi-proxy-secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"x-rapidapi-user","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/checkout":{"post":{"summary":"Checkout","description":"Start a Stripe Checkout for a paid plan. Returns a payment URL.","operationId":"checkout_billing_checkout_post","parameters":[{"name":"api_key","in":"query","required":true,"schema":{"type":"string","description":"the key you want to upgrade","title":"Api Key"},"description":"the key you want to upgrade"},{"name":"tier","in":"query","required":false,"schema":{"type":"string","description":"pro ($19/mo), ultra ($59/mo) or mega ($199/mo)","default":"pro","title":"Tier"},"description":"pro ($19/mo), ultra ($59/mo) or mega ($199/mo)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/billing/success":{"get":{"summary":"Billing Success","operationId":"billing_success_billing_success_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/billing/webhook":{"post":{"summary":"Billing Webhook","description":"Stripe calls this to confirm payments. Upgrades/downgrades the key.","operationId":"billing_webhook_billing_webhook_post","parameters":[{"name":"stripe-signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_signup_signup_post":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"optional, for receipts"}},"type":"object","title":"Body_signup_signup_post"},"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"}}}}