期权 合约概览 · REST 接口
期权合约详情。获取指定期权合约的详细信息,包括合约类型(看涨或看跌)、行权方式、到期日、行权价、每张合约股数、底层标的代码与主交易所,是理解合约结构并纳入期权策略与组合评估的基础。
GET /v3/reference/options/contracts/{options_ticker}上游时效说明
每日更新
上游历史范围
数据可追溯至 2014 年 6 月 2 日
适用场景
- 合约规格查询、期权链分析、策略开发、组合集成。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
options_ticker | string | Yes | 按期权代码查询合约。关于期权代码的构成,见相关说明。 |
as_of | string | No | 指定该合约查询时点对应的日期,格式 YYYY-MM-DD,默认为当天。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | string | 服务器分配的请求 ID。 |
results | object | 包含指定期权合约所请求的数据。 |
results.additional_underlyings | array[object] | 若某期权合约附带额外的底层标的或交割物,会在此列出。关于哪些情况会造成合约附带额外底层标的,见相关示例。 |
results.cfi | string | 该合约的 6 位 CFI 代码(定义于 ISO 10962)。 |
results.contract_type | string | 合约类型,可为 put、call,极少数情况下为 other。 |
results.correction | integer | 该期权合约的更正序号。 |
results.exercise_style | enum: american, european, bermudan | 该合约的行权方式。关于行权方式的更多说明见相关文档。 |
results.expiration_date | string | 该合约的到期日,格式 YYYY-MM-DD。 |
results.primary_exchange | string | 该合约上市的主交易所 MIC 代码。 |
results.shares_per_contract | number | 该合约每张对应的股数。 |
results.strike_price | number | 该期权合约的行权价。 |
results.ticker | string | 该期权合约的代码。 |
results.underlying_ticker | string | 该期权合约对应的底层标的代码。 |
status | string | 本次请求响应的状态。 |
响应示例
{
"request_id": "603902c0-a5a5-406f-bd08-f030f92418fa",
"results": {
"additional_underlyings": [
{
"amount": 44,
"type": "equity",
"underlying": "VMW"
},
{
"amount": 6.53,
"type": "currency",
"underlying": "USD"
}
],
"cfi": "OCASPS",
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2021-11-19",
"primary_exchange": "BATO",
"shares_per_contract": 100,
"strike_price": 85,
"ticker": "O:AAPL211119C00085000",
"underlying_ticker": "AAPL"
},
"status": "OK"
}原文:Massive 文档 ↗