Bitget API法币交易指南(2025)：快速上手教程，提高交易效率！

Bitget 平台 API 如何进行法币交易

Bitget 是一家领先的加密货币交易所，其 API 提供了强大的功能，允许开发者程序化地访问和管理其账户，执行交易，以及获取市场数据。本文档将详细介绍如何使用 Bitget API 进行法币交易 (OTC)。

1. 准备工作

在使用 Bitget API 进行法币（OTC）交易之前，必须完成一系列必要的准备工作，确保交易安全可靠：

Bitget 账户与KYC验证: 您需要注册并拥有一个 Bitget 账户。务必完成实名认证（KYC），这是使用 Bitget 法币交易服务的先决条件，有助于提升账户安全性和合规性。未经验证的账户可能无法访问某些 API 功能。
API 密钥的创建与保管: 在 Bitget 官方网站或APP上创建 API 密钥。这一步至关重要，API 密钥是您程序访问 Bitget 交易系统的凭证。每个 API 密钥包含两个部分：API Key (也称为访问密钥)，用于标识您的身份；以及 Secret Key (密钥)，用于对请求进行签名，验证请求的真实性。请务必将 Secret Key 妥善保管，不要泄露给任何人。一旦泄露，您的账户将面临安全风险。建议启用双重身份验证(2FA)增强安全性。
API 权限的配置: 创建 API 密钥时，必须准确地授予法币交易（OTC）相关的 API 权限。仔细检查并确保您已勾选允许进行法币交易的选项。错误的权限配置可能导致 API 请求失败或者安全漏洞。您可能还需要根据实际需求配置其他权限，例如现货交易或合约交易等。
编程环境的搭建与配置: 您需要搭建一个合适的编程环境，以便发送和处理 HTTP 请求。常用的编程语言包括 Python、Java、Node.js、Go 等。选择您熟悉的编程语言，并安装必要的库和依赖项，例如用于发送 HTTP 请求的 `requests` 库 (Python) 或者 `okhttp` 库 (Java)。确保您的编程环境能够正确解析 JSON 格式的数据，因为 Bitget API 的响应通常是 JSON 格式。
Bitget API 文档的研读与理解: 详细阅读 Bitget 官方提供的 API 文档，文档中包含了所有可用 API 端点的详细信息，包括请求方法 (GET, POST, PUT, DELETE)，请求参数，数据类型，以及响应格式和错误码。理解 API 文档是成功使用 Bitget API 的关键。Bitget 会定期更新 API 文档，以反映最新的功能和改进。因此，请务必参考最新版本的文档，避免因使用过时信息而导致错误。文档通常会提供示例代码，方便开发者快速上手。

2. API 认证

在使用任何需要身份验证的 API 端点之前，为了确保安全性和用户身份的唯一识别，您需要对您的API请求进行签名。这一签名过程是验证您的身份，并授权您访问受保护的资源的关键步骤。

Bitget API 采用行业标准的 HMAC-SHA256 (Hash-based Message Authentication Code with SHA-256) 算法进行数字签名。HMAC-SHA256是一种使用加密哈希函数和密钥来生成消息认证码的方法，它可以验证数据的完整性和来源。

使用 HMAC-SHA256 算法，API请求会通过以下步骤进行签名：您将使用您的API密钥和密钥对请求参数进行哈希运算。这个过程确保只有拥有正确密钥的人才能生成有效的签名。生成的签名会附加到您的API请求中，服务器会使用相同的算法和您的密钥来验证签名，从而确认请求的真实性和完整性。

为了保证安全性，请务必妥善保管您的API密钥和密钥。切勿在公共场合或不受信任的环境中泄露您的密钥信息。建议定期更换密钥，以进一步加强安全性。正确的API签名将确保您的请求被正确处理，并保护您的账户安全。

签名步骤:

创建请求字符串: 将所有必要的请求参数，包括 endpoint 路径及查询参数，按照字母顺序进行升序排列。连接这些参数形成一个单一的字符串，该字符串将作为签名计算的基础。
- GET 请求: 例如，对于一个 GET 请求 /api/otc/v1/advertisements?asset=USDT&currency=CNY ，排序和连接查询参数后，请求字符串应为 asset=USDT&currency=CNY 。务必排除 URL 中的路径部分。
- POST 请求: 对于 POST 请求，请求字符串通常是请求体中包含的 JSON 数据。将 JSON 数据字符串化后直接使用，无需额外排序。确保 JSON 数据的格式符合 API 文档的要求。
- 重要提示: 排序时区分大小写。在连接参数时，不应包含任何分隔符（如 & 或 ? ）。
计算 HMAC-SHA256 签名: 使用您的 Secret Key 作为密钥，采用 HMAC-SHA256 算法对先前创建的请求字符串进行哈希运算。这个过程会生成一个唯一的签名，用于验证请求的完整性和真实性。
- Secret Key: 务必妥善保管您的 Secret Key，切勿泄露给他人。
- HMAC-SHA256: 确保使用的 HMAC-SHA256 算法实现与 API 文档中指定的相符。不同的实现可能产生不同的签名结果。
- 编码: 某些 API 可能要求对请求字符串进行特定的编码（例如 UTF-8）后再进行哈希运算。
添加请求头: 将必要的请求头添加到您的 HTTP 请求中，以包含身份验证信息和签名。
- ACCESS-KEY : 您的 API Key，用于标识您的账户。
- ACCESS-SIGN : 上一步骤计算出的 HMAC-SHA256 签名，用于验证请求的完整性。
- ACCESS-TIMESTAMP : 当前 Unix 时间戳（以毫秒为单位），用于防止重放攻击。时间戳必须与服务器时间保持同步，通常允许一定的偏差范围。
- Content-Type : 指定请求体的 MIME 类型。对于 JSON 数据，通常是 application/ 。
- 其他请求头: 根据 API 文档的要求，可能还需要添加其他请求头，例如 Accept （指定服务器可以接受的响应类型）或 Authorization （用于其他类型的身份验证）。

