Bitget API法币交易：自动化桥梁搭建指南

时间：2025-02-19 08:11:11 阅读：92

Bitget API 法币交易：构建自动化交易桥梁

Bitget作为一家领先的加密货币交易所，为开发者提供了强大的API接口，以便进行各种交易操作，包括法币交易（Fiat-to-Crypto，简称OTC）。通过API，用户可以构建自动化交易系统，实现更高效、更便捷的法币交易流程。本文将深入探讨如何利用Bitget API进行法币交易，涵盖关键接口、参数设置以及潜在的注意事项。

理解Bitget API 法币交易框架

Bitget API的法币交易模块为开发者提供了程序化访问场外交易(OTC)市场的强大工具。通过一系列精心设计的API端点，用户可以自动化执行法币交易的各个环节，极大地提升了交易效率和灵活性。该模块涵盖了从信息收集到交易执行，再到争议解决的完整流程。核心功能如下：

获取广告列表： 此功能允许用户检索Bitget平台上所有可用的法币交易广告。通过API请求，可以获取详细的广告信息，包括但不限于：
- 广告发布者信息： 卖家或买家的身份标识。
- 交易方向： 指定广告是用于购买还是出售加密货币。
- 加密货币类型： 明确交易涉及的加密货币种类，例如USDT、BTC等。
- 法币类型： 指定用于交易的法定货币，例如USD、CNY等。
- 单价： 每单位加密货币的法币价格。
- 最小/最大交易限额： 规定单笔交易允许的最小和最大金额。
- 支付方式： 支持的支付渠道，如银行转账、支付宝、微信支付等。
- 广告创建时间： 展示广告的新旧程度，辅助判断广告的有效性。
利用这些信息，用户可以筛选出符合自身需求的交易对手，为后续的订单创建奠定基础。
创建订单： 在获取广告列表后，用户可以选择合适的广告并创建订单。创建订单时，需要指定：
- 广告ID： 明确指定要交易的广告。
- 交易数量： 指定购买或出售的加密货币数量。
- 交易方向： 与广告一致的交易方向（买入或卖出）。
API将根据这些参数生成订单，并进入待处理状态。
取消订单： 在订单未完全成交之前，用户可以随时取消订单。取消订单操作释放锁定的资金或加密货币，并允许用户重新选择交易策略。此功能提供了灵活的风险管理手段。
订单状态查询： 此功能允许用户实时监控订单的状态。通过订单ID，可以查询订单的详细信息，包括：
- 订单状态： 例如，待支付、已支付、待放币、已放币、已取消、申诉中等。
- 订单创建时间： 记录订单的创建时间。
- 订单成交数量： 显示已成交的加密货币数量。
- 订单剩余数量： 显示未成交的加密货币数量。
- 支付信息： 显示买家支付的相关信息，方便卖家核实。
订单状态查询是确保交易顺利进行的关键环节。
申诉： 如果在交易过程中出现任何争议，例如买家未按时支付、卖家未按时放币等，用户可以提交申诉。Bitget平台将介入并根据提供的证据进行仲裁，以保障交易的公平性。申诉过程需要提供详细的交易信息和相关证据。
确认放币： 作为卖家，在确认收到买家的付款后，需要通过API调用确认放币操作。此操作将把加密货币从卖家的账户转移到买家的账户，完成交易。确认放币是法币交易流程中的重要一步，必须谨慎操作。

为了充分利用Bitget API的法币交易模块，开发者需要深入理解各个API接口的规范，包括请求方法（如GET、POST）、请求参数、认证方式以及返回数据的JSON格式。同时，需要关注Bitget官方API文档的更新，以便及时调整代码并适应平台的变化。开发者还需注意API的使用频率限制，避免因频繁请求而被限制访问。

API接口详解及参数设置

以下将详细介绍几个关键的Bitget API法币交易接口，并深入探讨其参数设置，助力开发者更高效地集成交易功能。

我们将重点关注订单创建、订单查询和订单取消等核心接口，详细解释每个接口所需的请求参数、参数类型、取值范围以及返回值的含义，确保开发者能够准确理解并正确使用这些接口。

对于订单创建接口，我们将详细说明如何设置交易方向（买入或卖出）、交易数量、价格类型（市价或限价）以及其他高级选项，例如止盈止损价格等。还将介绍如何处理不同的错误代码，以便开发者能够及时发现并解决问题。

