• URI: /api/v3/markets/{market_id}/ticker (例如: /api/v3/markets/BTC-USDT/ticker)
• Method: GET
• 参数: market_id (交易对 ID)
• 返回值: 包含最新成交价、成交量等信息的 JSON 对象。

示例代码:

accesskey = "YOURACCESSKEY" # 替换成您的 Access Key secretkey = "YOURSECRETKEY" # 替换成您的 Secret Key baseurl = "https://big.one" marketid = "BTC-USDT" uri = f"/api/v3/markets/{marketid}/ticker" method = "GET" contenttype = "application/" timestamp = str(int(time.time())) content = "" signature = generatesignature(method, uri, contenttype, timestamp, content, secret_key)

headers = { "Content-Type": contenttype, "Authorization": f"Bearer {accesskey}:{signature}", "BIGONE-DATE": timestamp }

url = base_url + uri response = requests.get(url, headers=headers)

if response.statuscode == 200: print(.dumps(response.(), indent=4)) else: print(f"Error: {response.statuscode} - {response.text}")

• URI: /api/v3/orders
• Method: POST
• 参数: JSON 格式的订单信息，包含 market_id (交易对 ID), side (买/卖), type (市价/限价), amount (数量), price (价格，仅限价单需要) 等字段。
• 返回值: 包含订单 ID 等信息的 JSON 对象。

示例代码:

accesskey = "YOURACCESSKEY" # 替换成您的 Access Key secretkey = "YOURSECRETKEY" # 替换成您的 Secret Key baseurl = "https://big.one" uri = "/api/v3/orders" method = "POST" contenttype = "application/" timestamp = str(int(time.time()))

订单信息示例

以下代码展示了一个创建和发送订单的示例，它包含订单所需的关键信息，并演示了如何生成签名以保证请求的安全性。

订单数据 (order_data) 示例：

{
    "market_id": "BTC-USDT",
    "side": "ASK",  
    "type": "LIMIT", 
    "amount": "0.001", 
    "price": "30000"  
}

market_id 指定交易的市场，例如 "BTC-USDT" 表示比特币兑换USDT的市场。 side 指示订单的方向，"ASK" 表示卖出，"BID" 表示买入。 type 定义订单类型，"LIMIT" 为限价单，需要在指定价格成交，"MARKET" 为市价单，会以当前市场最优价格立即成交。 amount 是交易的数量。 price 只有在限价单时有效，表示期望的成交价格。

将订单数据转换为JSON字符串：

content = .dumps(order_data)

使用 .dumps() 方法将Python字典 order_data 转换成 JSON 字符串，便于在HTTP请求中传输。

生成签名 (signature)：

signature = generate_signature(method, uri, content_type, timestamp, content, secret_key)

签名用于验证请求的完整性和身份。 generate_signature 函数（此处未提供具体实现）接收请求方法 ( method )，URI ( uri )，内容类型 ( content_type )，时间戳 ( timestamp )，请求内容 ( content ) 和密钥 ( secret_key ) 作为参数，并生成一个唯一的签名。该签名使用密钥对请求的各个部分进行加密，确保数据在传输过程中未被篡改。

构建请求头 (headers)：

headers = {
    "Content-Type": content_type,
    "Authorization": f"Bearer {access_key}:{signature}",
    "BIGONE-DATE": timestamp
}

请求头包含了 Content-Type (指定内容类型), Authorization (包含认证信息), BIGONE-DATE (请求时间戳)。 Authorization 字段使用 "Bearer" 方案，将 access_key 和 signature 组合在一起进行身份验证。 BIGONE-DATE 包含了时间戳，用于防止重放攻击。

发送 POST 请求：

url = base_url + uri
response = requests.post(url, headers=headers, data=content)

使用 requests.post() 方法发送 POST 请求到指定的 URL。 base_url 是API的基础URL， uri 是请求的具体路径。请求头 ( headers ) 和请求数据 ( data ) 作为参数传递给 post() 方法。

处理响应：

if response.status_code == 201:
    print(.dumps(response.(), indent=4))
else:
    print(f"Error: {response.status_code} - {response.text}")

根据 HTTP 状态码处理响应。如果状态码为 201 (Created)，表示订单创建成功，则将响应内容（通常是订单的详细信息）以格式化的 JSON 形式打印出来。 否则，打印错误信息，包括状态码和响应文本，方便调试。 response.() 方法将响应内容解析为 JSON 格式。 indent=4 参数使JSON输出更易读。

错误处理

在使用 Bigone API 进行交易、数据查询或其他操作时，应用程序可能会遇到各种错误。理解并妥善处理这些错误对于保证程序的稳定性和可靠性至关重要。常见的错误类型包括：

• 400 Bad Request : 此错误表明客户端发送的请求存在问题，例如请求参数缺失、格式错误或取值超出范围。开发者应仔细检查请求的 URL、请求头和请求体，确保所有参数都符合 API 文档的要求。详细的错误信息通常会在响应体中提供，帮助开发者定位具体的问题所在。常见原因包括：
  • 缺少必要的参数。
  • 参数值类型错误（例如，字符串应为数字）。
  • 参数值超出有效范围（例如，数量为负数）。
  • 请求体格式不正确 (例如, JSON格式错误).