Python 示例:

为了与Bitget API进行交互，您需要使用编程语言（如Python）来构建HTTP请求。以下示例展示了如何使用Python的 hashlib , hmac , time , 和 requests 库来生成签名并发送API请求。

hashlib 提供了多种哈希算法，用于生成消息摘要。 hmac 用于生成带密钥的哈希值，确保消息的完整性和身份验证。 time 用于获取当前时间戳，作为请求的一部分。 requests 库则用于发送HTTP请求。

import hashlib
import hmac
import time
import requests
import   # 确保导入  模块

您需要设置您的API密钥和密钥，以及Bitget API的基本URL。请务必妥善保管您的API密钥和密钥，避免泄露。

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
base_url = "https://api.bitget.com"  # 正式环境

generate_signature 函数用于生成Bitget API请求所需的签名。签名是使用您的密钥，时间戳，请求路径，查询字符串（如果存在），HTTP方法和请求体（如果存在）生成的HMAC-SHA256哈希值。这个签名用于验证请求的真实性和完整性。

def generate_signature(timestamp, request_path, query_string, method, body):
    """
    生成 Bitget API 签名.

    参数:
        timestamp (int): 时间戳 (毫秒).
        request_path (str): API 端点路径.
        query_string (str): 查询字符串 (GET 请求).
        method (str): HTTP 方法 (GET 或 POST).
        body (dict): 请求体 (POST 请求).

    返回:
        str: 生成的签名.
    """
    message = str(timestamp) + method + request_path

    if method == "GET" and query_string:
        message += "?" + query_string
    elif method == "POST" and body:
        message += .dumps(body, separators=(',', ':'))  # 使用 .dumps 序列化 body

    message = message.encode('utf-8')

    signature = hmac.new(secret_key.encode('utf-8'), message, digestmod=hashlib.sha256).hexdigest()

    return signature

send_request 函数用于发送Bitget API请求。它接收HTTP方法，API端点，查询参数（GET请求）和请求体（POST请求）作为参数。该函数首先生成时间戳和签名，然后构建带有必要标头的HTTP请求，最后发送请求并返回响应。

def send_request(method, endpoint, params=None, data=None):
    """
    发送 Bitget API 请求.

    参数:
        method (str): HTTP 方法 (GET 或 POST).
        endpoint (str): API 端点路径.
        params (dict): 查询参数 (GET 请求).
        data (dict): 请求体 (POST 请求).

    返回:
        dict: API 响应 (JSON 格式).
    """
    timestamp = int(time.time() * 1000)
    url = base_url + endpoint

    if params:
        query_string = "&".join([f"{k}={v}" for k, v in params.items()])
    else:
        query_string = ""

    signature = generate_signature(timestamp, endpoint, query_string, method, data)

    headers = {
        "ACCESS-KEY": api_key,
        "ACCESS-SIGN": signature,
        "ACCESS-TIMESTAMP": str(timestamp),
        "Content-Type": "application/"  # 明确指定 Content-Type 为 application/
    }

    try:
        if method == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method == "POST":
            response = requests.post(url, headers=headers, data=.dumps(data))  # 使用 .dumps 序列化 data
        else:
            print("Unsupported method")
            return None

        response.raise_for_status()  # 检查 HTTP 状态码

        return response.()  # 返回 JSON 格式的响应
    except requests.exceptions.RequestException as e:
        print(f"Request failed: {e}")
        return None

请务必替换 `YOUR_API_KEY` 和 `YOUR_SECRET_KEY` 为您的实际密钥。

3. 获取广告列表

使用 API 接口检索当前平台上可用的法币交易（Fiat Trading，简称 OTC）广告列表。该接口允许用户筛选和浏览由其他用户或商家发布的买卖加密货币的广告信息。通过指定参数，可以根据法币类型、加密货币类型、交易方向（买入或卖出）、价格范围、数量限制等条件进行筛选，从而快速定位符合需求的广告。API 返回的数据通常包括广告发布者的信息、单价、剩余数量、交易限额、支付方式以及其他相关细节，方便用户做出交易决策。

API Endpoint:

GET /api/otc/v1/advertisements

此 API 端点用于检索场外交易 (OTC) 平台上发布的广告列表。通过 GET 请求，客户端可以获取当前可用的买卖数字资产的广告信息。

该端点允许用户查询并筛选满足特定条件的广告，例如：

交易对: 指定要交易的数字资产对，例如 USDT/BTC。
交易类型: 区分买单 (Buy) 和卖单 (Sell)。
法币类型: 指定用于交易的法定货币，例如 CNY、USD。
付款方式: 指定接受的付款方式，例如支付宝、微信支付、银行转账。
价格范围: 过滤指定价格范围内的广告。
数量范围: 筛选指定交易数量范围内的广告。
广告发布者: 可以指定特定的广告发布者进行查询。

成功的请求将返回一个 JSON 格式的广告列表，其中包含每个广告的详细信息，包括价格、数量、付款方式、交易对手评级等。客户端可以利用这些信息来选择合适的广告进行交易。请求失败可能会返回错误代码和描述，指示请求中的问题。

请求参数:

