接口文档研读 · 期权

独立教程与工具 · 非 Gate 官方网站

API REFERENCE / 期权

Gate 按标的和到期日筛选期权:参数、响应与查询工具

使用 underlying 与 expiration 查询期权合约列表,建立标的和到期日对应的合约清单。

文档标注免认证 GET固定规格 v4.106.132资料核对:2026-09-10
GET /options/contracts

这条查询解决什么问题

筛选出相同到期日并不意味着各合约条款相同,还应按完整名称和 is_call 等字段辨认具体品种。

这是公开数据的读取接口说明。行情、合约与市场状态会变化,字段定义与返回数据应分开核对。

查看官方英文说明

List all contracts for specified underlying and expiration date

此操作没有额外说明。

请求参数逐项核对

字段名和数据类型保留官方拼写。必填标记来自规格;描述中的条件约束还需要一起检查。

参数与位置类型与范围官方字段说明
underlyingquery · 必填string
Underlying (Obtained by listing underlying endpoint)
expirationquery · 可选integer格式:"int64"
Unix timestamp of expiration date

在本页组装查询 URL

填写参数后生成一个 GET 地址,只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。

query · string
query · integer格式:"int64"
尚未生成 URL。

不会向 Gate 或本站发送表单内容。

工具检查必填、枚举与简单数值范围,不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。

响应字段怎样阅读

以下展示的是规格中的类型定义,不是现场 API 响应,也不是行情样本。嵌套结构展开至三层;数组的 [] 表示其中一个元素。

HTTP 200 · List retrieved successfully

字段路径数据类型字段说明
$array<object>
未提供字段注释
$[]object
Options contract details
$[].namestring
Options contract name
$[].tagstring
Expiry periods include day, week, and month.
$[].create_timenumber格式:"double"
Created time
$[].expiration_timenumber格式:"double"
Expiration time
$[].is_callboolean
`true` means call options, `false` means put options
$[].multiplierstring
The option contract multiplier indicates how many units of the underlying asset the face value of one contract represents.
$[].underlyingstring
Underlying
$[].underlying_pricestring
The forward futures price corresponding to the delivery date
$[].last_pricestring
Last trading price
$[].mark_pricestring
Current mark price (quote currency)
$[].index_pricestring
Current index price (quote currency)
$[].maker_fee_ratestring
Maker fee rate, negative values indicate rebates
$[].taker_fee_ratestring
Taker fee rate
$[].order_price_roundstring
Minimum order price increment
$[].mark_price_roundstring
Minimum mark price increment
$[].order_size_mininteger格式:"int64"
Minimum order quantity
$[].order_size_maxinteger格式:"int64"
Maximum order quantity
$[].order_price_deviatestring
Deprecated
$[].ref_discount_ratestring
Trading fee discount for referred users
$[].ref_rebate_ratestring
Commission rate for referrers
$[].orderbook_idinteger格式:"int64"
Orderbook update ID
$[].trade_idinteger格式:"int64"
Deprecated
$[].trade_sizeinteger格式:"int64"
Historical cumulative trading volume
$[].position_sizeinteger格式:"int64"
Current total long position size
$[].orders_limitinteger
The maximum number of open orders each user can place in this order book.

来源、版本与使用说明

本站独立整理 Gate 技术资料,不代表 Gate,不提供账户、交易、充值或软件下载服务。

参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格,固定版本为 v4.106.132。核对时官网文档已为 v4.106.136,后续变更须以官网为准;本页并未声称对该接口做过在线实测。

中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维;页面没有第三方统计脚本,表单参数仅在当前页面内存中处理。