{
  "openapi": "3.1.0",
  "info": {
    "title": "DeepFlow public API",
    "version": "1.0.0",
    "description": "The public DeepFlow API currently exposes a read-only market-price snapshot. DeepFlow research access is pre-launch and is not available through this API."
  },
  "servers": [
    { "url": "https://deepflow-orcin.vercel.app", "description": "Production" }
  ],
  "paths": {
    "/api/market/live-prices": {
      "get": {
        "operationId": "getLivePrices",
        "summary": "Get a current market-price snapshot",
        "description": "Returns the latest available price and percentage change for up to 20 ticker symbols. Data is informational and must not be treated as investment advice.",
        "parameters": [
          {
            "name": "tickers",
            "in": "query",
            "required": true,
            "description": "Comma-separated ticker symbols, for example SPY,^IXIC.",
            "schema": { "type": "string", "minLength": 1, "maxLength": 300 }
          }
        ],
        "responses": {
          "200": {
            "description": "Latest available market data.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["prices"],
                  "properties": {
                    "prices": { "type": "object", "additionalProperties": { "type": ["number", "null"] } },
                    "changes": { "type": "object", "additionalProperties": { "type": ["number", "null"] } }
                  }
                }
              }
            }
          },
          "405": { "description": "Method not allowed." },
          "429": { "description": "Rate limit exceeded." },
          "500": { "description": "Market data source unavailable." }
        }
      }
    }
  }
}