API REFERENCE / 现货
Gate 现货深度快照与价格合并：参数、响应与查询工具
按现货交易对读取买卖报价，并用 interval、limit 和 with_id 控制深度展示及更新编号。
文档标注免认证 GET固定规格 v4.106.132资料核对：2026-09-10
GET /spot/order_book
这条查询解决什么问题
asks 与 bids 的数量采用现货数量口径，不能套用永续合约张数的换算方式。
这是公开数据的读取接口说明。行情、合约与市场状态会变化，字段定义与返回数据应分开核对。
查看官方英文说明
Get market depth information
Market depth buy orders are sorted by price from high to low, sell orders are reversed
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格；描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
currency_pairquery · 必填 | string | Currency pair |
intervalquery · 可选 | string默认："0" | Price precision for merged depth. 0 means no merging. If not specified, defaults to 0 |
limitquery · 可选 | integer默认：10；最小：1 | Number of depth levels |
with_idquery · 可选 | boolean默认：false | Return order book update ID |
在本页组装查询 URL
填写参数后生成一个 GET 地址，只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围，不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义，不是现场 API 响应，也不是行情样本。嵌套结构展开至三层；数组的 [] 表示其中一个元素。
HTTP 200 · Query successful
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | object | 未提供字段注释 |
$.id | integer格式："int64" | Order book ID, which is updated whenever the order book is changed. Valid only when `with_id` is set to `true` |
$.current | integer格式："int64" | The timestamp of the response data being generated (in milliseconds) |
$.update | integer格式："int64" | The timestamp of when the orderbook last changed (in milliseconds) |
$.asks | array<array<string>> | Ask Depth |
$.asks[] | array<string>最少项：2；最多项：2 | Price and Quantity Pair |
$.asks[][] | string | 未提供字段注释 |
$.bids | array<array<string>> | Bid Depth |
$.bids[] | array<string>最少项：2；最多项：2 | Price and Quantity Pair |
$.bids[][] | string | 未提供字段注释 |
来源、版本与使用说明
本站独立整理 Gate 技术资料，不代表 Gate，不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格，固定版本为 v4.106.132。核对时官网文档已为 v4.106.136，后续变更须以官网为准；本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维；页面没有第三方统计脚本，表单参数仅在当前页面内存中处理。