asset (required): 数字货币类型，指定要交易的数字资产。例如 USDT (Tether)、 BTC (比特币) 等。该参数区分大小写，务必提供正确的资产代码。不同的平台支持的数字资产类型可能不同，请参考平台的API文档获取支持的列表。
currency (required): 法币类型，指定用于购买或出售数字资产的法定货币。例如 CNY (人民币)、 USD (美元)。法币代码通常为ISO 4217标准的三字母代码。类似于数字货币，请查阅平台API文档确认支持的法币列表。
tradeType (optional): 交易类型，标识是买入还是卖出操作。可选值为 buy (买入，即用指定的法币购买数字货币) 或 sell (卖出，即出售数字货币换取法币)。如果不指定此参数，可能返回所有类型的交易数据。
payment (optional): 支付方式，指定交易时使用的支付渠道。例如 bank (银行转账), alipay (支付宝), wechat (微信支付)。可以使用逗号分隔多个支付方式，例如 bank,alipay 表示同时筛选支持银行转账和支付宝的交易。请注意，不是所有平台都支持所有支付方式，需根据平台API文档确认可用选项。
page (optional): 页码，用于分页查询交易信息。默认为 1，表示第一页。当结果集较大时，可以使用分页参数逐步获取数据，避免一次性加载过多数据导致性能问题。
limit (optional): 每页数量，指定每页返回的交易记录数量。默认为 20，最大值为 100。设置合适的limit值可以优化数据传输效率。过小的limit值会导致多次请求，增加网络开销；过大的limit值可能导致单次请求数据量过大，影响响应速度。某些平台可能对limit值有更严格的限制，需要参考API文档。

Python 示例:

获取 USDT/CNY 的买入广告

为了通过API获取以人民币 (CNY) 购买泰达币 (USDT) 的广告信息，你需要向指定的端点发送一个GET请求，并附带相应的参数。该接口允许你筛选特定资产、交易货币和交易类型，从而获取符合你需求的广告列表。

请求的API端点 (endpoint) 定义为： /api/otc/v1/advertisements 。

你需要构造一个包含以下参数的字典 (params) 并将其作为GET请求的一部分发送：

asset : 指定交易的数字资产。在本例中，设置为 "USDT"，表示泰达币。
currency : 指定用于购买数字资产的法币。在本例中，设置为 "CNY"，表示人民币。
tradeType : 指定交易类型。设置为 "buy"，表示获取购买 USDT 的广告。

示例参数字典：


params = {
    "asset": "USDT",
    "currency": "CNY",
    "tradeType": "buy"
}

使用你选择的HTTP客户端库，构造一个GET请求，将端点和参数传递给 send_request 函数进行发送。以下是一个使用示例：


response = send_request("GET", endpoint, params=params)

收到API响应后，你需要检查响应的状态码以确定请求是否成功。通常，一个成功的请求会返回一个状态码指示成功。如果 response 不为空，并且 response["code"] 等于 "0"，则表示请求已成功处理。

如果请求成功，响应数据通常包含一个广告列表，每个广告都包含有关价格、数量和支付方式的信息。你可以遍历 response["data"] 中的每个广告对象，并提取相关信息。

以下代码展示了如何解析成功的响应并打印每个广告的详细信息：


if response and response["code"] == "0":
    advertisements = response["data"]
    for ad in advertisements:
        print(f"广告 ID: {ad['id']}, 价格: {ad['price']}, 数量: {ad['amount']}, 支付方式: {ad['payments']}")
else:
    print(f"获取广告列表失败: {response}")

如果请求失败，即 response 为空或 response["code"] 不等于 "0"，则表示发生了一个错误。你应该打印或记录错误消息，以便进一步调查。 response 对象通常包含有关错误的更多详细信息，例如错误代码和描述。

4. 创建订单

在精心挑选并确定了一个符合您需求的广告之后，下一步便是创建订单。创建订单是启动交易流程的关键环节，务必认真对待。

创建订单通常涉及以下几个步骤：

阅读并理解广告条款： 再次仔细阅读广告的所有条款和条件，包括价格、支付方式、交易时间限制等，确保完全理解并接受。
输入交易金额： 根据您的需求，准确输入您希望交易的金额。请注意，部分广告可能设置了最低或最高交易限额。
选择支付方式： 选择您希望使用的支付方式。不同的广告可能支持不同的支付方式，例如银行转账、支付宝、微信支付等。务必选择您方便且安全的支付方式。
确认订单信息： 在提交订单之前，仔细核对所有订单信息，包括交易金额、支付方式、对方账户信息等，确保准确无误。
提交订单： 确认所有信息无误后，即可提交订单。提交订单后，请耐心等待对方确认。

请注意，在创建订单的过程中，务必保持警惕，防范欺诈行为。例如，不要轻易相信对方提供的非官方支付链接，不要向对方透露您的个人信息或密码。如有任何疑问，请及时联系平台客服。

API Endpoint:

POST /api/otc/v1/orders

此API端点用于在场外交易(OTC)平台上创建新的订单。

请求方法: POST

API路径: /api/otc/v1/orders

描述: 允许用户通过应用程序接口(API)提交场外交易订单请求。这通常涉及指定交易对（例如，BTC/USDT）、订单类型（例如，市价单或限价单）、数量和价格等参数。服务器将验证请求并尝试根据市场条件和可用流动性执行订单。

使用此端点需要有效的API密钥和适当的权限。请确保请求头中包含必要的身份验证信息，例如 Authorization: Bearer 。

请求体 (Request Body): 请求体应包含符合预定义JSON模式的参数，用于指定订单的详细信息。这些参数通常包括:

