加密货币兑换API：报价、订单和充值地址

EIDEX Merchant API v1 是一个加密货币兑换 API：在一个集成点下提供报价、订单和充值地址。一次连接即可访问实时定价、完整的订单生命周期管理、充值地址发放、提款和事件 webhook - 所有这些都通过基本 URL https://eidex.io/api/merchant/v1 实现。本参考资料涵盖了 API 中的每个端点、控制每个密钥权限的模型、三步快速入门以及从报价到支付的完整兑换流程的示例。

EIDEX Merchant API v1 是一个加密货币兑换 API，具有单一集成点：实时报价、订单创建和跟踪、充值地址管理、提款和事件 webhook。基本 URL 是https://eidex.io/api/merchant/v1，身份验证使用一对请求头。

最后更新：2026 年 7 月 26 日 · Merchant API v1。如果本页面与规范存在差异，则以机器可读的规范为准。

主要收获

• 14 个端点分为五组：报价、订单、地址、提款、webhooks。
• 三个权限级别每个密钥 - READONLY、TRADING、WITHDRAW - 因此集成只获取其所需。
• 每分钟60个请求每个密钥，在所有端点之间共享，每个响应中都包含限制头。
• 15个区块链网络用于存款；配对列表从 GET /tickers 实时获取，而不是硬编码。
• 无沙盒：开发通过 READONLY 密钥安全地针对实时基本 URL 运行。

加密货币交易平台API的功能

报价

GET /tickers 以一种一致的格式返回可用的交易对，因此您无需自己维护与外部场所的连接。定价和订单执行都通过我们连接的合作交易所运行，这使得API成为报价和结算的单一集成点。相同的费率既用于您的店面，也用于您提交的订单，因此客户看到的价格与交易所成交的价格相符。

订单

完整的交易生命周期：POST /order 创建一个交易所订单（交易对、买入/卖出方向、市价/限价类型），GET /order/{id} 返回其状态，GET /orders 列出订单，POST /order/{id}/cancel 取消订单。您的前端保留其自己的逻辑。

地址、存款和提款

GET /deposit-address?network= 为特定链（需要网络参数）发出接收地址，GET /deposit-addresses 列出已发出的地址。POST /address/reserve 通过其标识符（nonce）将地址锁定到您的请求，POST /address/release 在交易结束后将其返回到池中。GET /balances 报告当前商家余额；POST /withdraw 启动支付。结果以 withdraw.completed webhook 的形式到达--目前没有 REST 方法来轮询提款状态。

Webhooks

GET 和 POST /webhooks 以及 DELETE /webhooks/{id} 管理事件订阅。目前提供两个事件：deposit.confirmed 和 withdraw.completed。订单执行事件 (order.filled) 保留到以后发布，因此目前订单状态通过 GET /order/{id} 轮询。

您的店面和品牌保持不变：API 提供报价、执行订单和处理结算，而您构建面向客户的界面。所有操作都在您的商家账户下运行--API 没有按客户划分的子账户。

加密货币兑换 API 密钥解锁的功能：报价、订单和存款地址

每个密钥都带有一组权限，每个权限都开启了其自己的操作范围。为每个集成提供其所需的最低权限：没有提款权限的密钥无法转出资金，即使它泄露了。

读取访问权限 (READONLY)：

• 每个可用交易对的实时汇率 - GET /tickers
• 每个资产的商家余额，可用和保留 - GET /balances
• 您需要的链上的存款地址 - GET /deposit-address?network=
• 向您发出的每个充值地址 - GET /deposit-addresses
• 带游标分页的订单列表 - GET /orders
• 特定订单的状态 - GET /order/{id}

交易 (TRADING):

• 创建订单：交易对、买入/卖出方向、市价/限价类型 - POST /order
• 取消订单 - POST /order/{id}/cancel

提现 (WITHDRAW):

• 发起向外部地址的提现 - POST /withdraw。适用最低金额和每日限额；结果将作为 withdraw.completed webhook 返回。

地址池和订阅（需要 TRADING 权限；查看订阅列表需要 READONLY）:

• 通过其标识符 (nonce) 将地址锁定到您的请求；使用相同的 nonce 重复调用将返回相同的地址 - POST /address/reserve
• 交易结束后将地址返回到地址池 - POST /address/release
• 创建、列出和删除事件订阅 - POST/GET /webhooks, DELETE /webhooks/{id}

密钥不授予的功能:

• 管理密钥本身 - 密钥的签发和撤销在仪表板中进行，而不是通过 API
• 更改账户设置、运行验证或在 P2P 上交易
• 代表其他用户操作 - 每个调用都在您自己的商家账户下运行

三步快速入门

第 1 步。获取您的密钥。在您的仪表板中签发 X-API-Key 和 X-API-Secret（设置 -> API 密钥）。密钥在创建时显示一次 - 请立即存储。同一屏幕设置密钥权限 (READONLY / TRADING / WITHDRAW) 和可选的允许 IP 地址列表。

第 2 步。请求报价。

