Gate API 交易对格式错误：一次失败请求与修正对照

先看结论

在 2026 年 9 月 10 日的这组公开接口检查中，currency_pair=BTC-USDT 返回 HTTP 400，错误标签为 INVALID_CURRENCY_PAIR；改成 BTC_USDT 后返回 HTTP 200。这个例子说明，接口识别的是交易对标识，不能把网页上常见的横线写法直接代入请求。

本文只读取公开行情，示例不需要 API Key。观察结果来自本地网络，出口位置没有测量，也没有验证中国大陆连接。

复现错误与修正

分别运行下面两条 GET 命令。-i 会显示响应头，便于同时检查 HTTP 状态和正文。命令中的网址使用引号包围，防止终端把查询参数当成其他操作。公开数据会变化，因此价格数值不应作为复现是否成功的判据。

curl -i --max-time 20 -H 'Accept: application/json' 'https://api.gateio.ws/api/v4/spot/tickers?currency_pair=BTC-USDT'

{
  "label": "INVALID_CURRENCY_PAIR",
  "message": "Invalid currency pair BTC-USDT"
}

curl -i --max-time 20 -H 'Accept: application/json' 'https://api.gateio.ws/api/v4/spot/tickers?currency_pair=BTC_USDT'

这次实际记录了什么

失败请求从 09:04:51.259586 UTC 开始，于 09:04:52.099529 UTC 完成；成功对照从 09:04:50.305411 UTC 开始，于 09:04:51.258970 UTC 完成。成功正文是包含一个对象的 JSON 数组，其中 currency_pair 为 BTC_USDT。开始与结束时间由客户端时钟记录，不能视作服务器内部处理时刻。

本文附有对应的公开响应，便于核对字段和状态。正文没有账户信息；即时价格仅用于确认响应结构，不用于行情判断。

排错时按这一顺序检查

• 先查看 HTTP 状态，再解析 JSON。不能因为正文是 JSON 就把失败响应当成功。
• 确认调用的是 /spot/tickers，且参数名为 currency_pair。不要把其他产品的 symbol 写法直接套用。
• 用官方公开交易对目录核对 id；示例中的 BTC_USDT 不代表任意“币名_USDT”都有效。
• 参数错误、超时、TLS 或 DNS 失败分别处理。网络没有返回正文时，不能自行补成 INVALID_CURRENCY_PAIR。

结论的适用范围

本次只对 BTC_USDT 做了一组对照，没有遍历所有市场，也没有测试大小写容错。可以确认的是这两个准确请求的响应差别；无法从中证明整个接口的所有命名规则，更不能推断某个账户具有交易权限。

当接口后续返回不同结果，应保留新的时间和响应，重新核对当时的官方交易对目录。再次排查时，请记录新的日期与响应。