symbol : 交易对，例如 "BTC/USDT"。
side : 交易方向，"buy" (买入) 或 "sell" (卖出)。
type : 订单类型，例如 "market" (市价单) 或 "limit" (限价单)。
quantity : 交易数量，即购买或出售的加密货币数量。
price : (仅限限价单) 指定的交易价格。
client_order_id : (可选) 客户端自定义的订单ID，用于跟踪订单状态。

响应 (Response): 成功创建订单后，API将返回一个JSON响应，其中包含有关已创建订单的详细信息，包括订单ID、状态和执行信息。如果创建订单失败，API将返回一个包含错误代码和错误消息的JSON响应。

可能出现的错误:

400 Bad Request : 请求参数无效或缺失。
401 Unauthorized : API密钥无效或缺失。
403 Forbidden : API密钥没有足够的权限来创建订单。
404 Not Found : 指定的交易对不存在。
429 Too Many Requests : 请求频率超过限制。
500 Internal Server Error : 服务器内部错误。

注意事项:

请仔细验证订单参数，确保其准确无误。
请妥善保管您的API密钥，避免泄露。
请仔细阅读API文档，了解有关请求频率限制和其他限制。

请求参数:

advertisementId (必填): 广告 ID。此参数用于唯一标识您希望交互的特定广告。它是一个字符串类型的标识符，由平台分配给每个创建的广告。确保提供的 ID 与您要进行的交易相匹配，否则可能导致交易失败或错误的结果。
amount (必填): 购买或出售的数字货币数量。此参数表示您希望交易的加密货币数量，使用数字格式表示。例如，如果您要购买 1.5 个比特币，则此值应设置为 1.5。请注意，平台可能对允许的最小和最大交易数量有限制，请确保您的交易数量符合这些限制。
tradeType (必填): 交易类型， buy (买入) 或 sell (卖出)。此参数指定您是想购买还是出售加密货币。 buy 表示您希望用指定的法币购买加密货币，而 sell 表示您希望出售加密货币以换取指定的法币。此参数必须与广告类型一致，即如果您尝试购买而广告是出售广告，则交易将会失败。
currency (必填): 法币类型，例如 CNY (人民币)。此参数指定您用于交易的法币类型。它是一个字符串类型的代码，符合 ISO 4217 标准。例如， USD 代表美元， EUR 代表欧元， JPY 代表日元。此参数必须与广告类型一致，例如，如果广告指定使用 CNY 进行交易，则您必须提供 CNY 作为货币参数。

Python 示例:

创建一个买入 USDT 的订单

在加密货币交易中，通过场外交易(OTC)平台购买USDT (Tether) 是一种常见的操作。以下代码段展示了如何通过API创建一个买入USDT的订单。请务必使用真实的API密钥和签名，并且严格按照交易所的API文档进行操作，避免安全风险。

Endpoint: /api/otc/v1/orders 。这是用于创建OTC订单的API端点。务必确认你的API调用方法是 POST ，并检查API版本是否与你的交易所API文档匹配。不同的API版本可能会有不同的请求参数和返回格式。

请求数据 (data):

{
    "advertisementId": "广告ID",  // 替换为实际的广告ID。广告ID是卖家发布的广告的唯一标识符。你需要在OTC平台上找到合适的广告，并获取其ID。
    "amount": "100", // 购买100 USDT。 指定你想购买的USDT数量。这是一个字符串类型，应该只包含数字。仔细核对购买数量，确保符合你的需求。
    "tradeType": "buy", // 交易类型设置为 "buy"，表示你希望购买USDT。请确保大小写与API文档一致，通常是全小写。
    "currency": "CNY" // 使用人民币 (CNY) 支付。指定你用来购买USDT的法币币种。如果你的账户支持多种法币，请选择正确的币种。
}

关于 advertisementId : 这是至关重要的参数。你需要事先在OTC交易平台上浏览可用的卖单(广告)，根据价格、支付方式、限额等条件选择一个最符合你需求的广告，然后复制该广告的ID。错误的广告ID会导致订单创建失败。

请求示例：


import requests
import 

# 替换成你的API密钥和秘钥
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"

#  模拟一个发送请求的方法 (需要根据你的交易所API进行调整，包含签名逻辑)
def send_request(method, endpoint, data=None):
    url = "https://your_exchange.com" + endpoint  # 替换成你的交易所API域名
    headers = {
        "Content-Type": "application/",
        "X-API-KEY": api_key,
        #  这里可以添加你的签名头, 具体请参考交易所API文档
    }
    if data:
        data = .dumps(data) # 将data转换为JSON字符串
    try:
        response = requests.request(method, url, headers=headers, data=data)
        response.raise_for_status()  # 检查请求是否成功 (200 OK)
        return response.()
    except requests.exceptions.RequestException as e:
        print(f"请求失败: {e}")
        return None

endpoint = "/api/otc/v1/orders"
data = {
    "advertisementId": "广告ID",  # 替换为实际的广告 ID
    "amount": "100", # 购买 100 USDT
    "tradeType": "buy",
    "currency": "CNY"
}

response = send_request("POST", endpoint, data=data)

if response and response.get("code") == "0": # 使用get方法更安全, 防止KeyError
    order_id = response["data"]["orderId"]
    print(f"订单创建成功，订单 ID: {order_id}")
else:
    print(f"订单创建失败: {response}")

响应处理:

response 对象包含了API调用的结果。你需要检查 response["code"] 是否为 "0" ，这通常表示订单创建成功。不同的交易所可能会使用不同的错误代码，所以务必参考API文档。如果订单创建成功， response["data"]["orderId"] 将包含新创建订单的ID。你需要保存这个ID，用于后续的订单查询、取消等操作。如果订单创建失败， response 对象将包含错误信息，帮助你诊断问题。