订单查询接口方面，我们将探讨如何使用订单ID、交易对或其他筛选条件来检索特定订单的信息。返回的数据将包括订单状态、成交价格、手续费等关键信息，帮助开发者实时监控订单执行情况。

订单取消接口的介绍将涵盖如何安全、高效地取消未成交的订单，以及在不同网络环境下可能遇到的问题和解决方案。我们将强调在取消订单前进行状态验证的重要性，避免不必要的错误。

我们还将提供代码示例，演示如何在不同的编程语言中使用这些API接口，并分享一些实用的开发技巧，例如如何处理API请求频率限制、如何使用API密钥进行身份验证等。

通过本指南，开发者将能够全面了解Bitget API法币交易接口的功能和用法，并能够快速构建自己的交易应用程序。

1. 获取广告列表 (GET /api/otc/v1/public/ads)

该接口允许开发者获取当前数字货币交易平台上可用的法币交易广告列表。这些广告由平台用户发布，用于买卖特定数字货币。

功能描述: 提供法币交易市场上所有可用的广告信息，包括广告价格、限额、支付方式等。
请求方法: GET
接口地址: /api/otc/v1/public/ads
请求参数: 可选参数用于过滤和排序广告列表，提高数据检索效率。常见的参数包括：
- currency : 指定法币类型，例如 USD、CNY。不指定则返回所有法币的广告。
- asset : 指定数字货币类型，例如 BTC、ETH。必须指定。
- tradeType : 指定交易类型，"buy" 表示购买数字货币，"sell" 表示出售数字货币。必须指定。
- page : 指定页码，用于分页显示广告列表。
- pageSize : 指定每页显示的广告数量。
- paymentMethod : 指定支付方式，例如 Alipay, WechatPay, BankTransfer。不指定则返回所有支付方式的广告。
- minAmount : 筛选出交易金额大于等于该值的广告。
- maxAmount : 筛选出交易金额小于等于该值的广告。
- sort : 指定排序方式，例如 "priceAsc" (按价格升序) 或 "priceDesc" (按价格降序)。
响应参数: 接口返回JSON格式的数据，包含广告列表以及分页信息。
- code : 状态码，表示请求是否成功。
- message : 状态信息，提供关于请求结果的描述。
- data : 包含广告列表的数组。每个广告对象包含以下字段：
  - id : 广告ID。
  - price : 广告价格。
  - minAmount : 最小交易金额。
  - maxAmount : 最大交易金额。
  - paymentMethods : 支持的支付方式列表。
  - advertiser : 广告发布者的信息，例如用户名、认证状态。
  - asset : 数字货币类型。
  - currency : 法币类型。
  - tradeType : 交易类型 (buy/sell)。
  - premium : 溢价比例。
- total : 符合条件的广告总数。
- page : 当前页码。
- pageSize : 每页显示的广告数量。
注意事项:
- 调用此接口不需要身份验证，属于公共接口。
- 请合理设置请求参数，避免一次性请求过多数据，影响服务器性能。
- 频繁请求可能触发频率限制，请控制请求频率。

请求参数:

currency : 法定货币类型，用于指定交易使用的法币。例如，"CNY"（人民币）、"USD"（美元）、"EUR"（欧元）等。这是**必填**参数，用于筛选指定法币的交易广告。
coin : 加密货币类型，用于指定交易的加密数字资产。例如，"USDT"（泰达币）、"BTC"（比特币）、"ETH"（以太坊）等。此参数**必须**提供，以确定交易的数字货币类型。
side : 交易方向，指示是购买还是出售加密货币。"buy" 表示买入加密货币，"sell" 表示卖出加密货币。这是一个**强制性**参数，决定了交易行为。
paymentMethod : 支付方式，用户偏好的支付渠道。例如，"Alipay"（支付宝）、"WeChat Pay"（微信支付）、"Bank Transfer"（银行转账）、"Credit Card"（信用卡）等。这是一个**可选**参数，允许用户根据支付习惯筛选广告。如果未指定，则返回所有支持的支付方式的广告。
amount : 法币金额，以法币计价的金额数值。用于筛选出在该金额范围内的广告，帮助用户快速找到符合其预算的交易。这是一个**可选**参数，如果提供，系统将筛选出接近该金额的广告。
page : 页码，用于分页显示结果。从1开始计数，表示要显示的页数。这是一个**可选**参数，默认为1，即显示第一页的结果。与 `limit` 参数结合使用，可以浏览大量广告信息。
limit : 每页返回的广告数量，用于控制每页显示的广告条目数。这是一个**可选**参数，默认为20，最大值为100。用户可以根据自己的需要调整此参数，以便更好地浏览广告。较大的值可以减少翻页次数，较小的值则更方便快速浏览。

