Gate 按市场查询永续风险限额档位:参数、响应与查询工具
查询指定永续合约的风险限额档位,或在未指定合约时分页查看多个市场。
GET /futures/{settle}/risk_limit_tiers这条查询解决什么问题
未传 contract 时的 limit、offset 控制市场数量与偏移,而不是返回档位数组的条数。
这是公开数据的读取接口说明。行情、合约与市场状态会变化,字段定义与返回数据应分开核对。
查看官方英文说明
Query risk limit tiers
When the 'contract' parameter is not passed, the default is to query the risk limits for the top 100 markets. 'Limit' and 'offset' correspond to pagination queries at the market level, not to the length of the returned array. This only takes effect when the contract parameter is empty.
请求参数逐项核对
字段名和数据类型保留官方拼写。必填标记来自规格;描述中的条件约束还需要一起检查。
| 参数与位置 | 类型与范围 | 官方字段说明 |
|---|---|---|
settlepath · 必填 | string枚举:btc / usdt / usd1 | Perpetual futures settlement currency |
contractquery · 可选 | string | Futures contract, return related data only if specified |
limitquery · 可选 | integer默认:100;最小:1;最大:1000 | Maximum number of records returned in a single list |
offsetquery · 可选 | integer默认:0;最小:0 | List offset, starting from 0 |
在本页组装查询 URL
填写参数后生成一个 GET 地址,只在浏览器本地处理。留空的可选项不会发送。请勿填写密码、API Key 或 Secret。
尚未生成 URL。
不会向 Gate 或本站发送表单内容。
工具检查必填、枚举与简单数值范围,不代替服务端校验。复合参数、时间窗口、条件必填等请对照上方原文。
响应字段怎样阅读
以下展示的是规格中的类型定义,不是现场 API 响应,也不是行情样本。嵌套结构展开至三层;数组的 [] 表示其中一个元素。
HTTP 200 · Query successful
| 字段路径 | 数据类型 | 字段说明 |
|---|---|---|
$ | array<object> | 未提供字段注释 |
$[] | object | Retrieve risk limit configurations for different tiers under a specified contract |
$[].tier | integer格式:"int" | Tier |
$[].risk_limit | string | Position risk limit |
$[].initial_rate | string | Initial margin rate |
$[].maintenance_rate | string | The maintenance margin rate of the first tier of risk limit sheet |
$[].leverage_max | string | Maximum leverage |
$[].contract | string | Market, only visible when market pagination is requested |
$[].deduction | string | Maintenance margin quick calculation deduction amount |
来源、版本与使用说明
本站独立整理 Gate 技术资料,不代表 Gate,不提供账户、交易、充值或软件下载服务。
参数和字段改编自 Gate 官方 SDK 的 Apache 2.0 开放规格,固定版本为 v4.106.132。核对时官网文档已为 v4.106.136,后续变更须以官网为准;本页并未声称对该接口做过在线实测。
中文用途解释、字段阅读界面和本地 URL 组装器由本站整理。访问日志用于站点运维;页面没有第三方统计脚本,表单参数仅在当前页面内存中处理。