错误处理：务必添加适当的错误处理机制。例如，检查 response 是否为 None ，以及 response["code"] 的值。根据不同的错误代码，采取不同的处理措施，例如，重新尝试创建订单，或者联系交易所客服。

请务必将 `广告ID` 替换为实际的广告 ID。

5. 获取订单详情

为了追踪交易状态或审计历史记录，可以通过订单 ID 获取指定订单的详细信息。订单 ID 是一个唯一的标识符，由交易所或交易平台在订单创建时分配。您可以使用此 ID 查询订单的各种属性，例如订单类型（限价单、市价单等）、交易对（例如 BTC/USD）、订单数量、订单价格、下单时间、订单状态（已成交、部分成交、已取消、待处理等）、手续费以及相关的交易 ID。

通过 API 调用或平台界面输入订单 ID，您可以获取订单的完整信息，这对于维护交易记录、排查交易问题以及进行交易分析至关重要。务必妥善保管您的订单 ID，以便随时查阅和核对交易信息。

API Endpoint: 获取订单详情

使用 GET 方法访问以下 API 端点，以获取指定订单的详细信息： /api/otc/v1/orders/{orderId} 。

其中， {orderId} 是您需要查询的订单的唯一标识符。请务必将 {orderId} 替换为实际的订单 ID。

此端点允许您检索与该订单相关的所有信息，例如订单状态、交易对、下单时间、成交价格、数量、交易手续费和相关用户 ID 等。

调用此API需要进行身份验证，确保您拥有访问指定订单信息的权限。

请求参数:

orderId (必填): 订单 ID。这是一个唯一标识订单的字符串，通常由系统自动生成。请务必提供有效的订单 ID，否则请求将无法正确处理。该ID用于在系统中检索特定订单的相关信息，例如订单状态、交易详情和物流信息。长度和格式可能因具体系统而异，通常为数字和字母的组合。

Python 示例:

获取订单详情

为了查询特定订单的详细信息，您需要使用订单ID。请将以下代码中的 订单ID 替换为您想要查询的实际订单ID。订单ID是唯一标识符，用于在系统中检索特定的交易订单。

order_id = "订单ID" # 替换为实际的订单 ID

构造API端点至关重要。API端点是指向特定API资源的URL。此处的端点用于检索与提供的订单ID相关联的订单详细信息。通过将基础API路径与订单ID结合，我们构建了完整的API请求路径。

endpoint = f"/api/otc/v1/orders/{order_id}"

现在，使用构造的端点向API发送一个GET请求。GET请求用于从服务器检索数据。 send_request 函数负责处理与API的通信。它接受HTTP方法（此处为“GET”）和端点作为输入，并返回API的响应。

response = send_request("GET", endpoint)

收到API响应后，验证响应是否成功至关重要。一个成功的响应通常由一个特定的状态码表示，例如“0”。如果 response 不为空，并且其 code 字段等于“0”，则表明请求已成功处理，我们可以继续提取订单详细信息。

if response and response["code"] == "0":

如果请求成功，订单详细信息将包含在响应的 data 字段中。从响应中提取这些详细信息，并将它们存储在 order_details 变量中，以便进一步处理或显示。

order_details = response["data"]

打印订单详情。这可能涉及将数据格式化为用户友好的格式，以便进行检查和验证。

print(f"订单详情: {order_details}")

如果API请求失败（例如，由于无效的订单ID或服务器错误），则响应将包含一个错误代码和一条消息。在此情况下，我们需要打印一条错误消息，指示检索订单详细信息失败，并提供有关失败原因的信息。错误消息可能包含在 response 对象中，以便进行调试。

else:

print(f"获取订单详情失败: {response}")

请务必将 `订单ID` 替换为实际的订单 ID。

6. 取消订单

在加密货币交易中，订单取消是一个常见操作，但其可行性高度依赖于订单的状态。如果您的挂单（例如限价单）尚未被执行，即尚未与市场上的其他订单匹配成交，通常可以取消该订单。这意味着您的订单仍然停留在交易所的订单簿上，等待被其他交易者接受。然而，一旦订单开始执行，部分或全部成交，取消操作将不再可行，因为已经发生了实际的资产转移。务必留意交易所的交易界面，通常会提供明确的订单状态指示，以便您判断是否可以安全地取消订单，避免不必要的损失。

取消订单的具体操作流程取决于您使用的交易所。一般来说，您需要在交易界面的订单列表中找到想要取消的订单，并点击相应的“取消”按钮或链接。有些交易所可能会要求您进行二次确认，以防止误操作。取消订单后，务必检查您的账户余额，确保相应的资金或加密货币已经返还到您的账户中。由于网络延迟和交易所处理速度的差异，订单取消可能不会立即生效，请耐心等待。如果取消订单长时间未被处理，建议您联系交易所的客服支持寻求帮助。

API Endpoint:

POST /api/otc/v1/orders/{orderId}/cancel

该 API 接口用于取消指定 OTC（场外交易）订单。它采用 HTTP POST 方法，并通过 URL 中的 {orderId} 参数来标识需要取消的订单。 orderId 应该替换为实际的订单 ID，它是一个唯一的字符串，用于在系统中标识一个特定的 OTC 交易请求。

请求方法： POST

URL 路径： /api/otc/v1/orders/{orderId}/cancel

参数说明：

orderId (路径参数): 必需参数。表示要取消的订单的唯一标识符。类型为字符串。请确保提供的 orderId 存在于系统中，并且该订单的状态允许被取消（例如，未成交、部分成交等）。

请求示例：

假设我们要取消订单 ID 为 "e5b9a74e-3c2d-4a5f-9b8d-1a2b3c4d5e6f" 的订单，则完整的 URL 如下：