返回值:

返回一个包含广告信息的JSON数组，数组中的每个元素代表一个广告，并包含以下关键字段，用于描述广告的详细信息：
- id : 广告ID，唯一标识符，类型为整数，用于区分不同的广告条目。
- price : 单价，表示购买或出售该资产的单价，通常以法币或其他加密货币计价，数据类型为浮点数，精确到小数点后若干位，例如：8.23 USDT。
- minAmount : 最小交易金额，允许的最小交易金额，以法币或其他加密货币表示，类型为浮点数，用于限制小额交易。
- maxAmount : 最大交易金额，允许的最大交易金额，以法币或其他加密货币表示，类型为浮点数，用于限制大额交易。
- paymentMethods : 支持的支付方式列表，一个字符串数组，包含广告发布者接受的支付方式，例如：["支付宝", "微信支付", "银行转账"]。数组中每个元素均为支付方式的名称。
- advertiserUid : 广告发布者UID，发布该广告的用户的唯一ID，类型为字符串或整数，用于追踪广告来源。
- advertiserNickname : 广告发布者昵称，发布该广告的用户的昵称，类型为字符串，用于在用户界面上显示广告发布者的信息。
- asset : 资产类型，表示交易的加密货币类型，例如："BTC"、"ETH"等，类型为字符串。
- fiat : 法币类型，表示交易使用的法币类型，例如："CNY"、"USD"等，类型为字符串。
- tradeType : 交易类型，表示是买入还是卖出，值为 "BUY" 或 "SELL" 的字符串。
- premiumRate : 溢价率，相对于市场价格的溢价百分比，类型为浮点数。
- priceType : 价格类型，指示价格是固定的还是浮动的，类型为字符串，例如："FIXED" 或 "FLOAT"。

示例:

GET /api/otc/v1/public/ads?currency=CNY&coin=USDT&side=buy&paymentMethod=Alipay

此请求旨在从OTC（场外交易）市场获取广告列表。该API端点允许用户根据特定条件筛选广告，从而找到符合其需求的交易对手方。此示例请求的功能是：

货币 (currency): 指定为 CNY ，表示用户希望以人民币进行交易。这限定了返回的广告列表中，所有交易都以人民币计价。
数字货币 (coin): 指定为 USDT ，表示用户希望交易的数字资产为泰达币（USDT）。这意味着返回的广告列表将只包含买卖USDT的广告。
交易方向 (side): 指定为 buy ，表示用户希望购买USDT。因此，API将返回所有出售USDT的广告，即广告方希望卖出USDT，而用户作为买方希望买入。
支付方式 (paymentMethod): 指定为 Alipay ，表示用户希望使用支付宝作为支付方式完成交易。API将返回所有支持支付宝支付的广告。

综上所述，这个API请求将返回一个广告列表，其中包含所有满足以下条件的广告：使用支付宝以人民币购买USDT的广告。这些信息对于希望通过OTC市场使用支付宝以人民币购买USDT的用户至关重要，能够帮助他们快速定位到合适的交易对手方。

2. 创建订单 ( `POST /api/otc/v1/order/create` )

此接口允许用户在平台上创建新的法币交易订单。通过此接口，用户可以指定购买或出售加密货币的意图，并设置相关参数，例如交易数量、价格以及期望的支付方式。

请求方法: POST
接口描述: 用于提交创建法币交易订单的请求。
请求URL: /api/otc/v1/order/create
请求参数: （以下仅为示例，实际参数请参考接口文档）
- crypto_currency : (String, 必填) 要交易的加密货币类型，例如 "BTC"、"ETH"。
- fiat_currency : (String, 必填) 法币类型，例如 "CNY"、"USD"。
- amount : (Number, 必填) 交易的加密货币数量。
- price : (Number, 必填) 交易单价，用法币计价。
- type : (String, 必填) 订单类型，"buy" 表示购买，"sell" 表示出售。
- payment_method : (String, 必填) 支付方式，例如 "支付宝"、"银行转账"。
- trade_partner_id : (String, 可选) 指定交易对手的ID，如果为空则自动匹配。
- remark : (String, 可选) 订单备注信息。
请求体格式: application/
响应格式: application/