• 401 Unauthorized : 此错误表示客户端未提供有效的身份验证凭据，或者提供的凭据无效。这通常意味着 API Key 缺失、无效，或者签名过程存在错误。在使用 API Key 进行身份验证时，请确保 API Key 已正确配置，并且用于生成签名的密钥是正确的。检查时间戳是否在有效期内。要特别注意，如果API Key被禁用，也会返回此错误。建议仔细检查API Key 的状态和权限设置。 常见原因包括：
  • API Key 未设置或设置错误。
  • API Key 对应的权限不足，无法访问请求的资源。
  • 签名算法实现错误，导致服务器验证签名失败。
  • 时间戳过期，导致签名验证失败。 检查服务器与客户端时间是否同步.
• 429 Too Many Requests : 此错误表明客户端在短时间内发送了过多的请求，触发了 API 的速率限制（Rate Limiting）。为了保护服务器资源，Bigone API 对请求频率进行了限制。开发者应合理控制请求频率，避免超出限制。可以实施重试机制，在遇到此错误时稍作等待后重新发送请求。 查看API文档中关于速率限制的说明， 了解具体的限制规则。建议采用指数退避算法进行重试，避免在短时间内再次触发限流。常见解决方案包括：
  • 减少请求频率，例如，减少轮询间隔。
  • 使用批量请求，将多个操作合并到一个请求中。
  • 实施重试机制，在遇到此错误时稍作等待后重新发送请求。
  • 利用 API 提供的速率限制相关Header，如 `X-RateLimit-Remaining` 和 `X-RateLimit-Reset` 来更好地控制请求。
• 500 Internal Server Error : 此错误表明服务器在处理请求时遇到了内部错误。这通常不是客户端的问题，而是服务器端的问题。开发者可以尝试稍后重新发送请求。如果问题持续存在，应联系 Bigone 官方支持团队，提供详细的错误信息，以便他们进行调查和修复。 虽然客户端无法直接解决500错误，但记录详细的请求信息（例如请求URL、请求参数、请求头）可以帮助服务器端快速定位问题。

当应用程序遇到错误时，请务必查看 HTTP 响应状态码以及响应体中的错误信息，这些信息能够帮助你快速定位问题。详细分析错误信息，结合 API 文档，可以确定错误的具体原因并采取相应的解决措施。 强烈建议在程序中添加适当的错误处理机制，例如：

• 重试机制 ：对于临时性错误（例如 429、500），可以尝试在等待一段时间后重新发送请求。
• 日志记录 ：记录所有请求和响应信息，包括错误信息、请求参数、时间戳等，以便进行问题排查和分析。
• 异常处理 ：使用 try-catch 块捕获可能出现的异常，并进行相应的处理。
• 告警系统 ：当出现严重错误时，发送告警通知，以便及时处理。

通过添加上述错误处理机制，可以提高程序的健壮性，减少因错误导致的影响。良好的错误处理是构建可靠应用程序的关键。

注意事项

• API 限流 : Bigone API 为了保证系统稳定性和公平性，对请求频率实施了严格的限制。 请务必仔细研读Bigone官方API文档中关于限流策略的详细说明，包括每个接口的请求频率上限、时间窗口以及超限后的处理方式（通常会返回HTTP 429 Too Many Requests错误）。在程序设计时，务必实施有效的请求频率控制机制，例如使用令牌桶算法或漏桶算法，以避免触发限流，从而影响您的交易策略执行。同时，合理地设置重试机制（例如指数退避），能够在偶发性限流时提高程序的健壮性。
• 数据精度 : 在数字资产交易中，由于涉及到大量的浮点数运算，数据精度至关重要。 Bigone API返回的数据类型通常为字符串或高精度Decimal类型。请务必使用支持高精度计算的数据类型（例如Java中的BigDecimal，Python中的decimal模块）来处理金额、价格和数量等数据，避免使用float或double等可能导致精度丢失的类型。在进行任何计算之前，仔细检查数据的精度，并进行必要的舍入或截断操作，确保符合Bigone交易所要求的最小交易单位和价格精度，防止因精度问题导致的交易失败或意外损失。
• 安全 : API Key 是访问 Bigone API 的身份凭证，具有极高的敏感性。 请务必将其视为最高机密，严禁泄露给任何第三方。不要将 API Key 存储在不安全的地方，例如版本控制系统、日志文件、电子邮件或公共论坛。 建议使用安全的密钥管理方案，例如使用环境变量、配置文件加密、或专门的密钥管理服务（如HashiCorp Vault）来存储 API Key。同时，定期轮换 API Key，以降低密钥泄露带来的风险。 启用 Bigone 提供的双因素认证（2FA）功能，可以进一步增强账户的安全性。
• 文档 : Bigone 官方 API 文档是使用 API 的最重要参考资料。 在开始开发之前，请务必仔细阅读文档，全面了解各个接口的功能、参数、返回值、错误码以及使用示例。特别是要关注API的更新和变更，因为交易所会定期更新API以改进功能或修复漏洞。 通过订阅 Bigone 的官方公告或开发者邮件列表，可以及时获取API更新的信息。 务必根据最新的文档规范进行开发，确保您的程序能够正确地与 Bigone 交易所进行交互。 同时，利用API文档提供的测试环境（如果有），在正式部署之前进行充分的测试，可以减少潜在的错误。