通过 HTTPS 执行 SQL
向 REST 端点发送 SELECT 查询，获取结构化 JSON，用于分析、报表与研究应用。无需自建 CSV 数仓。
OptionData
首年 50% 优惠
14 天免费试用后，首年可享 50% 优惠。请先创建账户；完成资格审核需要邀请码。请联系销售获取优惠码，然后在账单页面使用。
历史期权成交 API（SQL）
正在准备 API 工作台…
API 产品介绍与示例
美股期权历史数据 API
美股期权历史数据 API（SQL）
美股期权历史数据 API：经 REST 与 ClickHouse SQL 查询 OPRA 授权美股期权成交历史。无需批量下载，可用于回测与研究。付费 Pro 可查询过去 15 天的成交，延迟 15 分钟。
历史期权数据历史期权数据 API期权数据API股票期权数据 API期权数据库ClickHouse 期权 SQL
REST 端点
POST https://www.optiondata.io/api/historical/sql- 15 天
- 付费历史范围
- SQL
- 查询接口
- 15 分钟
- 最低延迟
Ask ChatGPT or Claude Code
Copy this prompt, paste it into ChatGPT, Claude, Claude Code, Cursor, or Codex, then add your question. It tells the model to read our public docs first — no API key needed for that step.
You are helping me use OptionData (https://www.optiondata.io/), an OPRA-licensed U.S. equity options data API.
Before answering, fetch these public files (no login required) and treat them as the source of truth:
- https://www.optiondata.io/llms.txt — short product map (same content as https://www.optiondata.io/llm.txt)
- https://www.optiondata.io/llms-full.txt — full API reference
- https://www.optiondata.io/openapi.json — HTTP OpenAPI
Do not invent endpoints, fields, tables, or limits. Prefer `Authorization: Bearer apikey_…` for HTTP APIs. Realtime uses `wss://ws.optiondata.io` with a `token` query parameter.
Products:
- Realtime trades WebSocket: wss://ws.optiondata.io
- Historical SQL: POST https://www.optiondata.io/api/historical/sql
- Option chain: POST https://www.optiondata.io/api/option-chain
- Market structure: GET https://www.optiondata.io/api/v1/market-structure/{symbol}
I am asking about: Historical Option Trades API (SQL)
- Product / playground page: https://www.optiondata.io/historical_data
- Markdown: https://www.optiondata.io/md/historical-option-trades-api
- HTML docs: https://www.optiondata.io/docs/historical-option-trades-api
My question:
适合回测的期权历史
对未做 AGGREGATED 合并的 RAW 成交历史执行 SELECT。存储列与派生字段公式见历史 SQL 文档。
受控查询执行
门户会应用 SELECT-only 检查、表白名单、行数限制和 ClickHouse 限制，降低客户查询风险。
适合场景
- 历史期权流回测
- 信号研究和模型训练
- 市场微观结构分析
- 自定义分析看板
常见 API 问题
付费用户能查询多久以前的数据？Pro 包含完整历史库吗？
付费 Pro 包含过去 15 天的成交，延迟 15 分钟，不包含完整历史库。试用访问规则不变。
15 天是指交易日吗？
指查询执行时往前连续 360 小时，包含周末与节假日。包含最早边界时刻的成交，排除最近 15 分钟的成交。
为什么历史查询没有返回数据？
请检查标的与日期过滤条件。付费查询会排除早于 15 天或不足 15 分钟的成交。跨越边界的查询及聚合只包含范围内的成交。详情见历史 SQL 参考。
什么是美股期权历史数据 API？
OptionData 将 OPRA 来源的美股期权成交存入 ClickHouse，通过 POST /api/historical/sql 用 SELECT 查询，即「美股期权历史数据」。付费可查询过去 15 天，延迟 15 分钟。
可以用 SQL 查询历史期权数据吗？
可以。向 /api/historical/sql 提交受控 ClickHouse SELECT 与 API Key，返回 JSON。付费可查询过去 15 天的成交，延迟 15 分钟。
历史结果包含 Greeks 和隐含波动率吗？
包含。存储的成交行在可用时含 IV 与 Greeks。权利金等部分指标需在 SQL 中派生，存储列与派生列以历史 SQL 文档为准。
这是文件下载 API 吗？
不是。历史 API 是请求式查询，你可以直接查询数仓，而不是维护静态文件。
历史数据是 RAW 还是聚合？
历史 SQL 保存未做 AGGREGATED 合并的原始成交。需要聚合时请在 SQL 中自行 GROUP BY。
美股期权历史数据如何查询
向 https://www.optiondata.io/api/historical/sql 以 form 或 JSON 提交 api_key 与仅 SELECT 的 SQL，即可获取美股期权历史数据。后端为 ClickHouse，返回 JSON 行及 meta/统计信息。
查询 RawOptionTrades（及白名单物化视图）。按 date 分区，尽早过滤 symbol。存储列与派生字段公式见历史 SQL 文档，本页不再复述 schema。
护栏包括仅 SELECT、禁多语句/注释、表白名单与行数/时间上限。试用账户行数更严；付费订阅可在同一 Pro 计划下查询过去 15 天。中文枢纽页：/meigu-qiquan-lishi-shuju-api。
示例：最近可用交易日的 AAPL 权利金最大成交
curl -X POST 'https://www.optiondata.io/api/historical/sql' \
-H 'Content-Type: application/json' \
-d '{
"api_key": "YOUR_API_KEY",
"sql": "SELECT symbol, strike, put_call, size, price, toFloat64(price) * size * 100 AS premium FROM RawOptionTrades WHERE date = (SELECT max(date) FROM RawOptionTrades WHERE symbol = '\''AAPL'\'' AND date >= today() - 7) AND symbol = '\''AAPL'\'' ORDER BY premium DESC LIMIT 25"
}'