{"components":{"schemas":{"TradeIdeasResponse":{"additionalProperties":true,"properties":{"active_constraints":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"answer":{"type":"string"},"date":{"format":"date","type":"string"},"facts":{"additionalProperties":true,"type":"object"},"ideas":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"latencyMs":{"type":"number"},"quoteFetches":{"type":"integer"},"request":{"additionalProperties":true,"type":"object"}},"required":["answer"],"type":"object"}},"securitySchemes":{"apiKeyAuth":{"in":"header","name":"X-API-Key","type":"apiKey"},"bearerAuth":{"bearerFormat":"sgk_ API key","scheme":"bearer","type":"http"}}},"externalDocs":{"description":"Open the OptionsTape Trade Ideas interface","url":"https://optionstape.trade/trade-ideas"},"info":{"description":"Build informational options-strategy candidates from an explicit thesis, horizon, and risk constraints. Read-only: this API never places or routes orders.","title":"OptionsTape Trade Ideas API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v1/trade-ideas":{"post":{"description":"Use when a user wants candidate option structures for a stated market thesis. Include the ticker, direction, expiration or DTE, volatility view, support/resistance or target, and loss/cost constraints when known. Do not use for order execution.","operationId":"generateOptionsTradeIdeas","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"history":{"items":{"additionalProperties":false,"properties":{"content":{"maxLength":1200,"type":"string"},"role":{"enum":["user","assistant"],"type":"string"}},"required":["role","content"],"type":"object"},"maxItems":8,"type":"array"},"message":{"description":"Natural-language trading thesis and constraints.","maxLength":1200,"minLength":1,"type":"string"},"modes":{"description":"Optional explicit objective filters. Never infer a mode that contradicts the message.","items":{"enum":["earnings","finance","unusual","cheap","defined_risk","credit"],"type":"string"},"type":"array","uniqueItems":true}},"required":["message"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeIdeasResponse"}}},"description":"Ranked candidate structures, active constraints, pricing provenance, and diagnostics."},"400":{"description":"Invalid prompt or modes."},"401":{"description":"Missing or invalid credentials."},"403":{"description":"The API key lacks the trade-ideas grant."},"429":{"description":"Client rate limit exceeded."},"502":{"description":"The idea engine is temporarily unavailable."}},"security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"summary":"Generate options trade ideas"}}},"servers":[{"url":"https://optionstape.trade"}]}