发布于 2025-01-07 18:54:29 · 阅读量: 71127
CoinEx 是一家知名的加密货币交易所，提供多种数字货币的交易服务。对于开发者和交易者来说，CoinEx API 是一个非常强大的工具，可以实现自动化交易、数据获取、账户管理等功能。本文将详细介绍 CoinEx API 的使用方法，帮助你更高效地利用这个接口。
在开始使用 CoinEx API 之前，你首先需要创建一个 API 密钥。以下是获取 API 密钥的步骤：
CoinEx 提供了基于 RESTful API 的接口，所有的请求都基于 HTTPS 协议，保证了数据的安全性。API 的基础 URL 如下：
https://api.coinex.com/v1/
所有的接口路径都是基于这个基础 URL，后面加上相应的 API 路径。
CoinEx API 支持多种权限设置，包括但不限于：
对于需要身份验证的接口，你需要在请求中携带 API 密钥和签名。
为了保障 API 的安全性，CoinEx 对私密 API 的请求进行了身份认证。你需要通过以下方式进行认证：
HMAC-SHA256 算法对拼接后的字符串进行加密，得到签名。下面是一个生成签名的示例代码（Python）：
import time import hashlib import hmac
def generate_signature(secret_key, params): query_string = '&'.join([f"{key}={value}" for key, value in sorted(params.items())]) message = f"{query_string}&api_key={api_key}&secret_key={secret_key}&nonce={nonce}" return hmac.new(secret_key.encode(), message.encode(), hashlib.sha256).hexdigest()
api_key = "your_api_key" secret_key = "your_secret_key" nonce = str(int(time.time() * 1000)) # 毫秒级时间戳 params = { 'symbol': 'BTCUSDT', 'amount': '0.1' }
signature = generate_signature(secret_key, params) print(f"Signature: {signature}")
获取市场的最新行情数据，不需要身份认证，属于公共 API。
GET /market/ticker
| 参数 | 类型 | 说明 | | ------- | ------ | -------------- | | symbol | string | 交易对名称，例：BTCUSDT |
请求 URL:
https://api.coinex.com/v1/market/ticker?symbol=BTCUSDT
返回数据示例：
json { "code": 0, "data": { "ticker": { "high": 60000, "low": 55000, "last": 58000, "buy": 57900, "sell": 58050, "vol": 1200.0, "amount": 70000000.0 }, "symbol": "BTCUSDT" } }
获取用户账户的余额信息，需要进行身份认证。
GET /balance
无参数，所有请求需要携带 API 密钥和签名。
请求 URL:
https://api.coinex.com/v1/balance
你可以通过 API 自动下单，实现自动化交易。以下是下单接口的使用方法。
POST /order/limit
| 参数 | 类型 | 说明 | | -------- | ------ | -------------- | | symbol | string | 交易对名称 | | price | float | 限价单的价格 | | amount | float | 订单数量 | | side | string | 订单方向：buy 或 sell | | type | string | 订单类型：limit | | trade_type | string | 交易方式：buy_market 或 sell_market |
请求 URL:
https://api.coinex.com/v1/order/limit
请求参数：
json { "symbol": "BTCUSDT", "price": 58000, "amount": 0.1, "side": "buy", "type": "limit", "trade_type": "buy_market" }
在调用 CoinEx API 时，如果发生错误，API 会返回一个包含错误代码和消息的响应。常见的错误代码包括：
返回的错误信息会帮助你快速定位问题并进行修复。
1000。