响应示例:

        
        {
            "code": 200,
            "message": "订单创建成功",
            "data": {
                "order_id": "1234567890",
                "status": "pending"
            }
        }

错误码说明: （以下仅为示例，实际错误码请参考接口文档）
- 400 : 请求参数错误。
- 401 : 未授权访问。
- 403 : 权限不足。
- 404 : 资源不存在。
- 500 : 服务器内部错误。
- 1001 : 可用余额不足。
- 1002 : 交易数量超出限制。
注意事项:
- 请确保提供的参数符合数据类型和格式要求。
- 在创建订单之前，请仔细核对订单信息，确保准确无误。
- 部分支付方式可能需要进行身份验证或绑定。

请求参数:

adId : 广告ID (必须)。这是唯一标识特定广告的字符串。你需要提供有效的广告ID才能成功提交订单。请确保广告仍然有效且未过期。
amount : 交易金额 (必须)。这代表你想要支付的法币金额，或者想要出售的加密货币数量，具体取决于交易方向。精度取决于交易的加密货币，请确保金额满足广告方设置的最小和最大交易额限制。
side : 交易方向 (必须)。指定交易类型，可以是 "buy" (买入) 或 "sell" (卖出)。务必与广告的交易方向保持一致。如果广告是出售加密货币，则你应该选择 "buy"；如果广告是购买加密货币，则你应该选择 "sell"。大小写敏感，推荐使用小写。
paymentMethod : 支付方式 (必须)。指定用于完成交易的支付方式。该支付方式必须是广告发布者所支持的支付方式之一。请检查广告详情，确认可接受的支付方式列表。支付方式名称需要准确匹配。
paymentAccountId : 支付账户ID (可选)。如果需要使用特定的支付账户进行支付，则提供此参数。如果未提供，系统可能会使用默认的支付账户，或者提示你选择一个可用的支付账户。此ID与你在平台绑定的支付账户相关联。

返回值:

API调用成功后，服务器将返回一个JSON对象，该对象包含了新创建订单的详细信息。开发者可以通过解析此JSON对象来获取订单的关键属性，例如：
- 订单ID (Order ID): 这是唯一标识该订单的数字或字符串，可用于后续的订单状态查询、修改或取消操作。它是进行后续订单管理的基础。
- 订单创建时间 (Creation Timestamp): 订单创建的具体时间，通常以UTC时间戳格式表示，方便开发者进行时间相关的计算和处理。
- 订单状态 (Order Status): 订单当前的执行状态，例如"待处理"、"已确认"、"已发货"、"已完成"或"已取消"等。不同的状态值代表订单处理流程的不同阶段。
- 订单总金额 (Total Amount): 订单包含的所有商品或服务的总价格，可能包含税费、运费等额外费用。
- 支付方式 (Payment Method): 用户选择的支付方式，例如信用卡、借记卡、PayPal或其他加密货币支付方式。
- 商品列表 (Item List): 一个数组或列表，包含订单中所有商品的详细信息，例如商品名称、数量、单价等。
- 收货地址 (Shipping Address): 用户提供的收货地址信息，包括收件人姓名、电话号码、国家、省份、城市、详细地址和邮政编码。
- 其他信息 (Additional Information): 可能包含其他与订单相关的附加信息，例如用户备注、优惠券代码、推荐人ID等。
请注意，具体的JSON结构和字段名称可能会因不同的API设计而有所差异，开发者应仔细查阅API文档，了解返回值的具体格式和含义，以便正确解析和使用订单信息。建议使用专门的JSON解析库来处理返回值，以避免手动解析可能出现的错误。

示例: 创建OTC订单

以下展示了如何使用POST请求向 /api/otc/v1/order/create 端点提交数据，以创建一个场外交易(OTC)订单。该请求需要提供订单相关的详细信息，例如广告ID、交易金额、买卖方向以及支付方式等。


POST /api/otc/v1/order/create
Content-Type: application/