POST /api/otc/v1/orders/e5b9a74e-3c2d-4a5f-9b8d-1a2b3c4d5e6f/cancel

注意事项：

调用此 API 需要进行身份验证，确保只有授权用户才能取消订单。
服务器可能会返回不同状态码以指示请求的结果。例如，200 表示成功取消订单，400 表示无效的 orderId 或请求参数错误，404 表示找不到指定的订单，500 表示服务器内部错误等。
在取消订单之前，应仔细确认订单信息，避免误操作。
成功取消订单后，订单状态将被更新，并且可能触发相关的事件通知（例如，通过 WebSockets 或其他方式通知交易双方）。

请求参数:

orderId (必填) : 订单 ID。这是一个平台生成的唯一标识符，用于追踪和管理特定交易订单。请务必提供有效的 orderId 以便系统能够准确识别并处理您的请求。未提供或提供无效的 orderId 将导致请求失败。订单ID 通常由字母、数字或者特殊字符组成，请仔细核对您提供的ID。

Python 示例:

取消订单

在加密货币交易中，取消订单是一个常见的操作，尤其是在市场波动剧烈时。以下代码片段展示了如何通过API取消指定ID的订单。请务必将 "订单ID" 替换为实际的订单ID。

order_id = "订单ID" # 替换为实际的订单 ID
此变量用于存储需要取消的订单的唯一标识符。订单ID通常由交易平台生成，并可在订单创建后获取。

endpoint = f"/api/otc/v1/orders/{order_id}/cancel"
此行代码构建了用于取消订单的API端点。 /api/otc/v1/orders/{order_id}/cancel 是一个RESTful API端点示例，其中 {order_id} 会被替换为实际的订单ID。 /api/otc/v1/ 通常表示API的版本和模块（场外交易，OTC）。 /orders/ 指示与订单相关的操作，而 /cancel 则指定了取消订单的动作。使用f-string（格式化字符串字面量）可以方便地将变量嵌入到字符串中。

response = send_request("POST", endpoint)
这行代码使用 send_request 函数发送一个POST请求到指定的API端点。POST方法通常用于执行修改服务器状态的操作，例如取消订单。 send_request 函数封装了与API服务器通信的细节，包括身份验证、请求头设置和错误处理等。你需要根据你使用的API客户端库（如requests库在Python中）来调整代码。

if response and response["code"] == "0": print(f"订单取消成功") else: print(f"订单取消失败: {response}")
此条件语句检查API请求是否成功。通常，API会返回一个包含状态码和数据的JSON响应。如果响应存在（ response 不为空）且 code 字段的值为 "0" （或其他表示成功的代码），则认为订单取消成功。否则，将打印错误信息，包括完整的响应内容，以便调试。请注意，具体的成功代码和错误信息格式取决于API提供商的文档。务必参考API文档来正确解析响应。

请务必将 `订单ID` 替换为实际的订单 ID。

7. 标记订单为已付款

在您通过银行转账、支付宝、微信支付或其他法币支付方式成功向卖家支付约定的法币金额后，为了告知卖家您已完成付款操作，并且启动后续的数字资产释放流程，您必须及时将订单标记为“已付款”。这是一个至关重要的步骤，它通知卖家您已经履行了付款义务，并要求他们验证收款情况。

具体操作方法通常是在交易平台上找到对应的订单，并在订单详情页面找到“标记为已付款”或类似的按钮。点击该按钮后，系统可能会要求您提供付款凭证，例如银行转账截图、支付平台的交易记录截图等，以便卖家进行核实。请务必提供真实有效的付款凭证，以加速验证流程，避免交易纠纷。

务必注意，在实际付款之前，不要轻易点击“标记为已付款”按钮。虚假标记可能会导致交易纠纷，并对您的信用评级产生负面影响。只有在确认已经成功付款，并且能够提供有效的付款凭证的情况下，才能进行此操作。

API Endpoint:

POST /api/otc/v1/orders/{orderId}/markAsPaid

此API端点用于将指定的场外交易 (OTC) 订单标记为已付款。通过向此端点发送 POST 请求，您可以通知系统买方已完成订单支付，为卖方确认收款并释放加密货币资产做准备。此操作是OTC交易流程中的关键步骤，触发后续的资金确认和资产转移流程。

请求方法： POST

API 路径： /api/otc/v1/orders/{orderId}/markAsPaid

路径参数：

{orderId} ：(必需) 订单的唯一标识符。这是一个字符串类型的参数，用于指定要标记为已付款的特定订单。请确保提供正确的订单ID，否则请求将失败。

请求体：

通常，此端点不需要请求体，或者请求体可能只包含一些可选的确认信息，例如交易ID或时间戳。具体取决于API的设计。请查阅详细的API文档以确认请求体的内容格式。

响应：

成功标记为已付款后，服务器将返回一个成功的HTTP状态码 (例如 200 OK 或 204 No Content)。响应体可能包含有关订单更新状态的信息，或确认操作已成功执行的消息。如果出现错误（例如订单不存在，订单状态不允许标记为已付款，或其他验证错误），服务器将返回相应的错误状态码 (例如 400 Bad Request, 404 Not Found, 或 409 Conflict) 以及描述错误的错误消息。

安全性：

此API端点通常需要身份验证和授权才能访问。只有授权用户（通常是买方）才能将订单标记为已付款。确保在请求中包含有效的身份验证凭据，例如 API 密钥或 JWT (JSON Web Token)。

使用示例：

