Gate.io现货APIv4升级公告：多链币种信息整合与查询指南

Gate APIv4 重要升级通知：接口字段优化与链信息整合

各位开发者请注意，Gate.io计划于2025年2月27日下午15:00（UTC+8）对APIv4进行一轮系统升级。这次升级的核心，聚焦于两个关键的现货交易接口：GET /spot/currencies 和 GET /spot/currencies/{currency}。好消息是，升级期间APIv4服务将保持正常运行，不会影响您的正常调用。但升级完成后，接口的返回数据格式将迎来一次意义重大的优化。

大家都在用的虚拟币交易平台推荐：

• OKX（欧易）>>>进入官网<<< >>>官方下载<<<
• Binance（币安）>>>进入官网<<< >>>官方下载<<<

升级后，您能获取什么？

升级完成后，通过上述两个接口，您将能查询到更清晰、更结构化的币种信息。具体来说，可以获取到现货币种的新增名称、其在各条链上的充提状态，以及对应的合约地址等关键数据。这无疑让资产信息的查询变得更加高效和直观。

主要变更内容一览

此次变更主要围绕字段的“新陈代谢”——弃用旧字段，引入更强大的新结构。具体变动有以下三点：

1. 弃用旧字段：接口中原有的 withdraw_disabled、withdraw_delayed、deposit_disabled 这三个字段将被弃用。这意味着，依赖这些字段进行逻辑判断的代码需要提前调整。

2. 新增核心字段：接口将引入一个全新的数组类型字段——chains。这个字段将成为承载多链信息的核心容器。

3. 数据格式重构：接口将直接返回某个币种所支持的所有链及其充提状态等信息。一个重要的变化是，将取消以往那种 <币>_<链>（例如 BTC_BSC）的返回格式，使得数据结构更加纯粹和易于解析。

升级前后返回示例对比（以BTC为例）

俗话说，一图胜千言，一个清晰的代码示例更能说明问题。我们以BTC为例，看看升级前后数据格式的显著变化：

升级前：旧返回示例
结构相对分散，每条链的信息作为一个独立对象返回，且使用了BTC_BSC这样的拼接标识。

{
    “currency”: “BTC”,
    “delisted”: false,
    “withdraw_disabled”: false,
    “withdraw_delayed”: true,
    “deposit_disabled”: false,
    “trade_disabled”: false,
    “chain”: “BTC”
},
{
    “currency”: “BTC_BSC”,
    “delisted”: false,
    “withdraw_disabled”: false,
    “withdraw_delayed”: false,
    “deposit_disabled”: false,
    “trade_disabled”: true,
    “chain”: “BSC”
}

升级后：新返回示例
结构变得高度整合。所有链的信息都被收纳在 chains 这个数组字段下，每条链的充提状态、合约地址一目了然，逻辑层次非常清晰。

{
    “currency”: “BTC”,
    “name”: “Bitcoin”,
    “delisted”: false,
    “withdraw_disabled”: false,
    “withdraw_delayed”: false,
    “deposit_disabled”: false,
    “trade_disabled”: false,
    “chain”: “BTC”,
    “chains”: [
        {
            “name”: “BTC”,
            “addr”: “”,
            “withdraw_disabled”: false,
            “withdraw_delayed”: false,
            “deposit_disabled”: false
        },
        {
            “name”: “BSC”,
            “addr”: “0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c”,
            “withdraw_disabled”: false,
            “withdraw_delayed”: false,
            “deposit_disabled”: false
        }
    ]
}

需要帮助？

如果在升级适配过程中遇到任何疑问或问题，请随时联系我们的24小时在线客服团队。感谢您的理解与支持。Gate.io始终致力于为用户提供安全、快捷、轻松的加密货币交易体验。

Gate.io 团队
2025年2月19日

加密货币之门
安全、快捷、轻松交易超过 3,700 种加密货币

• 访问 Gate 官方网站
• 下载 Gate App / 电脑版
• 关注X (Twitter) 接收福利放送
• 加入 Telegram 社群 讨论热点话题
• 加入全球社区 获取最新资讯
• 查看 100% 储备金证明
• 新用户 立即注册 可享最高 $10,000 迎新礼
• 老用户 邀请 他人注册，可获 40% 用金