{
    "adId": "1234567890",
    "amount": 1000,
    "side": "buy",
    "paymentMethod": "Alipay"
}

上述示例中， adId 字段指定了要购买的广告的唯一标识符，其值为 "1234567890"。 amount 字段表示希望购买的金额，单位为人民币，这里设置为 1000。 side 字段表明交易方向，"buy" 代表购买，与之对应的是 "sell" 代表出售。 paymentMethod 字段则指定了支付方式，本例中使用的是支付宝 "Alipay"。请注意，Content-Type 需要设置为 application/，表明请求体是 JSON 格式的数据。服务端将会根据这些参数创建一个新的购买订单。

3. 取消订单 ( `POST /api/otc/v1/order/order/cancel` )

该接口允许用户取消尚未完全成交的订单。当用户希望停止交易，或者发现订单参数设置有误时，可以使用此接口。

请求方法: POST
接口描述: 用于撤销指定ID的OTC订单请求。
鉴权: 需要有效的API Key和Secret Key进行身份验证，确保只有授权用户才能操作。
请求URL: /api/otc/v1/order/cancel
请求参数:
请求体应包含以下JSON格式的参数：
- orderId (String): 必填参数，需要取消的订单的唯一标识符。从创建订单的响应或订单列表中获取。

请求示例:

        
        {
          "orderId": "your_order_id_here"
        }

响应示例:

成功取消订单:

        
        {
          "code": 200,
          "message": "Order cancellation successful",
          "data": {
            "orderId": "your_order_id_here",
            "status": "cancelled"
          }
        }

取消订单失败 (例如，订单已成交或不存在):

        
        {
          "code": 400,
          "message": "Order cannot be cancelled",
          "data": null
        }

响应参数:
- code (Integer): 状态码，200表示成功，其他值表示错误。
- message (String): 描述操作结果的消息。
- data (Object): 包含返回的数据。成功时，包含已取消的订单ID和状态。失败时，可能为null。
错误码:
- 400 : 请求参数错误，例如缺少 orderId 。
- 404 : 订单不存在。
- 409 : 订单状态不允许取消，例如已成交或已取消。
- 500 : 服务器内部错误。
注意事项:
- 已成交的订单无法取消。
- 频繁取消订单可能会受到限制。
- 请务必检查 orderId 的正确性。

请求参数:

orderId : 订单ID (必须)。这是用于唯一标识特定订单的字符串。请确保提供有效的订单ID，以便系统能够准确检索和处理相关订单信息。订单ID通常由字母、数字或特殊字符组成，具体格式取决于系统实现。

返回值:

操作成功时，服务器将返回一个包含操作结果的JSON对象。该JSON对象通常包含以下关键字段：
- status : 用于指示操作的状态，通常为整数或字符串类型。例如， 200 可能表示成功，而 400 或 500 可能表示错误。具体的数值或字符串含义需要参考API文档。
- message : 包含对操作状态的描述性消息，有助于理解操作结果。例如，"交易已成功提交"或"参数无效"。
- data : 包含实际的返回数据，其结构和内容取决于具体的API端点。例如，可能包含交易哈希、账户余额、或其他相关信息。如果操作没有返回任何数据，该字段可能为空或null。
- error (可选): 如果操作失败，该字段可能包含错误的详细信息，例如错误代码、错误消息以及导致错误的具体原因。
- timestamp (可选): 返回结果的时间戳，通常以Unix时间戳或ISO 8601格式表示。
以下是一个成功返回JSON对象的示例：
```
    {
      "status": 200,
      "message": "交易已成功提交",
      "data": {
        "transactionHash": "0xabcdef123456...",
        "blockNumber": 1234567
      },
      "timestamp": 1678886400
    }
    
```
以下是一个错误返回JSON对象的示例：
```
    {
      "status": 400,
      "message": "参数无效",
      "error": {
        "code": "INVALID_PARAMETER",
        "message": "金额必须大于0"
      },
      "timestamp": 1678886400
    }
    
```

示例: OTC 订单取消 API 请求

使用 HTTP POST 方法向 /api/otc/v1/order/cancel 端点发送请求，可以取消指定的 OTC 订单。请求体应包含一个 JSON 对象，其中包含要取消的订单的唯一标识符。

请求方法: POST

请求 URL: /api/otc/v1/order/cancel

