{
  "generated_at": "2026-04-26T08:48:20Z",
  "schema_version": "0.1.0",
  "updated_at": "2026-04-26T00:00:00Z",
  "verification_policy": "Candidate sources are manually reviewed for public documentation and machine-readable relevance. Inclusion is not endorsement and does not imply production reliability.",
  "sources": [
    {
      "id": "sec-edgar-apis",
      "title": "SEC EDGAR APIs",
      "category": "filings",
      "formats": [
        "JSON",
        "RSS",
        "bulk ZIP"
      ],
      "url": "https://www.sec.gov/edgar/sec-api-documentation",
      "summary": "Official SEC APIs for company submissions and XBRL data, useful for filings, corporate events, and regulatory monitoring.",
      "agent_use": "Monitor submissions, company facts, filing histories, and structured disclosure updates.",
      "market_relevance": "Useful for equities, credit, crypto-company filings, M&A, insider activity, and event-driven workflows.",
      "notes": [
        "SEC documentation says data.sec.gov provides RESTful JSON APIs without authentication or API keys.",
        "SEC documentation says JSON structures update throughout the day as submissions are disseminated."
      ],
      "authority_level": "official",
      "auth_required": "no",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "throughout the day as filings disseminate",
      "best_endpoint": "https://www.sec.gov/edgar/sec-api-documentation",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "polymarket-apis",
      "title": "Polymarket APIs",
      "category": "prediction-markets",
      "formats": [
        "JSON",
        "REST",
        "CLOB API"
      ],
      "url": "https://docs.polymarket.com/api-reference",
      "summary": "Official Polymarket API documentation for market discovery, events, pricing, order books, and trading operations.",
      "agent_use": "Discover markets and events through the Gamma API, monitor pricing and order books through public CLOB endpoints, and link market wording to source evidence.",
      "market_relevance": "Directly relevant for prediction-market agents and market-research workflows.",
      "notes": [
        "Polymarket documentation describes Gamma and Data APIs as public.",
        "Trading endpoints require authentication."
      ],
      "authority_level": "official",
      "auth_required": "mixed",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "market-data endpoints vary by API",
      "best_endpoint": "https://docs.polymarket.com/api-reference",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "kalshi-api",
      "title": "Kalshi API",
      "category": "prediction-markets",
      "formats": [
        "JSON",
        "REST",
        "WebSocket",
        "OpenAPI",
        "AsyncAPI"
      ],
      "url": "https://docs.kalshi.com/",
      "summary": "Official Kalshi API documentation for regulated event market data, order books, and trading workflows.",
      "agent_use": "Monitor event markets, contract metadata, prices, order books, and market status.",
      "market_relevance": "Directly relevant for macro, politics, weather, economics, and other event-contract workflows.",
      "notes": [
        "Useful as a primary market-data source for Kalshi-specific monitoring.",
        "Authentication and exchange rules apply for trading actions."
      ],
      "authority_level": "official",
      "auth_required": "mixed",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "market-data endpoints vary; WebSocket available",
      "best_endpoint": "https://docs.kalshi.com/",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "fred-release-dates",
      "title": "FRED Release Dates API",
      "category": "macro",
      "formats": [
        "JSON",
        "XML",
        "REST"
      ],
      "url": "https://fred.stlouisfed.org/docs/api/fred/releases_dates.html",
      "summary": "St. Louis Fed API endpoint for economic data release dates across FRED releases.",
      "agent_use": "Build macro release calendars and monitor when economic series are expected to update.",
      "market_relevance": "Useful for rates, FX, equities, inflation, employment, and macro prediction-market workflows.",
      "notes": [
        "FRED release dates are published by data sources and may not equal the exact time data appears on FRED.",
        "A FRED API key is required."
      ],
      "authority_level": "official",
      "auth_required": "yes",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "release calendar / API dependent",
      "best_endpoint": "https://fred.stlouisfed.org/docs/api/fred/releases_dates.html",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "federal-reserve-rss",
      "title": "Federal Reserve RSS Feeds",
      "category": "macro",
      "formats": [
        "RSS",
        "XML"
      ],
      "url": "https://www.federalreserve.gov/feeds/feeds.htm",
      "summary": "Official Federal Reserve RSS feeds for press releases, speeches, policy updates, working papers, and data announcements.",
      "agent_use": "Monitor Fed communications and trigger text comparison or source-following workflows.",
      "market_relevance": "Relevant for central-bank event monitoring, FOMC statement changes, rates, FX, equities, and crypto.",
      "notes": [
        "RSS is suitable for repeated low-frequency polling.",
        "Agents should follow primary release links for final source material."
      ],
      "authority_level": "official",
      "auth_required": "no",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "on publication",
      "best_endpoint": "https://www.federalreserve.gov/feeds/feeds.htm",
      "last_verified": "2026-04-26",
      "machine_readability_score": 2,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "gdelt-cloud",
      "title": "GDELT Cloud",
      "category": "news-events",
      "formats": [
        "JSON API",
        "MCP tools"
      ],
      "url": "https://docs.gdeltcloud.com/",
      "summary": "Structured global news-event data with APIs and MCP tools for agent and analyst workflows.",
      "agent_use": "Monitor global events, clustered stories, entities, summaries, and article evidence.",
      "market_relevance": "Useful for geopolitical, conflict, commodity, policy, and broad news-event monitoring.",
      "notes": [
        "GDELT Cloud documentation explicitly references AI agents and MCP access.",
        "News-derived data is broad and noisy; filtering quality matters."
      ],
      "authority_level": "third-party",
      "auth_required": "unknown",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "varies by endpoint",
      "best_endpoint": "https://docs.gdeltcloud.com/",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "nws-alerts",
      "title": "National Weather Service Alerts API",
      "category": "weather",
      "formats": [
        "JSON-LD",
        "CAP XML",
        "Atom"
      ],
      "url": "https://www.weather.gov/documentation/services-web-alerts",
      "summary": "Official National Weather Service alert service for watches, warnings, advisories, and active weather alerts.",
      "agent_use": "Monitor active alerts through Atom indexes and pull structured alert details as needed.",
      "market_relevance": "Useful for weather, agriculture, energy, insurance, disaster, and prediction-market workflows.",
      "notes": [
        "NWS documentation identifies JSON-LD as the default API format for indexes and products.",
        "NWS documentation recommends Atom index files for tracking active alerts in near real time."
      ],
      "authority_level": "official",
      "auth_required": "no",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "near real time via Atom indexes",
      "best_endpoint": "https://www.weather.gov/documentation/services-web-alerts",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "predmktdata",
      "title": "PredMktData",
      "category": "prediction-markets",
      "formats": [
        "llms.txt",
        "API",
        "WebSocket",
        "Parquet",
        "CSV"
      ],
      "url": "https://predmktdata.com/",
      "summary": "Polymarket data service exposing on-chain prediction-market data through dumps, APIs, and agent-readable documentation.",
      "agent_use": "Monitor Polymarket market data, historical data, resolution data, and integration guidance through a purpose-built data surface.",
      "market_relevance": "Useful for prediction-market analytics, backtesting, market lookup, and agent workflows that need normalized Polymarket data.",
      "notes": [
        "The site advertises an agent-readable llms.txt at https://predmktdata.com/llms.txt.",
        "Commercial terms, coverage, and latency should be verified before production use."
      ],
      "authority_level": "third-party",
      "auth_required": "mixed",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "service dependent",
      "best_endpoint": "https://predmktdata.com/",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "metaculus-api",
      "title": "Metaculus API",
      "category": "forecasting",
      "formats": [
        "JSON",
        "REST"
      ],
      "url": "https://www.metaculus.com/api2/questions/",
      "summary": "Machine-readable Metaculus question endpoint useful for monitoring forecasting questions, statuses, dates, and resolution criteria.",
      "agent_use": "Discover and monitor forecasting questions that may map to public events or prediction-market topics.",
      "market_relevance": "Useful for event discovery, question wording, resolution logic, and comparing expert forecasting activity with market prices.",
      "notes": [
        "The endpoint is directly machine-readable, but agents should verify current API behavior and terms.",
        "Metaculus is a forecasting platform, not a financial exchange."
      ],
      "authority_level": "platform",
      "auth_required": "unknown",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "platform dependent",
      "best_endpoint": "https://www.metaculus.com/api2/questions/",
      "last_verified": "2026-04-26",
      "machine_readability_score": 2,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "manifold-api",
      "title": "Manifold API",
      "category": "forecasting",
      "formats": [
        "JSON",
        "REST"
      ],
      "url": "https://docs.manifold.markets/api",
      "summary": "Public Manifold API documentation for markets, users, bets, comments, and related forecasting-platform activity.",
      "agent_use": "Monitor long-tail forecasting questions, market discussion, and social prediction signals.",
      "market_relevance": "Useful for signal discovery and research, but Manifold is not a cash financial market.",
      "notes": [
        "Good for broad question discovery and qualitative signal monitoring.",
        "Agents should distinguish play-money forecast signals from tradable market prices."
      ],
      "authority_level": "platform",
      "auth_required": "mixed",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "platform dependent",
      "best_endpoint": "https://docs.manifold.markets/api",
      "last_verified": "2026-04-26",
      "machine_readability_score": 2,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "predscope-api",
      "title": "PredScope Prediction Market API",
      "category": "prediction-markets",
      "formats": [
        "JSON",
        "REST"
      ],
      "url": "https://predscope.com/guide/prediction-market-api",
      "summary": "Public JSON prediction-market endpoint describing live odds, volume, liquidity, categories, and outcomes.",
      "agent_use": "Poll normalized prediction-market data for discovery and lightweight monitoring.",
      "market_relevance": "Useful for monitoring prediction-market odds and identifying large changes for follow-up.",
      "notes": [
        "PredScope documentation advertises no-auth JSON access and a fair-use rate limit.",
        "Agents should verify source coverage and attribution requirements."
      ],
      "authority_level": "third-party",
      "auth_required": "no",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "documentation advertises frequent updates; verify current cadence",
      "best_endpoint": "https://predscope.com/guide/prediction-market-api",
      "last_verified": "2026-04-26",
      "machine_readability_score": 2,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "bls-api",
      "title": "BLS Public Data API and RSS",
      "category": "macro",
      "formats": [
        "JSON",
        "RSS",
        "XLSX"
      ],
      "url": "https://www.bls.gov/developers/home.htm",
      "summary": "Bureau of Labor Statistics machine-readable access for labor, inflation, wages, productivity, and related releases.",
      "agent_use": "Monitor official macroeconomic data releases and related RSS/news updates.",
      "market_relevance": "Useful for CPI, jobs, unemployment, wages, PPI, and other market-moving economic indicators.",
      "notes": [
        "Useful for official data after publication; low-latency trading use should follow source release mechanics carefully.",
        "Pair with release calendars and RSS feeds for update detection."
      ],
      "authority_level": "official",
      "auth_required": "mixed",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "on official release / endpoint dependent",
      "best_endpoint": "https://www.bls.gov/developers/home.htm",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "federal-register-api",
      "title": "Federal Register API",
      "category": "regulatory",
      "formats": [
        "JSON",
        "RSS"
      ],
      "url": "https://www.federalregister.gov/developers/documentation/api/v1",
      "summary": "Official API for rules, proposed rules, notices, agency actions, and regulatory documents.",
      "agent_use": "Monitor regulatory catalysts and agency actions affecting markets, crypto, banking, energy, healthcare, and other sectors.",
      "market_relevance": "Useful for policy-sensitive prediction markets and regulatory event-driven workflows.",
      "notes": [
        "Good source for official regulatory documents and agency actions.",
        "Agents should map documents to affected sectors and source-of-truth agencies."
      ],
      "authority_level": "official",
      "auth_required": "no",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "on publication / API dependent",
      "best_endpoint": "https://www.federalregister.gov/developers/documentation/api/v1",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    },
    {
      "id": "treasury-fiscaldata",
      "title": "Treasury FiscalData API",
      "category": "macro",
      "formats": [
        "JSON",
        "CSV",
        "XML"
      ],
      "url": "https://fiscaldata.treasury.gov/api-documentation/",
      "summary": "U.S. Treasury API documentation for fiscal datasets including debt, auctions, rates, exchange rates, and fiscal flows.",
      "agent_use": "Monitor Treasury and fiscal datasets relevant to rates, liquidity, debt issuance, and macro workflows.",
      "market_relevance": "Useful for rates, liquidity, debt ceiling, Treasury auctions, and macro prediction markets.",
      "notes": [
        "Useful as an official source for Treasury datasets.",
        "Agents should inspect dataset-specific update cadence and fields."
      ],
      "authority_level": "official",
      "auth_required": "no",
      "rate_limit_notes": "Check source documentation before production use.",
      "update_cadence": "dataset dependent",
      "best_endpoint": "https://fiscaldata.treasury.gov/api-documentation/",
      "last_verified": "2026-04-26",
      "machine_readability_score": 3,
      "production_caveat": "Verify terms, latency, coverage, and endpoint behavior before relying on this source."
    }
  ]
}