curl -X GET "https://eidex.io/api/merchant/v1/tickers" \
  -H "X-API-Key: <your_api_key>" \
  -H "X-API-Secret: <your_api_secret>"

第 3 步。创建订单。POST /order 需要 Idempotency-Key 标头，这可以保护您在重试时免受重复交易的影响。该密钥必须具有 TRADING 权限。

curl -X POST "https://eidex.io/api/merchant/v1/order" \
  -H "X-API-Key: <your_api_key>" \
  -H "X-API-Secret: <your_api_secret>" \
  -H "Idempotency-Key: <unique_request_id>" \
  -H "Content-Type: application/json" \
  -d '{"pair":"BTCUSDT","side":"BUY","type":"MARKET","amount":"0.001"}'

对于限价订单，添加 "type":"LIMIT" 和 "price":"<price>"。有关完整的字段列表和可接受的值，请参阅规范。

从那里，订阅存款和取款网络钩子，并轮询 GET /order/{id} 以获取订单状态。

端点参考

交易所流程如何运作

典型的场外交易归结为对加密货币兑换商 API 的六次调用，您的后端和端点之间的顺序如下：

NaN. 客户选择方向 - 您的店面从 GET /tickers 获取价格。

NaN. 您的后端为请求预留一个地址：POST /address/reserve，带有 network 和 nonce。使用相同的 nonce 重复调用会返回相同的地址，因此重复提交不会中断流程。

NaN. 客户将资金发送到已发行的地址。

NaN. deposit.confirmed 网络钩子到达 - 从那时起，收到的付款被视为已确认。

NaN. 您的后端使用 Idempotency-Key 标头创建订单：POST /order；状态通过 GET /order/{id} 查询。

NaN. 提款通过 POST /withdraw 发起，执行情况由 withdraw.completed webhook 报告。交易结束后，地址通过 POST /address/release 返回池中。

相同的序列涵盖了一次性请求和每小时数十笔交易的流：瓶颈通常是链确认时间而不是 API。

集成场景

交易所网站

经典设置：页面上的计算器，从 GET /tickers 获取汇率，在您自己的 CRM 中跟踪请求。API 涵盖定价、执行和结算，而交易规则、客户验证和支持则由您负责。

Telegram 机器人

没有网站的相同电路：机器人是界面，其后端与相同的端点通信。对话逻辑--配对选择、汇率显示、地址发放、存款通知--依赖于 webhook，因此无需循环查询状态。在此处颁发一个具有 READONLY 和 TRADING 权限的单独密钥很方便，将支付保留在不同的电路上。

白标柜台

店面、品牌和客户群都是您的；结算层在我们这边。该场景运行相同的调用，不同之处仅在于您对界面的定制程度--加密管道在您的品牌背后对最终用户保持不可见。

速率限制和幂等性

每个API密钥每分钟限制60个请求，并由所有端点共享。每个响应都带有X-RateLimit-Limit和X-RateLimit-Remaining头；超出限制将返回429，并带有Retry-After头，其中包含到下一个窗口的秒数。

POST /order和POST /withdraw需要Idempotency-Key头--与IETF Idempotency-Key draft中描述的模式相同，并用于支付API。使用相同的密钥和正文重复请求将返回存储的响应，而不是创建重复项，而使用不同正文的相同密钥将被拒绝。这使得重试对于资金流动是安全的。

每个账户最多支持10个活动的API密钥和5个webhook订阅。错误以单一JSON形式返回--{"code", "message", "request_id"}--引用request_id可以加快支持请求的处理速度。

安全和密钥权限

凭证通过 X-API-Key 和 X-API-Secret 标头传输，绝不会出现在查询字符串或请求正文中，因此它们不会保留在浏览器历史记录和中间代理日志中。密钥永远不会被记录；内部记录只保留一个被屏蔽的密钥前缀。

密钥权限限制了密钥可以执行的操作：READONLY用于读取，TRADING 用于创建和取消订单、预留和释放充值地址以及管理 webhook 订阅，WITHDRAW用于支付。为每个集成提供其所需的最低权限--泄露的没有WITHDRAW权限的密钥无法转移资金。

在颁发密钥时，您可以通过列出CIDR表示法中的地址或子网来配置IP白名单。如果列表为空，则默认情况下密钥可从任何地址接受--对于带有WITHDRAW的密钥，我们建议始终明确设置白名单。

Webhooks已签名：每次调用您的处理程序时，都会带有一个X-Webhook-Signature标头，其中包含一个HMAC-SHA256正文，使用创建时一次性颁发的订阅密钥计算。如果您的端点不可用，将以递增的时间间隔重试交付，最多5次。在处理之前验证签名。

将密钥保留在服务器端；您的前端不应持有它。操作规则和各方的责任在使用条款中规定。

如何连接

加密交易商API的完整规范以机器可读格式发布在eidex.io/merchant-openapi.json，并可直接导入Postman、Insomnia或客户端生成器。最快的路径是快速入门指南：颁发密钥，验证GET /tickers，然后构建您的第一个测试订单。