请求体 (JSON 格式):


{
    "orderId": "abcdefg12345"
}

参数说明:

orderId : 字符串类型，必填。需要取消的 OTC 订单的唯一标识符。请确保此 ID 的准确性，否则可能导致取消错误的订单。

注意事项:

请确保你的 API 密钥具有取消 OTC 订单的权限。
订单取消操作是不可逆的，请谨慎操作。
如果订单已经完成或正在处理中，可能无法取消。请参考具体的 API 错误码和描述来了解取消失败的原因。

4. 订单状态查询 (GET /api/otc/v1/order/detail)

此接口允许用户通过订单ID检索特定订单的详细信息及其当前状态。它提供交易的全面视图，包括订单创建时间、交易对手信息、交易金额、已执行数量、交易状态等。

请求方法: GET
接口描述: 用于查询指定订单ID的OTC交易订单详情。
请求URL: /api/otc/v1/order/detail
请求参数:
- orderId (String, 必选): 要查询的订单ID。这是用于唯一标识OTC订单的字符串。
响应参数:
- orderId (String): 订单ID。
- status (String): 订单状态。可能的值包括： PENDING (待处理)、 PROCESSING (处理中)、 COMPLETED (已完成)、 CANCELLED (已取消)、 FAILED (失败)。
- amount (Number): 订单总金额。
- price (Number): 订单单价。
- currency (String): 交易货币类型，例如：USDT, BTC。
- createTime (String): 订单创建时间，采用ISO 8601格式。
- updateTime (String): 订单最后更新时间，采用ISO 8601格式。
- type (String): 订单类型，例如：BUY（购买），SELL（出售）。
- userId (String): 下单用户ID。
- counterpartyUserId (String): 交易对手用户ID。
- executedAmount (Number): 已成交金额。
- fee (Number): 交易手续费。
- errorMessage (String): 错误信息，仅在订单失败时存在。

响应示例 (成功):

        
        {
            "orderId": "1234567890",
            "status": "COMPLETED",
            "amount": 1000,
            "price": 10,
            "currency": "USDT",
            "createTime": "2023-10-27T10:00:00Z",
            "updateTime": "2023-10-27T10:30:00Z",
            "type": "BUY",
            "userId": "user123",
            "counterpartyUserId": "user456",
            "executedAmount": 1000,
            "fee": 0.5,
            "errorMessage": null
        }

响应示例 (失败 - 订单不存在):

        
        {
            "code": "ORDER_NOT_FOUND",
            "message": "Order with ID 1234567890 not found"
        }

错误代码:
- ORDER_NOT_FOUND : 指定的订单ID不存在。
- INVALID_ORDER_ID : 订单ID格式不正确。
- INTERNAL_SERVER_ERROR : 服务器内部错误。

请求参数:

orderId : 订单ID (必须)。用于唯一标识交易订单，是进行订单查询、取消等操作的关键参数。请确保提供准确的订单ID，否则可能导致请求失败。订单ID通常由系统在创建订单时生成，并返回给客户端保存。

返回值:

返回一个JSON对象，该对象包含订单的详细信息。这些信息涵盖了订单生命周期的各个方面，便于用户理解订单状态和交易过程。
- 订单状态： 订单状态是反映订单当前所处阶段的关键指标，可能包括以下几种状态：
  - pending : 待支付。表示订单已创建，但买家尚未完成支付。在此状态下，买家需要尽快完成支付，以推进交易流程。
  - paid : 已支付，等待卖家放币。表示买家已成功支付，系统正在等待卖家确认收款并释放相应的加密货币。这是交易流程中的一个重要环节，需要卖家及时处理。
  - released : 已放币，交易完成。表示卖家已成功释放加密货币给买家，交易顺利完成。买家现在可以自由支配所购买的加密货币。
  - cancelled : 已取消。表示订单由于某种原因被取消，可能是买家主动取消，也可能是由于超时未支付等原因被系统自动取消。
  - appealing : 申诉中。表示订单存在争议，买家或卖家已发起申诉，平台正在介入处理。在申诉期间，平台将调查情况并做出裁决，以保障交易公平。
