plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "gexstream",
  "version": "1.0.0",
  "description": "Options positioning analytics",
  "author": {
    "name": "QuantLens, LLC",
    "url": "https://gexstream.com"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GEXStream",
        "shortDescription": "Options positioning analytics",
        "longDescription": "GEXStream tracks options positioning for 650+ US stocks, ETFs and indices. Use this plugin to read a ticker's current snapshot or its hourly history: gamma exposure (GEX) and volume-weighted vGEX with the zero-gamma level and the largest positive and negative strikes, delta, vanna and charm exposures (DEX, VEX, CEX), aggressor-signed options flow, call and put implied volatility, open interest and volume. Values refresh about every 5 minutes during market hours.\n\nRead-only: it never places trades or changes your account. Requires a GEXStream account with API access; usage counts against the account's daily API limits. Educational market-structure data, not financial advice.",
        "developerName": "QuantLens, LLC",
        "category": "Finance",
        "capabilities": [],
        "websiteURL": "https://gexstream.com",
        "supportURL": "https://gexstream.com/support",
        "privacyPolicyURL": "https://gexstream.com/privacy",
        "termsOfServiceURL": "https://gexstream.com/terms",
        "defaultPrompt": [
          "GEXStream where is SPY's zero gamma right now?",
          "GEXStream how has QQQ's GEX ratio moved over the last 30 sessions?",
          "GEXStream compare NVDA's call and put IV and open interest today"
        ],
        "brandColor": "#B8860B",
        "brandColorDark": "#D4A742",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A live snapshot for one ticker returns the zero-gamma level with the spot price and an as-of time.",
              "prompt": "Where is SPY's zero gamma level right now?",
              "tools_triggered": "get_gex_snapshot",
              "expected_behavior": "ChatGPT calls get_gex_snapshot for SPY and reports the zero-gamma strike, the current spot and the as-of time, noting values can be up to 5 minutes old."
            },
            {
              "description": "Hourly history over several sessions is summarized as a trend.",
              "prompt": "How has QQQ's GEX ratio moved over the last 30 sessions?",
              "tools_triggered": "get_gex_history",
              "expected_behavior": "ChatGPT calls get_gex_history for QQQ over 30 sessions and summarizes how the GEX ratio changed, citing the start and end values."
            },
            {
              "description": "Coverage questions are answered from the tracked-ticker list, not guessed.",
              "prompt": "Does GEXStream cover NVDA?",
              "tools_triggered": "list_tickers",
              "expected_behavior": "ChatGPT calls list_tickers and confirms NVDA is in the tracked universe."
            },
            {
              "description": "Field meanings come from the plugin's own glossary.",
              "prompt": "What do the vex and cex fields in a GEXStream snapshot mean?",
              "tools_triggered": "describe_fields",
              "expected_behavior": "ChatGPT calls describe_fields and explains vanna exposure (vex) and charm exposure (cex) in the plugin's wording."
            },
            {
              "description": "Usage against the daily limit is reported from the account, not estimated.",
              "prompt": "How much of my GEXStream daily quota have I used today?",
              "tools_triggered": "get_usage",
              "expected_behavior": "ChatGPT calls get_usage and reports today's snapshot and history counts against the account's limits."
            }
          ],
          "negative": [
            {
              "description": "The plugin is read-only and must never be used to transact.",
              "prompt": "Use GEXStream to buy 10 SPY calls at the ask.",
              "expected_behavior": "No tool is called. ChatGPT explains that GEXStream only reads analytics and cannot place orders."
            },
            {
              "description": "An unknown ticker is reported as unknown, with no fabricated data.",
              "prompt": "Get the GEXStream snapshot for ticker ZZZZQ.",
              "expected_behavior": "get_gex_snapshot returns an unknown-ticker result and ChatGPT says the ticker is not covered, without inventing values."
            },
            {
              "description": "Unrelated requests do not trigger the plugin.",
              "prompt": "What's the weather in Chicago this afternoon?",
              "expected_behavior": "No GEXStream tool is called."
            }
          ]
        },
        "commerce": false
      },
      "publication": {
        "release_notes": "Initial release: five read-only tools over the GEXStream API v1 (snapshot, hourly history, tracked tickers, usage, field glossary)."
      },
      "apps": "./.app.json"
    }
  }
}