假设订单 ID 是 1234567890 ，则完整的 API 端点是 /api/otc/v1/orders/1234567890/markAsPaid 。买方需要构造一个带有适当身份验证头的 POST 请求到此端点。

请求参数:

orderId (required): 订单 ID。这是用于唯一标识特定订单的字符串。请务必提供有效的订单 ID，否则请求将无法成功处理。该 ID 通常由交易平台在创建订单时生成，并用于追踪订单状态和历史记录。正确使用该参数至关重要，以确保您能准确访问和管理您的订单信息。

Python 示例:

标记订单为已付款

在场外交易(OTC)平台中，将订单状态更新为“已付款”是交易流程的关键步骤。以下代码展示了如何通过API调用来实现此功能。你需要准备好待更新订单的唯一标识符。

order_id = "订单ID" # 替换为实际的订单 ID 请将 "订单ID" 替换为需要标记为已付款的真实订单ID。每个订单ID在系统中都是唯一的，用于准确识别目标订单。

endpoint = f"/api/otc/v1/orders/{order_id}/markAsPaid" 此代码定义了API端点。该端点指向服务器上处理标记订单为已付款请求的特定资源。 /api/otc/v1/orders/ 指示这是一个场外交易API的订单管理功能， {order_id} 会被替换为实际的订单ID，而 /markAsPaid 则指定了要执行的操作是标记订单为已付款。

response = send_request("POST", endpoint) 这行代码使用POST方法向指定的API端点发送请求。 POST方法通常用于更新服务器上的数据。 send_request 是一个自定义函数，负责处理与API的通信，包括身份验证、数据序列化和错误处理。该函数返回服务器的响应。

if response and response["code"] == "0": print(f"订单已标记为已付款") else: print(f"标记订单为已付款失败: {response}") 这段代码检查API请求是否成功。它首先验证 response 对象是否存在，然后检查响应中的 code 字段是否为 "0" 。 "0" 通常表示成功。如果请求成功，则打印一条消息，指示订单已成功标记为已付款。如果请求失败，则打印一条错误消息，其中包含从API接收到的原始响应，以便进行故障排除。

为了确保代码的安全性，请务必妥善保管API密钥和其他敏感信息。建议使用环境变量或配置文件来存储这些信息，而不是直接在代码中硬编码。

请务必将 `订单ID` 替换为实际的订单 ID。

8. 发布广告

除了手动创建广告之外，您还可以利用API（应用程序编程接口）程序化地发布和管理广告。这种方法尤其适合需要大规模部署或自动化广告活动的开发者和营销人员。

通过API发布广告，您可以实现以下功能：

程序化创建广告： 使用代码自动生成广告内容，例如根据不同的用户群体或产品类型创建不同的广告变体。
实时竞价： 参与实时竞价(RTB)广告市场，根据预设的出价策略自动竞拍广告位。
定向投放： 利用用户数据进行精准定向，将广告展示给最有可能感兴趣的目标受众。
自动化管理： 自动监控广告效果，并根据预设规则自动调整广告内容、出价或投放策略。
数据分析： 通过API获取详细的广告效果数据，例如展示次数、点击次数、转化率等，从而更好地评估广告效果并优化投放策略。

要使用API发布广告，您通常需要：

获取API密钥： 向广告平台申请API密钥，用于身份验证和授权。
了解API文档： 仔细阅读API文档，了解API的使用方法、参数和返回值。
编写代码： 使用编程语言（例如Python、Java或PHP）编写代码，调用API接口创建、管理和监控广告。
进行测试： 在真实投放前，使用少量预算进行测试，确保广告能够正常展示并产生预期效果。

请注意，不同的广告平台可能提供不同的API接口和功能，因此在使用API之前，请务必仔细阅读相关文档并进行充分的测试。

API Endpoint:

POST /api/otc/v1/advertisements

此API端点用于创建新的场外交易 (OTC) 广告。它使用HTTP POST方法，意味着客户端需要向服务器发送包含广告详细信息的请求体。

/api/otc/v1/advertisements 路径明确指定了API的版本（v1）以及其功能（创建OTC广告）。标准API设计规范建议对API进行版本控制，以便在不影响现有客户端的情况下进行升级和修改。

发送到此端点的请求体应包含所有必要的广告信息，例如：交易类型 (买入或卖出)、交易的加密货币类型、交易的法币类型、价格、数量、付款方式等。服务器将验证这些数据，并在成功创建广告后返回相应的响应，通常包含新创建广告的ID或其他相关元数据。

客户端需要确保请求头中包含正确的 Content-Type ，通常是 application/ ，以告知服务器请求体的数据格式。

为了确保安全性，此端点可能需要身份验证和授权，客户端需要在请求头中包含身份验证凭据 (例如，API密钥或 JWT)。

请求参数:

asset (required): 数字货币类型。指定希望交易的加密资产，例如 USDT （泰达币）、 BTC （比特币）。此参数决定了用户将使用或接收何种加密货币。它必须是交易所或平台支持的有效资产代码。
currency (required): 法币类型。指定用于交易的法定货币，例如 CNY （人民币）、 USD （美元）。此参数定义了交易价格和数量的计价单位，也决定了用户将支付或收取的法币类型。需要是平台支持的有效法币代码。
tradeType (required): 交易类型。指示是买入还是卖出数字货币， buy (买入) 表示用户希望用法币购买数字货币， sell (卖出) 表示用户希望出售数字货币以换取法币。
price (required): 价格。指定单价，即每个单位的数字货币对应的法币价格。例如，如果 asset 是 BTC ， currency 是 USD ， price 是 30000 ，则表示 1 个比特币的价格是 30000 美元。
amount (required): 总的数字货币数量。指定交易的总数字货币数量。例如，如果 asset 是 ETH ， amount 是 2 ，则表示交易涉及 2 个以太坊。
minAmount (required): 最小交易数量。定义允许交易的最小数字货币数量，防止过小的交易请求。确保交易金额达到可接受的水平。
maxAmount (required): 最大交易数量。限制允许交易的最大数字货币数量，防止过大的交易请求，可以用于风险控制。
paymentMethods (required): 支持的支付方式。一个字符串数组，列出允许使用的支付方式，例如 bank （银行转账）, alipay （支付宝）, wechat （微信支付）。多个支付方式以数组形式提供，例如 ["bank", "alipay"] 。
remark (optional): 备注。可选的备注信息，允许用户添加关于交易的额外说明或备注，方便记录和管理。