- 交易金额： 指订单涉及的法币金额，例如人民币、美元等。该金额是买家需要支付的实际金额。
- 加密货币数量： 指订单涉及的加密货币数量，例如比特币、以太坊等。该数量是买家将收到的加密货币数量。
- 支付方式： 指买家选择的支付方式，例如银行转账、支付宝、微信支付等。不同的支付方式可能会影响交易速度和手续费。
- 订单创建时间： 指订单生成的具体时间，通常以时间戳或日期时间格式表示。
- 订单过期时间： 指订单失效的时间，若买家在此时间之前未完成支付，订单将被自动取消。
- 卖家信息： 包含卖家的ID或用户名，便于买家了解交易对手方。
- 买家信息： 包含买家的ID或用户名，便于卖家核实交易对象。
- 其他信息： 可能包含其他与订单相关的附加信息，例如订单备注、优惠券使用情况等。

5. 确认放币 ( `POST /api/otc/v1/order/release` )

此接口专为卖家设计，用于在确认已收到买家支付的款项后，安全地将相应的加密货币释放给买家。正确使用此接口是完成OTC交易的关键步骤，务必谨慎操作。

请求方法: POST
接口描述: 卖家确认收款后，放行数字货币给买家
请求URL: /api/otc/v1/order/release
鉴权方式: 需要有效的API Key和Secret Key进行签名认证，确保请求的合法性和安全性。
请求参数: 务必包含订单ID等关键信息，具体参数字段及其数据类型请参考API文档中的详细说明。
请求示例: 请参考API文档中的具体示例，以便正确构造请求。
响应参数: 接口会返回交易结果，通常包含成功或失败的状态码以及相关信息。请根据状态码判断放币操作是否成功。
响应示例: 请参考API文档中的具体示例，以便正确解析响应结果。
注意事项: 在调用此接口前，请务必仔细核对收款信息，确保已收到买家的足额付款。一旦放币，操作不可逆，请谨慎操作。同时，关注平台风控规则，避免触发异常交易。

请求参数:

orderId : 订单ID (必须)。用于唯一标识用户发起的交易请求。此参数是字符串类型，长度应符合系统规范，通常由数字和字母组成，用于精确检索和匹配服务器端的订单记录。

返回值:

返回一个JSON对象，该对象详细描述了操作的执行结果。此JSON对象通常包含以下关键字段，以提供全面的操作状态信息：
- 状态码 (Status Code): 一个数值代码，指示操作是否成功完成。例如，'200' 可能表示成功，而 '400' 或 '500' 可能表示错误。
- 消息 (Message): 一段人类可读的文本，解释操作的结果。成功时，它可能确认操作完成；失败时，它会提供错误的具体描述，帮助用户诊断问题。
- 数据 (Data): 根据操作的性质，可能包含实际的返回数据。例如，如果操作是检索数据，则此字段将包含检索到的数据；如果操作是创建新资源，则此字段可能包含新资源的ID或其他相关信息。如果操作不返回任何数据，此字段可能为空或null。
- 错误代码 (Error Code): 当操作失败时，一个特定的错误代码，用于更精确地标识错误类型。这对于程序化错误处理非常有用。
- 错误详情 (Error Details): 当操作失败时，提供关于错误的更详细信息，例如堆栈跟踪或内部错误消息。这对于调试非常有用。
根据API的设计，JSON对象可能包含上述字段的任意组合，或者包含其他自定义字段，以提供更丰富的信息。客户端应用程序应能够解析此JSON对象，并根据其内容采取适当的行动，例如显示成功消息、处理错误情况或显示返回的数据。

身份验证：

所有需要用户身份验证的API请求，都必须在HTTP请求头部（Header）中包含 X-API-KEY 和 X-API-SIGN 两个关键字段。

X-API-KEY 字段用于提供你的唯一API密钥，此密钥用于标识你的身份，允许系统识别并授权你的API请求。请务必妥善保管你的API密钥，避免泄露。

X-API-SIGN 字段则包含使用你的Secret Key对请求参数进行加密签名后生成的字符串。此签名用于验证请求的完整性和真实性，防止请求在传输过程中被篡改。

具体的签名算法实现细节（包括参数排序、字符串拼接、哈希算法选择等）以及示例代码，请务必参考完整的Bitget API官方文档。文档中会详细解释如何使用Secret Key正确地生成 X-API-SIGN 签名，以确保你的API请求能够通过身份验证。

构建自动化交易系统

