API REFERENCE / 期权
Gate 期权买卖档位与深度合并:参数、响应与查询工具
读取一个期权合约的买卖报价深度,并通过 interval 控制价格档位的合并精度。
文档标注免认证 GET固定规格 v4.106.132资料核对:2026-09-10
GET /options/order_book
这条查询解决什么问题
合并后的档位代表一组价位的汇总深度,不能被解释为该价位存在一张同等数量的独立订单。
这是公开数据的读取接口说明。行情、合约与市场状态会变化,字段定义与返回数据应分开核对。
查看官方英文说明
Query options contract order book
Bids will be sorted by price from high to low, while asks sorted reversely
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格;描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
contractquery · 必填 | string | Options contract name |
intervalquery · 可选 | string默认:"0";枚举:0 / 0.1 / 0.01 | Price precision for merged depth. 0 means no merging. If not specified, defaults to 0 |
limitquery · 可选 | integer默认:10;最小:1;最大:50 | Number of depth levels |
with_idquery · 可选 | boolean默认:false | Whether to return depth update ID. This ID increments by 1 each time the depth changes |
在本页组装查询 URL
填写参数后生成一个 GET 地址,只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围,不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义,不是现场 API 响应,也不是行情样本。嵌套结构展开至三层;数组的 [] 表示其中一个元素。
HTTP 200 · Depth query successful
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | object | 未提供字段注释 |
$.id | integer格式:"int64" | Order Book ID. Increases by 1 on every order book change. Set `with_id=true` to include this field in response |
$.current | number格式:"double" | Response data generation timestamp |
$.update | number格式:"double" | Order book changed timestamp |
$.asks | array<object> | Ask Depth |
$.asks[] | object | 未提供字段注释 |
$.asks[].p | string | Price (quote currency) |
$.asks[].s | integer格式:"int64" | Size |
$.bids | array<object> | Bid Depth |
$.bids[] | object | 未提供字段注释 |
$.bids[].p | string | Price (quote currency) |
$.bids[].s | integer格式:"int64" | Size |
来源、版本与使用说明
本站独立整理 Gate 技术资料,不代表 Gate,不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格,固定版本为 v4.106.132。核对时官网文档已为 v4.106.136,后续变更须以官网为准;本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维;页面没有第三方统计脚本,表单参数仅在当前页面内存中处理。