Python 示例:

发布一个购买 USDT 的广告

使用 API 接口 /api/otc/v1/advertisements 发布一个购买 USDT 的广告。通过向此端点发送 POST 请求，可以创建一个场外交易（OTC）广告，允许用户购买指定数量的 USDT。

请求体 ( data ) 需包含以下关键参数：

asset : 指定交易的数字资产，此处为 "USDT" (Tether)。
currency : 指定交易使用的法币，此处为 "CNY" (人民币)。
tradeType : 指定交易类型，"sell" 表示出售 USDT，意味着您要发布一个购买 USDT 的广告。相应的，"buy" 表示购买 USDT。
price : 指定每单位 USDT 的价格，此处为 "7.2" CNY。这是你愿意以多少人民币购买一个USDT。
amount : 指定广告中可供交易的总 USDT 数量，此处为 "1000" USDT。这意味着总共可以购买1000个USDT。
minAmount : 指定单笔交易允许的最小 USDT 数量，此处为 "10" USDT。
maxAmount : 指定单笔交易允许的最大 USDT 数量，此处为 "100" USDT。确保 minAmount 小于或等于 maxAmount 。
paymentMethods : 指定允许的支付方式列表，此处为 ["alipay", "wechat"] ，表示支持支付宝和微信支付。可以添加其他支付方式，具体取决于平台支持。
remark : 广告的备注信息，此处为 "欢迎下单"。

示例请求体：


endpoint = "/api/otc/v1/advertisements"
data = {
     "asset": "USDT",
      "currency":  "CNY",
     "tradeType": "sell",
     "price": "7.2",
      "amount": "1000",
      "minAmount": "10",
    "maxAmount": "100",
       "paymentMethods":  ["alipay",  "wechat"],
     "remark":  "欢迎下单"
}

使用 send_request 函数发送 POST 请求：


response = send_request("POST", endpoint,  data=data)

检查响应 ( response ) 以确认广告是否成功发布。如果 response["code"] 为 "0"，则表示广告发布成功，并从 response["data"]["adId"] 中提取广告 ID。否则，打印错误信息。


if response and  response["code"] == "0":
    ad_id  = response["data"]["adId"]
    print(f"广告发布成功，广告 ID: {ad_id}")
else:
    print(f"广告发布失败: {response}")

成功发布后，您的购买 USDT 广告将会在平台上显示，其他用户可以通过指定的支付方式购买您的 USDT。请务必确保您有足够的 USDT 储备以满足广告中的交易量，并及时处理用户的订单。

9. 注意事项

安全: 务必妥善保管您的 API 密钥，如同保护您的银行密码一样重要。API 密钥泄露可能导致您的账户被恶意操作，资金遭受损失。请不要将 API 密钥存储在不安全的地方，如公开的代码库、聊天记录或邮件中。定期更换 API 密钥也是一种提高安全性的有效手段。可以使用IP白名单功能限制API密钥的使用来源，进一步提高安全性。
频率限制: Bitget API 具有频率限制机制，旨在保护系统稳定性和公平性。频繁发送请求可能会触发频率限制，导致请求失败甚至账户被暂时或永久封禁。在编写程序时，请合理规划请求频率，避免不必要的请求。可以使用API提供的权重参数来预估请求的消耗，并根据实际情况进行调整。可以采用批量请求的方式，减少请求次数，提高效率。
错误处理: 在使用 Bitget API 进行交易或数据查询时，可能会遇到各种错误，如网络连接问题、参数错误、权限不足等。完善的错误处理机制是确保程序稳定运行的关键。请务必仔细阅读 Bitget API 的文档，了解各种错误码的含义，并针对不同的错误码采取相应的处理措施，例如重试、记录日志或通知用户。可以设置告警机制，在出现异常情况时及时通知管理员。
测试环境: 在正式环境中使用 Bitget API 之前，强烈建议您先在测试环境进行充分的测试。测试环境提供了模拟的交易环境和数据，可以帮助您验证程序的正确性、稳定性和性能，避免在真实交易中出现意外情况。Bitget 提供了专门的测试环境 API 密钥，请不要在正式环境中使用测试环境的密钥。
支付方式: 请务必确保您提供的支付方式是真实有效的，并且符合 Bitget 的相关规定。无效的支付方式可能导致交易失败或账户被限制。定期检查和更新您的支付信息，确保其准确性和有效性。了解 Bitget 支持的各种支付方式，选择最适合您的方式进行交易。如果使用信用卡等支付方式，请确保信用卡信息安全，避免泄露。
价格波动: 加密货币市场价格波动剧烈，短期内可能出现大幅上涨或下跌。在使用 Bitget API 进行交易时，请务必谨慎评估风险，充分了解市场情况，并制定合理的交易策略。切勿盲目跟风或过度投资，避免造成不必要的损失。可以设置止损和止盈订单，控制风险。密切关注市场动态，及时调整交易策略。