通过深度整合并高效利用前述API接口，开发者能够精心打造全自动化的法币交易系统，该系统可无缝集成以下关键功能模块，从而实现高效且智能的交易操作：

深度市场行情监控： 系统需具备高频定时调用获取广告列表API接口的能力，以实现对市场上法币交易广告报价的实时、全面监控。通过算法筛选和分析，系统能够精准识别并自动选择当前最具竞争力的最优广告，为后续交易决策提供坚实的数据基础。
智能化自动下单执行： 系统应严格遵循预先设定的交易策略，无需人工干预即可自动执行订单创建流程，完成买入或卖出操作。交易策略可涵盖多种指标，例如价格趋势、成交量、时间周期等，并支持灵活调整以适应市场变化。
精细化订单生命周期管理： 系统需具备实时查询订单状态的能力，并针对各种异常情况，如超时未支付订单、交易纠纷等，采取及时的处理措施。例如，对于长时间未支付的订单，系统应自动取消以释放资金和资源，避免不必要的损失。
多维度风险控制体系： 系统应集成全面的风险控制机制，允许用户自定义交易金额上限、价格波动容忍度等关键参数。通过设定止损止盈点，系统能够有效防止因市场剧烈波动导致的意外损失，确保资金安全。还应考虑交易频率限制，防止过度交易。
高效自动放币流程： 作为卖家，系统在收到付款确认后，需立即自动调用确认放币API接口，安全、快速地释放相应的加密货币给买家，提升交易效率和用户体验。此过程应包含二次验证机制，确保资金安全无误。

注意事项

API Key 安全： 务必将您的API Key和Secret Key视为最高机密，采取一切必要措施妥善保管。切勿以任何形式泄露给他人，包括但不限于屏幕截图、代码提交或口头告知。一旦泄露，立即更换API Key和Secret Key，并审查账户是否存在异常活动，防止未经授权的访问和潜在的资金损失。考虑使用IP地址白名单限制API Key的使用范围，进一步增强安全性。
频率限制： Bitget API为了保障系统稳定运行，对请求频率设置了严格的限制。超出限制可能导致API调用失败，影响交易策略的执行。在使用API时，请务必仔细阅读官方文档，了解不同接口的频率限制，并根据实际需求合理控制请求频率。建议实施熔断机制，当触发频率限制时，自动暂停API调用一段时间，避免被永久封禁。
错误处理： Bitget API会返回各种错误代码，指示API调用失败的原因。对这些错误代码进行妥善处理至关重要。在您的应用程序中，务必加入完善的错误处理机制，能够捕获并解析API返回的错误代码，并根据不同的错误类型采取相应的措施，例如重试、记录日志或发出警报。这有助于及时发现并解决问题，保证交易系统的稳定运行。
资金安全： 在进行法币交易时，务必保持高度警惕，防范潜在的诈骗风险。选择信誉良好、经过认证的交易对手，并仔细核实对方的身份信息。切勿轻信陌生人的承诺，不要参与任何可疑的交易活动。使用Bitget提供的安全交易功能，例如担保交易，确保资金安全。
合规性： 在进行法币交易时，务必遵守您所在国家或地区的法律法规。了解当地对加密货币交易的监管要求，并确保您的交易活动符合相关规定。避免参与任何非法或违规的交易行为，例如洗钱、恐怖融资等。
测试环境： 在正式部署自动化交易系统之前，务必在Bitget提供的测试环境中进行充分的测试。模拟真实的市场环境，验证交易策略的有效性和稳定性。测试包括但不限于订单创建、订单取消、持仓管理、资金划转等功能。确保程序能够正确处理各种异常情况，并具有良好的容错能力。
支付账户绑定： 为了能够顺利创建订单，请确保您的Bitget账户已绑定相应的支付账户，例如支付宝、微信等。绑定前，请仔细阅读Bitget关于支付账户绑定的相关说明，并确保您提供的支付账户信息准确无误。如果支付账户信息有误，可能导致订单创建失败或资金无法到账。
阅读API文档： 详细阅读Bitget API的官方文档是使用API的前提。官方文档包含了最新的接口信息、参数说明、请求示例、错误代码等重要信息。通过阅读官方文档，您可以全面了解Bitget API的功能和使用方法，从而更好地开发和使用API。建议定期查阅官方文档，了解API的更新和变更。