{
  "schema_version": "1.0",
  "name": "QuantGist AI Assets Catalog",
  "description": "Machine-readable catalog of QuantGist APIs, AI-enriched data services, automation agents, SDKs, MCP surfaces, and distribution assets.",
  "publisher": {
    "name": "QuantGist",
    "url": "https://quantgist.com"
  },
  "last_updated": "2026-06-01",
  "discovery": {
    "llms_txt": "https://quantgist.com/llms.txt",
    "api_llms_txt": "https://api.quantgist.com/llms.txt",
    "api_llms_full": "https://api.quantgist.com/llms-full.txt",
    "openapi": "https://api.quantgist.com/openapi.json",
    "docs": "https://quantgist.com/docs",
    "mcp_docs": "https://quantgist.com/docs/mcp",
    "api_docs": "https://api.quantgist.com/v1/docs",
    "product_faq": "https://quantgist.com/faq.md"
  },
  "assets": [
    {
      "id": "quantgist-market-intelligence-api",
      "type": "api",
      "status": "available",
      "name": "Market Intelligence API",
      "description": "REST API for normalized economic calendar events, financial news, sentiment, impact scoring, watchlists, usage, and webhooks.",
      "base_url": "https://api.quantgist.com/v1",
      "docs_url": "https://api.quantgist.com/v1/docs",
      "openapi_url": "https://api.quantgist.com/openapi.json",
      "primary_users": ["algorithmic traders", "trading bot developers", "fintech builders", "research teams"],
      "authentication": "X-API-Key header",
      "pricing_model": "Free, Starter, Pro, Team, Enterprise",
      "notable_params": [
        {
          "endpoint": "GET /v1/events",
          "param": "backtest_safe",
          "type": "boolean",
          "description": "When true, enforces released_only + actual_required + official_only + first_print_only simultaneously. Always combine with canonical_id (e.g. US_CPI_YOY, US_NFP) for a clean, look-ahead-bias-free backtest series. Do not use ?q= substring search for backtesting."
        },
        {
          "endpoint": "GET /v1/events",
          "param": "canonical_id",
          "type": "string",
          "description": "Stable, source-independent identifier for a named macro series. Examples: US_CPI_YOY, US_NFP, US_PCE, US_GDP, US_FOMC. Preferred over ?q= free-text search for any time-series or backtest workflow."
        }
      ]
    },
    {
      "id": "quantgist-news-radar",
      "type": "api_surface",
      "status": "available",
      "name": "News Radar",
      "description": "Scored, clustered market-risk surface for unscheduled events. Use for geopolitical crises, surprise central-bank rate moves, unplanned supply shocks, and other non-calendar market-moving risks. Returns event groups with impact_score [0,1], confidence, affected_assets tickers, and lifecycle status. Complements /v1/news (raw headline search) — Radar is the right choice when you need structured risk monitoring rather than keyword search.",
      "endpoint": "GET /v1/news/radar",
      "docs_url": "https://quantgist.com/docs#news-radar",
      "availability": "Free (10 reads/day), Starter+ (unlimited)",
      "topic_packs": [
        { "slug": "iran-war", "description": "Iran military conflict and Hormuz shipping risk" },
        { "slug": "oil-supply", "description": "OPEC+ cuts, pipeline outages, supply disruptions" },
        { "slug": "sanctions", "description": "New or lifted economic sanctions" },
        { "slug": "central-bank-unscheduled", "description": "Emergency / unscheduled central bank rate moves" },
        { "slug": "trump-posts", "description": "Trump social-media policy announcements" },
        { "slug": "middle-east-risk", "description": "Broader Middle East geopolitical escalation" },
        { "slug": "cyberattack", "description": "Major infrastructure or financial-sector cyber incidents" },
        { "slug": "ceasefire", "description": "Ceasefire announcements and de-escalation signals" },
        { "slug": "opec", "description": "OPEC/OPEC+ production decisions and compliance reports" }
      ],
      "example_calls": [
        "GET /v1/news/radar?topic=iran-war&min_impact=0.6&limit=10",
        "GET /v1/news/radar?topic=central-bank-unscheduled&limit=5"
      ]
    },
    {
      "id": "quantgist-sentiment-analyzer",
      "type": "model",
      "status": "available",
      "name": "Sentiment Analyzer",
      "description": "Event sentiment scorer that combines headline/body language with numeric actual-vs-forecast surprise when available.",
      "inputs": ["event title", "event body", "actual value", "forecast value", "previous value"],
      "outputs": ["sentiment_score", "sentiment_label"],
      "availability": "Starter plan and above"
    },
    {
      "id": "quantgist-impact-scorer",
      "type": "model",
      "status": "available",
      "name": "Impact Scorer",
      "description": "Normalizes event importance into a 0.0-1.0 score using source impact, indicator category, currency, asset class, and surprise metadata.",
      "inputs": ["event type", "source impact", "currency", "country", "indicator", "surprise"],
      "outputs": ["impact_score"],
      "availability": "All plans"
    },
    {
      "id": "quantgist-symbol-tagger",
      "type": "model",
      "status": "available",
      "name": "Symbol Tagger",
      "description": "Maps macro and market events to relevant symbols, currencies, countries, sectors, and asset classes.",
      "inputs": ["title", "currency", "country", "event type", "source metadata"],
      "outputs": ["symbols", "sectors", "asset_classes"],
      "availability": "All plans"
    },
    {
      "id": "quantgist-webhook-delivery-agent",
      "type": "agent",
      "status": "available",
      "name": "Webhook Delivery Agent",
      "description": "Background delivery worker that sends signed real-time event notifications to customer HTTPS endpoints with retries and delivery tracking.",
      "interfaces": ["POST /v1/webhooks", "GET /v1/webhooks/{id}/deliveries"],
      "availability": "Pro plan and above"
    },
    {
      "id": "quantgist-python-sdk",
      "type": "sdk",
      "status": "scaffolded_publish_pending",
      "name": "Python SDK",
      "description": "First-party Python client for fetching events, calendars, sentiment, symbols, intelligence, usage, watchlists, notifications, and webhooks.",
      "package": "quantgist",
      "version": "0.3.0",
      "runtime": "Python 3.10+",
      "repository": "https://github.com/quantgist/quantgist-python",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/SDKS/quantgist-python",
      "docs_url": "https://quantgist.com/docs",
      "distribution_role": "Developer adoption, notebooks, research workflows, bot backends, and agent tool implementations."
    },
    {
      "id": "quantgist-javascript-sdk",
      "type": "sdk",
      "status": "scaffolded_publish_pending",
      "name": "JavaScript SDK",
      "description": "First-party JavaScript/TypeScript client for integrating QuantGist data into apps, bots, dashboards, and agent tools.",
      "package": "quantgist-js",
      "version": "0.3.0",
      "runtime": "Node 20+",
      "repository": "https://github.com/quantgist/quantgist-js",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/SDKS/quantgist-js",
      "docs_url": "https://quantgist.com/docs",
      "distribution_role": "Next.js apps, trading dashboards, Discord/Telegram tooling, widgets, and browser-adjacent developer workflows."
    },
    {
      "id": "quantgist-cli",
      "type": "cli",
      "status": "complete_publish_pending",
      "name": "qgist CLI",
      "description": "Command-line interface for querying events, checking status, configuring API keys, and exporting macro event datasets.",
      "package": "qgist",
      "version": "0.1.0",
      "runtime": "Python 3.10+",
      "entrypoint": "qgist",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/quantgist-cli",
      "commands": ["events today", "events week", "export nfp", "config set", "status"],
      "distribution_role": "Research workflows, local automation, demos, and developer onboarding."
    },
    {
      "id": "quantgist-mt5-bridge",
      "type": "trading_platform_bridge",
      "status": "complete_submission_pending",
      "name": "QuantGist MT5 Bridge",
      "description": "MQL5 bridge for MetaTrader 5 Expert Advisors, including API client helpers, event filters, timezone utilities, and example EAs.",
      "platform": "MetaTrader 5",
      "language": "MQL5",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/quantgist-mt5",
      "included_examples": ["QuantGist_NewsPause.mq5", "QuantGist_Breakout.mq5"],
      "distribution_role": "Retail trader adoption, MQL5 community distribution, and live strategy news-risk controls."
    },
    {
      "id": "quantgist-microapps-widgets",
      "type": "web_distribution_surface",
      "status": "available",
      "name": "Micro-Apps and Embeddable Widgets",
      "description": "Next.js micro-apps and iframe widgets that expose QuantGist macro event intelligence through public trader tools and embeddable calendars.",
      "package": "quantgist-microapps",
      "version": "0.1.0",
      "runtime": "Node 20+ / Next.js 15",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/microapps-widgets",
      "tools": ["MarketPulse", "TradeWindow", "Event Countdown Radar", "Smart Economic Calendar", "Macro Heatmap", "Surprise Analyzer", "API Query Playground", "Daily Briefing Card", "Central Bank Rate Tracker", "Country Macro Momentum Score", "Embed Builder", "Don't Trade Window Generator", "Event Impact Simulator", "Weekly Macro Outlook", "Asset Explorer"],
      "distribution_role": "SEO, trader acquisition, widget embeds, lead capture, and partner distribution."
    },
    {
      "id": "quantgist-alert-bots",
      "type": "automation_bots",
      "status": "complete_deploy_pending",
      "name": "Telegram and Discord Alert Bots",
      "description": "Community alert bots that deliver scheduled macro event alerts, daily briefings, subscriptions, and event lookups into Telegram and Discord groups.",
      "packages": ["qg-telegram-bot", "qg-discord-bot"],
      "versions": ["0.1.0", "0.1.0"],
      "runtime": "Python 3.10+",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/quantgist-bots",
      "entrypoints": ["qg-telegram", "qg-discord"],
      "distribution_role": "Community growth, habit formation, group distribution, and alert automation."
    },
    {
      "id": "quantgist-freqtrade-plugin",
      "type": "trading_bot_integration",
      "status": "complete_publish_pending",
      "name": "QuantGist freqtrade Protection Plugin",
      "description": "freqtrade protection plugin that blocks or filters strategy entries around high-impact macro events.",
      "package": "quantgist-freqtrade",
      "version": "0.1.0",
      "runtime": "Python 3.10+",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/quantgist-integrations/freqtrade",
      "distribution_role": "Open-source trading bot adoption and automated news blackout controls."
    },
    {
      "id": "quantgist-tradingview-relay",
      "type": "webhook_integration",
      "status": "complete_deploy_pending",
      "name": "TradingView Webhook Relay",
      "description": "FastAPI relay that receives TradingView webhooks, checks QuantGist macro-event safety, and forwards approved signals to a broker or downstream automation.",
      "package": "quantgist-tv-relay",
      "version": "0.1.0",
      "runtime": "Python 3.10+ / FastAPI",
      "entrypoint": "qg-tv-relay",
      "workspace_path": "D:/01code/Projects/QuantGist_Ecosystem/quantgist-integrations/tradingview-webhooks",
      "distribution_role": "TradingView community adoption, safety-check automation, and broker/workflow integrations."
    },
    {
      "id": "quantgist-mcp-server",
      "type": "mcp_server",
      "status": "available",
      "name": "QuantGist MCP Server",
      "description": "Model Context Protocol server exposing 11 QuantGist tools to Claude Desktop, Claude Code, and other MCP-compatible AI agents. Tools cover macro events, economic calendar, trade safety checks, earnings history, and market overview.",
      "package": "quantgist-mcp",
      "version": "0.1.0",
      "runtime": "Python 3.10+",
      "transport": "stdio",
      "entrypoint": "quantgist-mcp",
      "github_url": "https://github.com/QuantGist-Technologies/QuantGist_MCP",
      "docs_url": "https://quantgist.com/docs/mcp",
      "install_command": "pip install git+https://github.com/QuantGist-Technologies/QuantGist_MCP.git",
      "authentication": "QUANTGIST_API_KEY environment variable",
      "supported_clients": ["Claude Desktop", "Claude Code", "Cursor", "any MCP-compatible agent"],
      "tools": [
        "get_upcoming_events",
        "get_events_range",
        "check_safe_to_trade",
        "get_economic_calendar",
        "get_event_detail",
        "get_earnings_upcoming",
        "get_earnings_for_ticker",
        "get_earnings_summary",
        "get_earnings_surprises",
        "get_earnings_season_summary",
        "get_markets_overview"
      ],
      "target_users": ["Claude Desktop users", "Claude Code users", "AI coding agents", "research agents", "trading workflow agents"]
    }
  ]
}
