Binance API：如何轻松上手？小白也能看懂的教程！

手册 81℃

Binance API 接口使用指南

Binance API 提供了对 Binance 加密货币交易所的编程访问接口。通过使用 API，开发者可以自动化交易策略、获取实时市场数据、管理账户信息等。 本文将介绍如何开始使用 Binance API，包括身份验证、常用API接口以及一些代码示例。

身份验证

使用 Binance API 的首要步骤是获取必要的 API 密钥。 这需要在你的 Binance 账户内创建一组 API 密钥对，包括一个 API 密钥（API Key）和一个 Secret 密钥（Secret Key）。

务必采取最高级别的安全措施妥善保管你的 Secret 密钥，绝对不要将其泄露给任何第三方。 Secret 密钥是用于对所有需要安全验证的 API 请求进行数字签名的关键凭证。一旦泄露，你的账户将直接暴露在严重的安全风险之下，可能导致资金损失或未经授权的操作。

Binance 强烈建议启用双重身份验证（2FA），进一步保护你的账户安全，即使 API 密钥泄露，也能在一定程度上降低风险。

  1. 使用你的用户名和密码安全地登录你的 Binance 账户。请确保你访问的是官方 Binance 网站，并检查 SSL 证书的有效性，以防钓鱼攻击。
  2. 导航至 Binance 账户的 "API 管理" 页面。通常可以在用户中心的设置或安全选项中找到。
  3. 在 API 管理页面，选择创建一个新的 API 密钥。 为了更好地管理和跟踪密钥用途，建议为每个 API 密钥添加描述性标签。
  4. 仔细配置 API 密钥的权限。Binance 提供了细粒度的权限控制，允许你根据应用程序的需求精确地定义 API 密钥可以执行的操作。例如，你可以授予仅读取市场数据的权限，或者授予进行交易的权限。 强烈建议仅授予必要的最小权限集，遵循“最小权限原则”以降低潜在的安全风险。
  5. 在成功创建 API 密钥后，立即安全地保存 API 密钥和 Secret 密钥。Secret 密钥只会显示一次，务必将其存储在安全的地方，例如加密的密码管理器或硬件安全模块（HSM）。请勿将 Secret 密钥存储在版本控制系统中或以明文形式保存在代码中。 如果遗失了 Secret 密钥，你将需要删除当前的 API 密钥并创建一个新的密钥对。

创建 API 密钥后，你需要将 API 密钥包含在你的 API 请求中。 API 密钥通常通过 X-MBX-APIKEY HTTP 头部传递。这是向 Binance 服务器验证你的身份的方式，表明你有权访问请求的资源。

示例 HTTP 请求头： 

GET /api/v3/ping HTTP/1.1
Host: api.binance.com
X-MBX-APIKEY: YOUR_API_KEY

对于需要签名的 API 请求，例如下单、取消订单或获取账户信息等涉及资金操作的请求，你需要使用 Secret 密钥对请求参数进行签名，以确保请求的完整性和真实性。 签名算法通常是 HMAC SHA256，这是一种广泛使用的加密哈希函数，可以生成消息的唯一数字指纹。

签名过程涉及以下步骤：

  1. 将所有请求参数（包括查询参数和 POST 数据）按照字母顺序排列。
  2. 将参数及其值连接成一个字符串。
  3. 使用 Secret 密钥作为密钥，使用 HMAC SHA256 算法对连接的字符串进行哈希运算。
  4. 将生成的签名作为 signature 参数添加到 API 请求中。

请参考 Binance API 文档，了解详细的签名算法实现细节和代码示例。 正确的签名对于成功进行 API 调用至关重要。

常用 API 接口

Binance API 提供了全面的编程接口，涵盖了广泛的功能，包括实时市场数据访问、便捷的交易执行和全面的账户管理。 开发者可以利用这些API构建自动交易机器人、数据分析工具以及集成到现有的交易平台。以下是一些常用的 API 接口，并进行了详细说明：

  • 市场数据 API (Market Data API): 用于获取最新的市场行情信息，例如实时价格、交易量、深度数据等。
    • GET /api/v3/ticker/price ：获取单个或所有交易对的最新价格。例如，可以使用此接口实时监控BTC/USDT的价格。
    • GET /api/v3/depth ：获取指定交易对的订单簿深度数据。 这对于理解市场的买卖压力至关重要。 开发者可以通过调整 limit 参数来获取不同深度的订单簿。
    • GET /api/v3/klines ：获取K线数据，也称为OHLCV（开盘价、最高价、最低价、收盘价、交易量）数据。 可以指定时间间隔，如1分钟、5分钟、1小时等，用于技术分析和图表绘制。
    • GET /api/v3/trades ：获取最近成交的交易记录。
  • 交易 API (Trade API): 允许用户进行交易操作，如下单、撤单、查询订单状态等。使用交易 API 需要进行身份验证。
    • POST /api/v3/order ：提交新的订单。可以指定交易对、订单类型（市价单、限价单等）、买卖方向、数量等参数。 例如，可以使用此接口以指定的价格买入或卖出比特币。
    • DELETE /api/v3/order ：撤销指定的订单。
    • GET /api/v3/order ：查询指定订单的状态。
    • GET /api/v3/openOrders ：查询当前所有未成交的订单。
    • GET /api/v3/allOrders ：查询所有订单，包括已成交和未成交的订单。
  • 账户 API (Account API): 用于管理用户的账户信息，如查询余额、获取交易历史、充值提现等。 使用账户 API 也需要进行身份验证。
    • GET /api/v3/account ：获取账户信息，包括各种币种的可用余额和冻结余额。
    • GET /api/v3/myTrades ：获取指定交易对的交易历史记录。
    • POST /wapi/v3/withdraw. ：提交提现请求（需要通过WAPI接口）。
    • GET /wapi/v3/depositHistory. ：查询充值历史记录（需要通过WAPI接口）。
    • GET /wapi/v3/withdrawHistory. ：查询提现历史记录（需要通过WAPI接口）。

1. 测试连接 (PING)

此接口旨在验证您的应用程序与我们的API服务器之间的网络连接是否稳定且可用。通过发送一个简单的请求并接收快速响应，您可以确认API端点正在运行并且可以正常通信。此功能对于在部署交易策略之前或在排除潜在问题时诊断连接问题至关重要。它有助于快速识别和解决任何网络延迟或连接中断，确保交易系统的可靠性和响应速度。 典型的PING请求不涉及任何数据传输，仅用于确认API服务器的在线状态。

Endpoint: /api/v3/ping HTTP 方法: GET

示例: 币安API Ping Endpoint 请求

以下展示了如何使用GET请求与币安API的 /api/v3/ping endpoint进行交互，以测试API连接的有效性。请注意，您需要提供有效的API密钥才能成功进行身份验证。 


GET /api/v3/ping HTTP/1.1
Host: api.binance.com
X-MBX-APIKEY: YOUR_API_KEY

详解:

  • GET /api/v3/ping HTTP/1.1 : 这是一个HTTP GET请求，目标是币安API的 /api/v3/ping endpoint。 HTTP/1.1 表示使用的HTTP协议版本。
  • Host: api.binance.com : Host 头部指定了API服务器的域名，即 api.binance.com 。这是HTTP 1.1 协议所必需的头部。
  • X-MBX-APIKEY: YOUR_API_KEY : X-MBX-APIKEY 头部用于API密钥身份验证。将 YOUR_API_KEY 替换为您从币安获取的实际API密钥。请妥善保管您的API密钥，避免泄露。

注意: /api/v3/ping endpoint不需要任何参数，并且如果服务器运行正常，将返回一个简单的JSON响应 {} 。 此endpoint通常用于检查API连接是否正常。 如果您未提供有效的 X-MBX-APIKEY 头部，您将会收到一个错误信息。

响应:

{}

响应是应用程序或系统对特定请求或事件的动作或输出。在加密货币领域，响应可能涉及多个方面，包括API请求、交易处理、智能合约执行以及网络状态更新。理解响应的内容和格式对于构建可靠的加密货币应用程序至关重要。

例如，当一个用户发起一笔交易时，区块链网络会生成一个包含交易哈希值的响应，确认交易已被接收。该响应允许用户追踪交易状态。如果API请求查询某个加密货币的价格，响应通常是一个JSON对象，其中包含价格、交易量和其他相关数据。对于智能合约，响应可能指示合约执行成功与否，以及相关的状态变更。

在API交互中，响应的状态码（如200 OK, 400 Bad Request, 500 Internal Server Error）提供有关请求处理结果的重要信息。开发人员应仔细处理不同类型的响应，以确保应用程序能够正确处理各种情况，例如网络错误、数据验证失败或服务器故障。

更进一步地，响应的安全性也至关重要。API响应应通过HTTPS等安全协议传输，以防止中间人攻击。对于敏感数据，例如私钥或账户余额，应进行加密处理，并在客户端进行安全存储。

2. 服务器时间 (Server Time)

此接口旨在提供币安服务器的当前时间戳。精确的时间同步对于与交易所进行有效交互至关重要，特别是当你的交易策略或API调用依赖于准确的时间戳时。利用此接口返回的时间，你可以校准本地系统时钟，最大限度地减少由于时间偏差导致的潜在问题，例如订单提交失败或数据分析不准确。 服务器时间以 Unix 时间戳格式返回，表示自 Unix 纪元（1970 年 1 月 1 日 00:00:00 UTC）以来经过的秒数。 开发者可以利用这个时间戳来同步其应用程序或交易机器人的时间，从而确保与币安服务器的时间保持一致，避免因时间不同步造成的交易错误。在构建高频交易系统或执行套利策略时，服务器时间接口尤其重要。

Endpoint: /api/v3/time HTTP 方法: GET

示例: 获取币安服务器时间

以下示例展示了如何通过 HTTP 请求获取币安服务器的当前时间。这是一个简单的 GET 请求，不需要任何请求参数，但需要有效的 API 密钥才能成功执行。

请求方法: GET

请求路径: /api/v3/time

HTTP 版本: HTTP/1.1

主机地址: api.binance.com

请求头: 


Host: api.binance.com
X-MBX-APIKEY: YOURAPIKEY

说明:

  • Host 头指定了请求发送的目标服务器。
  • X-MBX-APIKEY 头包含了你的币安 API 密钥。请务必替换 YOUR API KEY 为你实际的 API 密钥。 请注意保护你的API密钥，避免泄露！

预期响应:

服务器将返回一个 JSON 对象，包含服务器时间戳。 


{
  "serverTime": 1678886400000
}

serverTime 的值是一个 Unix 时间戳（毫秒）。

注意事项:

  • 此接口不需要任何参数。
  • 确保你的 API 密钥具有访问此端点的权限。
  • 请参考币安 API 文档获取更详细的信息，例如错误代码、速率限制等。
  • 某些编程语言或库可能需要特殊的设置来处理 HTTPS 请求。请确保你的环境配置正确。

响应:

该响应示例展示了一个API接口返回的服务器时间戳。 serverTime 字段表示服务器当前时间的Unix时间戳，单位为毫秒。 Unix时间戳是从协调世界时（UTC）1970年1月1日0时0分0秒起至现在的总毫秒数。 1678886400000 是一个具体的示例值，对应于某个特定时刻的时间戳。 开发者可以使用这个时间戳来进行时间同步、数据验证或者其他需要时间信息的应用场景。 不同的编程语言和平台都提供了将Unix时间戳转换为可读日期和时间格式的函数或方法。 例如，在JavaScript中，可以使用 new Date(1678886400000) 来创建一个表示该时间点的Date对象。 理解和正确处理时间戳对于构建可靠和精确的应用程序至关重要，特别是在涉及分布式系统和跨时区操作时。 时间戳的准确性直接影响到数据的同步和交易的顺序，尤其是在区块链和加密货币应用中。 因此，确保服务器时间与网络时间协议（NTP）同步是至关重要的。

3. 交易对信息 (Exchange Information)

此接口用于获取交易所支持的所有交易对的详细信息，包括但不限于交易对的符号、交易规则、价格精度、数量精度、交易手续费率以及最小交易单位等关键参数。这些信息对于构建自动化交易策略、风险管理系统以及进行市场分析至关重要。

通过该接口，开发者可以获取每个交易对的交易标的资产（base asset）和计价资产（quote asset），例如，在交易对 "BTC/USDT" 中，BTC 是交易标的资产，USDT 是计价资产。接口还会提供有关交易对交易规则的详细信息，例如，交易对是否支持市价单、限价单、止损单等交易类型，以及每种交易类型可能存在的限制。

价格精度（price precision）和数量精度（quantity precision）是进行交易计算时需要特别关注的参数。价格精度表示交易价格可以精确到的小数位数，数量精度表示交易数量可以精确到的小数位数。不遵守这些精度限制可能会导致交易失败或产生意外的交易结果。

接口还会提供交易手续费率（trading fee rate），该费率是指在进行交易时需要支付的手续费比例。不同的交易对可能具有不同的手续费率，了解这些费率有助于计算交易成本和优化交易策略。

最小交易单位（minimum trade size）是指允许进行的最小交易数量。该参数可以防止小额交易，并确保交易的经济可行性。开发者需要确保交易数量大于最小交易单位，否则交易可能会被拒绝。

Endpoint: /api/v3/exchangeInfo HTTP 方法: GET

示例: 获取交易所信息

一个用于获取币安交易所信息的HTTP请求示例。此请求使用了GET方法，并指定了API密钥进行身份验证。

请求方法: GET

请求路径: /api/v3/exchangeInfo

HTTP 协议版本: HTTP/1.1

Host: api.binance.com (币安API服务器地址)

头部信息:

  • X-MBX-APIKEY: YOUR API KEY ：用于身份验证的API密钥。 注意： 务必替换 YOUR API KEY 为您真实的API密钥。请妥善保管您的API密钥，避免泄露。泄露API密钥可能导致您的账户被盗用。

说明: 这个请求用于获取交易所的各种信息，包括交易对、交易规则、服务器时间等。成功响应将返回一个JSON对象，其中包含所需的信息。

重要提示： 请仔细阅读币安API文档，了解请求频率限制和其他使用条款。不遵守这些条款可能导致您的API密钥被禁用。

响应: (部分示例)

{ "timezone": "UTC", "serverTime": 1678886400000, "rateLimits": [ { "rateLimitType": "REQUESTWEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 1200 }, { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 160 } ], "exchangeFilters": [], "symbols": [ { "symbol": "BTCUSDT", "status": "TRADING", "baseAsset": "BTC", "baseAssetPrecision": 8, "quoteAsset": "USDT", "quotePrecision": 8, "quoteAssetPrecision": 8, "orderTypes": [ "LIMIT", "LIMITMAKER", "MARKET", "STOPLOSSLIMIT", "TAKEPROFITLIMIT" ], "icebergAllowed": true, "ocoAllowed": true, "quoteOrderQtyMarketAllowed": true, "allowTrailingStop": false, "cancelReplaceAllowed": false, "isSpotTradingAllowed": true, "isMarginTradingAllowed": true, "filters": [ { "filterType": "PRICEFILTER", "minPrice": "0.01000000", "maxPrice": "1000000.00000000", "tickSize": "0.01000000" }, { "filterType": "LOTSIZE", "minQty": "0.00000100", "maxQty": "9000.00000000", "stepSize": "0.00000100" }, { "filterType": "MINNOTIONAL", "minNotional": "10.00000000", "applyToMarket": true, "avgPriceMins": 5 }, { "filterType": "ICEBERGPARTS", "limit": 10 }, { "filterType": "MARKETLOTSIZE", "minQty": "0.00000000", "maxQty": "149.21558195", "stepSize": "0.00000000" }, { "filterType": "MAXNUMORDERS", "maxNumOrders": 200 }, { "filterType": "MAXNUMALGO_ORDERS", "maxNumAlgoOrders": 5 } ], "permissions": [ "SPOT", "MARGIN" ] } ] }

4. K线数据 (Kline/Candlestick Data)

此接口旨在检索指定交易对的 K 线（也称为蜡烛图）数据，这些数据是技术分析的基础。K 线图以图形方式显示特定时间段内的开盘价、最高价、最低价和收盘价，为交易者提供有价值的市场洞察。

通过此接口，用户可以灵活地定义时间间隔，例如 1 分钟 (1m)、5 分钟 (5m)、15 分钟 (15m)、30 分钟 (30m)、1 小时 (1h)、4 小时 (4h)、1 天 (1d)、1 周 (1w) 或 1 个月 (1M)。所选的时间间隔决定了每个 K 线代表的时间范围。例如，如果选择 1 小时的时间间隔，则每个 K 线将显示该小时内的开盘价、最高价、最低价和收盘价。

K 线数据对于各种技术分析技巧至关重要，包括识别趋势、发现支撑位和阻力位、以及识别图表模式。交易者可以利用这些数据来做出明智的交易决策并制定有效的交易策略。通过调整时间间隔，交易者可以根据自己的交易风格和时间范围对市场进行细粒度或更广泛的分析。该接口提供的灵活性使其成为从日内交易者到长期投资者的所有交易者的强大工具。

Endpoint: /api/v3/klines HTTP 方法: GET

参数:

  • symbol (必需): 交易对，用于指定需要查询历史K线数据的交易品种。例如， BTCUSDT 代表比特币兑美元的交易对。确保使用交易所支持的正确交易对符号。
  • interval (必需): 时间间隔，定义了每根K线的周期。常见的间隔包括：
    • 1m : 1分钟
    • 5m : 5分钟
    • 15m : 15分钟
    • 30m : 30分钟
    • 1h : 1小时
    • 4h : 4小时
    • 1d : 1天
    • 1w : 1周
    • 1M : 1月
    选择合适的间隔取决于你的分析需求和交易策略。
  • startTime (可选): 开始时间戳，以毫秒为单位表示。用于指定历史K线数据的起始时间。如果未提供，将从最早可用的数据开始。时间戳应该是一个整数，代表自 epoch (1970-01-01 00:00:00 UTC) 以来的毫秒数。
  • endTime (可选): 结束时间戳，以毫秒为单位表示。用于指定历史K线数据的结束时间。如果未提供，将返回到当前时间的K线数据。时间戳格式与 startTime 相同。
  • limit (可选): 返回的最大记录数。用于限制API返回的K线数据条数。默认值为 500 ，最大值为 1000 。 即使设置了更大的值，API 也只会返回最多 1000 条记录。 如果你需要更多的数据，则必须使用 startTime 和 endTime 分页查询。请注意，过大的 limit 值可能会影响 API 响应时间。

示例:

GET /api/v3/klines?symbol=BTCUSDT&interval=1m&limit=10 HTTP/1.1
此请求示例展示了如何通过币安API v3版本获取BTCUSDT交易对的K线数据。 其中， symbol=BTCUSDT 指定了交易对为比特币兑美元Tether。 interval=1m 参数设置了K线的时间间隔为1分钟。 limit=10 参数限制返回的K线数量为10条。 HTTP协议版本为1.1。

Host: api.binance.com
此行指定了请求发送的目标主机为 api.binance.com ，这是币安API的官方域名。 确保将请求发送到正确的域名至关重要，以避免潜在的安全风险和数据错误。

X-MBX-APIKEY: YOUR API KEY
此行包含了API密钥，用于身份验证和授权。 YOUR API KEY 需要替换为用户在币安平台获得的实际API密钥。 API密钥的安全性至关重要，请妥善保管，避免泄露。 务必不要将API密钥硬编码到公开的代码库中，并定期更换API密钥以增强安全性。 应根据实际需求配置API密钥的权限，遵循最小权限原则。

响应:

返回的 K 线数据（也称为蜡烛图数据）是一个二维数组，每个子数组代表一个时间周期的 K 线信息。以下是对数组中每个元素的详细解释：

[
[
1678886400000,      // 开盘时间 (Open Time): Unix时间戳（毫秒），表示此K线开始的时间。例如：1678886400000 代表 2023年3月15日 00:00:00 UTC。
"22000.00",          // 开盘价 (Open): 此时间周期开始时的交易价格。精度取决于交易对的设置。
"22100.00",          // 最高价 (High): 此时间周期内的最高交易价格。
"21900.00",          // 最低价 (Low): 此时间周期内的最低交易价格。
"22050.00",          // 收盘价 (Close): 此时间周期结束时的交易价格。
"100.00",             // 交易量 (Volume): 在此时间周期内交易的基础资产的数量。例如，对于 BTCUSDT 交易对，此值为交易的 BTC 数量。
1678886460000,      // 收盘时间 (Close Time): Unix时间戳（毫秒），表示此K线结束的时间。
"2205000.00",     // 报价资产交易量 (Quote Asset Volume): 在此时间周期内交易的报价资产的数量。 例如，对于 BTCUSDT 交易对，此值为交易的 USDT 数量。它是通过将每个交易的价格乘以其交易量，然后将所有这些值相加来计算得出的。
10,                 // 交易笔数 (Number of Trades): 在此时间周期内发生的交易总数。
"50.00",             // 主动买入的交易量 (Taker buy base asset volume): 在此时间周期内，由主动买入者（Taker）买入的基础资产的数量。
"1102500.00",     // 主动买入的交易额 (Taker buy quote asset volume): 在此时间周期内，由主动买入者买入的报价资产的数量。
"0"                   // 忽略 (Ignore): 此值为保留字段，当前无实际意义，可以忽略。
],
//  ... 更多 K 线数据
]

重要说明：

  • 时间周期：K 线的时间周期由请求 API 时指定的 interval 参数决定，例如 1m (1分钟), 5m (5分钟), 1h (1小时), 1d (1天) 等。
  • 数据类型：所有价格和交易量数据都以字符串形式返回，建议在使用时转换为数值类型进行计算。
  • 数据精度：返回的数据精度取决于交易所的设置。

5. 当前平均价格 (Current Average Price)

此接口用于获取指定交易对的当前平均价格，该平均价格的计算方式通常是基于近期一段时间内的成交量加权平均价格 (VWAP)。 这不同于最新成交价 (Last Traded Price)，后者仅代表最近一笔交易的价格。 平均价格能更准确地反映市场对该资产的共识价值，尤其是在价格波动剧烈时。

通过调用此接口，开发者可以获取一个平滑的价格指标，用于多种用途，例如：

  • 风险管理： 评估持仓价值，计算潜在盈亏，设定止损单和止盈单。
  • 算法交易： 作为算法交易策略的输入，例如均值回归策略或趋势跟踪策略。
  • 市场分析： 识别潜在的价格支撑位和阻力位，以及市场趋势。
  • 投资决策： 辅助判断当前市场情绪，并作出更明智的投资决策。

需要注意的是，不同的交易所或数据提供商计算平均价格的时间窗口可能不同，例如，可能使用5分钟、15分钟、1小时或者更长时间的数据。 因此，在使用此接口时，务必查阅相关文档，了解平均价格的具体计算方法和时间周期，确保数据的一致性和准确性。平均价格仅作为参考，不能完全依赖其进行交易决策，还需结合其他市场数据和自身风险承受能力进行综合判断。

Endpoint: /api/v3/avgPrice HTTP 方法: GET

参数:

  • symbol (required): 交易对，用于指定您希望进行交易的资产组合。例如， BTCUSDT 表示您想要交易的是比特币（BTC）与泰达币（USDT）的交易对。该参数是必需的，因为系统需要明确知道您要交易哪两种资产。请务必输入有效的交易对代码，否则交易请求可能会失败。不同交易所支持的交易对可能有所不同，请参考交易所的官方文档获取准确的交易对列表。

示例: 获取BTCUSDT的平均价格

以下是一个HTTP请求示例，用于从币安(Binance)交易所的API获取BTCUSDT交易对的平均价格。该请求使用GET方法，并需要提供有效的API密钥。请注意， X-MBX-APIKEY 头部是进行身份验证的关键，确保替换为您的实际API密钥。

请求: 

GET /api/v3/avgPrice?symbol=BTCUSDT HTTP/1.1
Host: api.binance.com
X-MBX-APIKEY: YOURAPIKEY

解释:

  • GET : HTTP请求方法，用于从服务器获取资源。
  • /api/v3/avgPrice : 币安API的端点，用于获取指定交易对的平均价格。 v3 指的是API的版本。
  • ?symbol=BTCUSDT : 查询参数，指定要查询的交易对为BTCUSDT（比特币兑美元）。
  • HTTP/1.1 : HTTP协议版本。
  • Host: api.binance.com : 指定请求的目标主机为 api.binance.com ，即币安API服务器。
  • X-MBX-APIKEY: YOUR API KEY : 一个自定义的HTTP头部，用于身份验证。 YOUR API KEY 需要替换为您在币安交易所生成的API密钥。这是访问需要授权API端点的必要条件。务必保管好您的API密钥，避免泄露。

该请求发送到币安API服务器后，服务器会返回一个JSON格式的响应，其中包含BTCUSDT的平均价格。请查阅币安API文档，了解响应的具体格式和字段含义。

响应:

该响应数据展示了一个加密货币交易对的实时价格信息，具体解释如下：

  • mins: 5

    表示该价格信息是基于过去5分钟内市场交易数据计算得出的。这通常用于衡量价格的短期波动性，并为交易者提供更及时的市场动态。更短的时间窗口（如1分钟）可能捕捉到更快速的价格变化，而更长的时间窗口（如15分钟或1小时）则可以平滑短期噪音，反映更稳定的趋势。

  • price: "22000.00"

    代表当前BTCUSDT交易对的价格为22000.00美元。这个价格通常是根据交易所的最新成交价或买卖盘口中间价计算得出。需要注意的是，交易所之间的价格可能存在轻微差异，这取决于交易深度和流动性。

  • symbol: "BTCUSDT"

    指明该价格信息对应的交易对。BTCUSDT表示比特币（BTC）与泰达币（USDT）的交易对。USDT是一种与美元挂钩的稳定币，常被用作加密货币交易的计价单位。其他常见的交易对包括ETHUSDT（以太坊/泰达币）、BNBUSDT（币安币/泰达币）等。交易对的选择取决于用户的交易策略和风险偏好。

总体而言，该响应提供了一个简洁明了的市场快照，交易者可以利用这些信息来制定交易策略，并根据市场变化调整其投资组合。实时数据对于高频交易和套利策略尤其重要。理解数据的含义和局限性至关重要，并需要结合其他技术指标和市场分析工具进行综合判断。

6. 下单 (New Order)

此接口用于在交易平台上创建一个新的订单，允许用户购买或出售加密货币。 此接口需要签名。 这意味着客户端需要使用私钥对请求进行签名，以验证身份并确保订单的完整性和安全性。签名机制通常涉及哈希算法和非对称加密技术，例如使用HMAC-SHA256算法结合API密钥和私钥对请求参数进行加密。正确实施签名机制对于防止未经授权的订单和数据篡改至关重要。

通过此接口，用户可以指定多种订单参数，例如：

  • 交易对 (Symbol): 指定要交易的两种加密货币，例如 BTC/USDT。
  • 订单类型 (Order Type): 指示订单的执行方式，例如市价单 (Market Order) 或限价单 (Limit Order)。市价单会立即以当前市场最佳价格成交，而限价单只有在达到指定价格时才会执行。
  • 委托方向 (Side): 指示是买入 (BUY) 还是卖出 (SELL)。
  • 数量 (Quantity): 指定要交易的加密货币数量。
  • 价格 (Price): 对于限价单，指定期望的成交价格。
  • 时间有效机制 (Time In Force, TIF): 指定订单有效的时间范围。常见的TIF类型包括：
    • GTC (Good Till Canceled): 订单一直有效，直到被取消。
    • IOC (Immediate Or Cancel): 订单必须立即全部成交，否则立即取消。
    • FOK (Fill Or Kill): 订单必须立即全部成交，否则整个订单将被取消。与IOC类似，但更加严格，必须一次性成交全部数量。
  • 客户端订单 ID (Client Order ID): 允许用户自定义订单ID，方便追踪和管理。
  • 止损价 (Stop Price): 仅适用于止损单，当市场价格达到或超过止损价时，将触发一个市价单或限价单。

成功创建订单后，接口会返回订单的相关信息，例如订单ID、成交价格、成交数量等。用户可以使用这些信息来跟踪订单的状态和执行情况。在调用此接口之前，开发者应仔细阅读API文档，了解各个参数的具体含义和要求，并进行充分的测试，以确保订单能够正确创建和执行。由于涉及到资金安全，务必对API密钥进行妥善保管，避免泄露。

Endpoint: /api/v3/order HTTP 方法: POST

参数:

  • symbol (必填): 交易对，指定交易的市场。 例如， BTCUSDT 表示比特币兑美元泰达币的交易对。 理解交易对的构成至关重要，因为它决定了你将买卖哪两种资产。
  • side (必填): 订单方向，指示你是要买入 ( BUY ) 还是卖出 ( SELL ) 指定的交易对。 BUY 表示你希望以基础货币（例如，BTCUSDT 中的 BTC）购买标价货币（例如，BTCUSDT 中的 USDT），而 SELL 则相反。
  • type (必填): 订单类型，定义订单的执行方式。 支持的订单类型包括：
    • LIMIT : 限价单，只有当市场价格达到或优于指定价格时才会执行。
    • MARKET : 市价单，会立即以当前市场最佳价格执行。
    • STOP_LOSS : 止损单，当市场价格达到指定止损价格时，会触发一个市价单。
    • STOP_LOSS_LIMIT : 止损限价单，当市场价格达到指定止损价格时，会触发一个限价单。
    • TAKE_PROFIT : 止盈单，当市场价格达到指定止盈价格时，会触发一个市价单。
    • TAKE_PROFIT_LIMIT : 止盈限价单，当市场价格达到指定止盈价格时，会触发一个限价单。
    • LIMIT_MAKER : 挂单，一种特殊的限价单，如果订单会立即成交，则不会被执行。 这种订单类型用于确保你始终是市场的做市商，而不是吃单者，从而可能获得更低的交易费用。
  • timeInForce (可选): 有效时间，定义订单在被执行前有效的时间长度。 仅当订单类型为 LIMIT , STOP_LOSS_LIMIT , 或 TAKE_PROFIT_LIMIT 时需要。 支持的有效时间包括：
    • GTC (Good Till Cancelled): 订单会一直有效，直到被执行或手动取消。
    • IOC (Immediate Or Cancel): 订单必须立即全部或部分执行，否则立即取消。
    • FOK (Fill Or Kill): 订单必须立即全部执行，否则立即取消。
  • quantity (必填): 订单数量，指定要买入或卖出的资产数量。 数量必须符合交易所规定的最小交易单位和步长。
  • price (可选): 订单价格，指定限价单的价格。 仅当订单类型为 LIMIT , STOP_LOSS_LIMIT , 或 TAKE_PROFIT_LIMIT 时需要。
  • stopPrice (可选): 止损价格，指定止损单或止盈单的触发价格。 仅当订单类型为 STOP_LOSS , STOP_LOSS_LIMIT , TAKE_PROFIT , 或 TAKE_PROFIT_LIMIT 时需要。
  • newClientOrderId (可选): 客户端订单 ID，允许你为订单分配一个自定义的 ID，方便后续跟踪和管理。 客户端订单 ID 必须是唯一的。
  • newOrderRespType (可选): 响应类型，指定服务器返回的订单响应信息的详细程度。 支持的响应类型包括：
    • ACK : 只返回订单已被接受的确认信息。
    • RESULT : 返回订单的详细信息，但不包括成交信息。
    • FULL : 返回订单的完整信息，包括成交信息。
  • recvWindow (可选): 接收窗口 (毫秒)。 用于指定服务器处理请求的时间限制，以防止由于网络延迟导致的重放攻击。 默认值为 5000 毫秒，最大值为 60000 毫秒。 建议根据你的网络环境进行调整。
  • timestamp (必填): 时间戳 (毫秒)。 订单发送的时间，用于验证订单的有效性。 时间戳必须在服务器允许的范围内，通常为当前时间前后一段时间。

签名:

为了确保API请求的安全性，需要对请求进行签名。签名过程涉及对所有请求参数（包括时间戳 timestamp 和接收窗口 recvWindow ）进行特定的处理。必须将所有参数按照字母顺序进行排序，这确保了签名的可预测性和一致性。排序完成后，将这些参数按照排序后的顺序连接成一个单独的字符串。这个字符串将作为HMAC SHA256算法的输入。

接下来，使用你的Secret密钥作为HMAC SHA256算法的密钥，对连接后的字符串进行加密。HMAC SHA256是一种哈希消息认证码算法，它使用密钥来生成消息的哈希值，用于验证消息的完整性和真实性。生成的哈希值就是签名。

将生成的签名作为 signature 参数添加到API请求中。服务器端会使用相同的Secret密钥和算法，对接收到的请求参数进行签名，然后将生成的签名与请求中包含的 signature 参数进行比较。只有当两个签名完全匹配时，服务器才会认为该请求是有效的，并进行处理。这有效地防止了恶意用户篡改请求参数，确保了API的安全性和可靠性。

示例: 创建订单 (POST 请求)

此示例展示如何使用 POST 请求在币安 API v3 版本中创建一个市价买单。务必替换示例中的 YOUR_API_KEY 和 YOUR_SIGNATURE 为你自己的实际值。 

POST /api/v3/order HTTP/1.1
Host: api.binance.com
X-MBX-APIKEY: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded

请求头解释:

  • POST /api/v3/order HTTP/1.1 : 指定使用 POST 方法访问 /api/v3/order 端点，协议版本为 HTTP/1.1。
  • Host: api.binance.com : 指定请求的目标主机为币安 API 服务器。
  • X-MBX-APIKEY: YOUR_API_KEY : 你的 API 密钥，用于身份验证。 请勿分享你的 API 密钥！
  • Content-Type: application/x-www-form-urlencoded : 指定请求体的数据格式为 URL 编码。

请求体示例: 

symbol=BTCUSDT&side=BUY&type=MARKET&quantity=0.01&timestamp=1678886400000&signature=YOUR_SIGNATURE

请求体参数解释:

  • symbol=BTCUSDT : 交易对，这里是比特币兑泰达币 (BTCUSDT)。
  • side=BUY : 交易方向， BUY 表示买入。
  • type=MARKET : 订单类型， MARKET 表示市价单，将以当前市场最佳价格成交。
  • quantity=0.01 : 买入的数量，这里是买入 0.01 个比特币。
  • timestamp=1678886400000 : 时间戳，表示请求发送的时间，以毫秒为单位的 Unix 时间戳。确保时间戳的准确性。
  • signature=YOUR_SIGNATURE : 请求签名，用于验证请求的完整性和真实性。签名需要使用你的 Secret Key 对所有参数进行哈希计算，确保安全性。

重要提示: 签名 ( signature ) 的生成至关重要。签名算法通常涉及对所有参数进行排序，然后使用你的 Secret Key 进行 HMAC SHA256 哈希。请参考币安 API 文档获取详细的签名生成方法和代码示例。不正确的签名会导致请求失败。

响应 (RESULT):

{
"symbol": "BTCUSDT",
// 交易对，表示本次成交的交易标的。例如：BTCUSDT 代表比特币/USDT 交易对。

"orderId": 123456789,
// 订单 ID，是由交易所分配的唯一标识符，用于跟踪该笔订单的生命周期。

"orderListId": -1,
// 订单列表 ID。 除非是 OCO (One-Cancels-the-Other) 订单，否则该值始终为 -1。 OCO 订单允许用户同时挂两个订单，一旦其中一个订单成交，另一个订单将会被自动取消。

"clientOrderId": "YOUR CLIENT ORDER_ID",
// 客户端订单 ID，是用户自定义的订单标识符，允许用户根据自己的逻辑进行订单管理和追踪。如果您在下单时指定了 clientOrderId，该值将会被返回。

"transactTime": 1678886400000,
// 交易时间戳，表示订单成交的具体时间，以 Unix 时间戳（毫秒）格式表示。上述例子代表 2023年3月15日 00:00:00 (UTC)。

"fills": [
{
"price": "22000.00",
// 成交价格，表示该笔成交的实际交易价格。

"qty": "0.01",
// 成交数量，表示该笔成交的交易数量。

"commission": "0.0001",
// 手续费，表示该笔成交所需支付的手续费金额。

"commissionAsset": "USDT",
// 手续费资产类型，表示手续费所使用的币种。例如：USDT 代表手续费以 USDT 结算。

"tradeId": 987654321
// 交易 ID，表示该笔成交的唯一标识符。
}
]
}

代码示例 (Python)

导入必要的Python库，包括用于加密的 hashlib 和 hmac ，用于时间管理的 time （尽管本示例未使用），以及用于发送HTTP请求的 requests 。

import hashlib import hmac import time # 虽然本示例未使用，但通常在涉及时间相关逻辑时会用到 import requests

接下来，定义API密钥和密钥，以及Binance API的基础URL。 请务必妥善保管您的API密钥和密钥，切勿泄露！ 为了安全起见，建议将这些密钥存储在环境变量中，而不是直接硬编码在脚本中。

API_KEY = "YOUR_API_KEY" # 替换为您的API密钥 SECRET_KEY = "YOUR_SECRET_KEY" # 替换为您的密钥 BASE_URL = "https://api.binance.com"

generate_signature(data, secret_key) 函数用于使用HMAC-SHA256算法为给定的数据生成签名。 这对于验证请求的完整性和真实性至关重要，可以防止恶意篡改。 该函数将密钥和数据都编码为UTF-8，以确保正确处理各种字符集。

def generate_signature(data, secret_key): """Generates a signature for the given data using the secret key.""" encoded_key = secret_key.encode('utf-8') encoded_data = data.encode('utf-8') signature = hmac.new(encoded_key, encoded_data, hashlib.sha256).hexdigest() return signature

get_server_time() 函数从Binance服务器获取当前时间。 这对于确保请求中的时间戳与服务器时间同步非常重要，因为Binance对时间戳的偏差有一定的容忍度。 如果客户端时间与服务器时间偏差过大，请求将被拒绝。 函数通过 X-MBX-APIKEY 头传递API密钥进行身份验证，并使用 requests.get 发送GET请求。 response.raise_for_status() 会检查HTTP响应状态码，如果返回错误状态码（如400或500），则引发异常。

def get_server_time(): """Gets the server time from Binance.""" url = f"{BASE_URL}/api/v3/time" headers = {"X-MBX-APIKEY": API_KEY} response = requests.get(url, headers=headers) response.raise_for_status() # 检查HTTP状态码是否成功 return response.()['serverTime']

create_order(symbol, side, type, quantity, price=None) 函数用于在Binance上创建新订单。 它接受交易对代码（ symbol ），买卖方向（ side ，如 BUY 或 SELL ），订单类型（ type ，如 MARKET 或 LIMIT ），数量（ quantity ）和价格（ price ，仅适用于限价单）作为参数。该函数首先获取服务器时间戳，然后构建包含订单参数的字典。 对于限价单，它还会设置 timeInForce 参数为 GTC （Good Till Cancelled），这意味着订单将一直有效，直到被执行或取消。

def create_order(symbol, side, type, quantity, price=None): """Creates a new order on Binance.""" timestamp = get_server_time() params = { "symbol": symbol, "side": side, "type": type, "quantity": quantity, "timestamp": timestamp } if price: params["price"] = price params["timeInForce"] = "GTC" # Good Till Cancelled 

# 构建查询字符串，用于生成签名。 字典中的键值对被转换为 "key=value" 格式的字符串，并用 "&" 符号连接起来。
query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
# 使用密钥和查询字符串生成签名。
signature = generate_signature(query_string, SECRET_KEY)
# 将签名添加到参数字典中。
params["signature"] = signature

# 构建完整的API URL。
url = f"{BASE_URL}/api/v3/order"
# 设置请求头，包含API密钥。
headers = {"X-MBX-APIKEY": API_KEY}
# 使用POST方法发送请求，包含请求头和参数。
response = requests.post(url, headers=headers, params=params)
# 检查HTTP状态码是否成功。
response.raise_for_status()
# 返回响应的JSON数据。
return response.()

示例用法:

获取服务器时间

在区块链应用开发中，同步客户端时间与服务器时间至关重要。这确保了交易的有效性和时间戳的准确性。 get_server_time() 函数用于从区块链节点获取服务器时间。

函数示例： 

server_time = get_server_time()
print(f"服务器时间: {server_time}")

代码解释：

  • get_server_time() ：该函数调用区块链节点的API，获取当前服务器的时间。
  • server_time ：将获取到的服务器时间存储在名为 server_time 的变量中。 这个时间通常以Unix时间戳（自1970年1月1日以来经过的秒数）的形式返回。
  • print(f"服务器时间: {server_time}") ：使用 f-string 格式化字符串，将服务器时间打印到控制台。

重要提示：

  • 服务器时间通常以UTC（协调世界时）表示。
  • 请确保你的代码处理了可能出现的网络延迟或连接错误，以便能够可靠地获取服务器时间。 如果无法连接服务器，应该提供错误处理机制，例如重试或使用默认时间戳。
  • 在生产环境中，建议定期同步客户端时间与服务器时间，以防止时间偏差导致的问题。 使用NTP（网络时间协议）也是同步时间的常用方法。
  • 为了安全性，不应完全依赖客户端时间，而是以服务器时间为准进行关键操作的时间验证。

创建一个市价买入订单

以下代码演示了如何使用 Python 和 CCXT 库创建一个针对特定交易对（例如 BTCUSDT）的市价买入订单。市价订单将以当前市场上最佳可用价格立即执行，确保快速成交。

symbol="BTCUSDT" 指定了要交易的交易对，这里是比特币 (BTC) 兑 USDT (Tether)。 side="BUY" 表明这是一个买入操作，而 type="MARKET" 则指定订单类型为市价单。 quantity=0.001 定义了要购买的比特币数量，单位为 BTC。

为了处理可能出现的错误，代码使用了 try-except 块。如果在创建订单的过程中发生任何 HTTP 错误（例如，连接问题、授权失败或服务器错误），将会捕获 requests.exceptions.HTTPError 异常，并打印出错误的详细信息，帮助用户调试。 


try:
  order = create_order(symbol="BTCUSDT", side="BUY", type="MARKET", quantity=0.001)
  print(f"订单创建成功: {order}")
except requests.exceptions.HTTPError as e:
   print(f"创建订单时出错: {e.response.text}")

这段代码的核心在于 create_order 函数，它负责与交易所的 API 交互。此函数需要根据你所使用的 CCXT 交易所对象和对应的 API 文档进行适当的配置和实现，比如需要传入API Key和Secret Key进行身份验证。 order 变量将包含交易所返回的订单详细信息，包括订单 ID、成交价格、成交数量等。

请注意，在真实交易环境中，务必谨慎设置交易数量，并充分了解交易所的交易规则和风险提示。建议使用测试网络（testnet）进行初步验证，以避免因代码错误导致不必要的资金损失。

创建一个限价卖出订单

该示例展示了如何在加密货币交易所创建一个限价卖出订单，以便在指定价格或更高价格卖出一定数量的加密货币。限价订单允许交易者设定期望的最低卖出价格，只有当市场价格达到或超过该价格时，订单才会被执行。

代码解释：

try: 语句块尝试执行创建订单的操作。如果订单创建成功，将打印订单信息。如果出现错误，则执行 except 语句块。

order = create_order(symbol="BTCUSDT", side="SELL", type="LIMIT", quantity=0.001, price=30000) 调用 create_order 函数来创建订单。各参数的含义如下：

  • symbol="BTCUSDT" : 指定交易对为 BTCUSDT，即比特币兑泰达币。不同的交易所可能使用不同的交易对符号。
  • side="SELL" : 指定订单方向为卖出。这意味着我们希望卖出 BTC，换取 USDT。
  • type="LIMIT" : 指定订单类型为限价订单。限价订单允许我们设定期望的卖出价格。
  • quantity=0.001 : 指定卖出的 BTC 数量为 0.001 个比特币。交易所有最小交易数量的限制，低于此限制的订单可能无法创建。
  • price=30000 : 指定卖出价格为 30000 USDT。只有当市场价格达到或超过 30000 USDT 时，该订单才会被执行。

print(f"Order created successfully: {order}") : 如果订单创建成功，则打印订单信息。 order 变量包含交易所返回的订单详细信息，如订单 ID、状态、交易价格等。

except requests.exceptions.HTTPError as e: 语句块捕获因 HTTP 请求错误而引发的异常。这通常表示与交易所 API 的通信出现了问题，例如权限不足、参数错误或服务器错误。

print(f"Error creating order: {e.response.text}") : 如果创建订单时发生错误，则打印错误信息。 e.response.text 包含交易所返回的详细错误信息，有助于诊断问题。

注意事项：

  • 在实际交易中，请务必仔细检查订单参数，特别是价格和数量，以避免意外损失。
  • 在创建订单之前，请确保您的账户有足够的 BTC 用于卖出。
  • 不同的交易所 API 可能有不同的参数和错误处理方式。请参考交易所的 API 文档进行调整。
  • 该示例使用了 requests 库来处理 HTTP 请求。您需要安装该库才能运行此代码。
  • 交易所有订单簿深度，如果挂单价格离市价过远，可能长时间无法成交。

请注意:

  • 请务必将代码中的 YOUR_API_KEY 和 YOUR_SECRET_KEY 替换成你在币安平台申请的真实API密钥和Secret密钥。API密钥用于身份验证，Secret密钥用于签名请求，保证交易安全。请妥善保管你的API密钥和Secret密钥，避免泄露，否则可能导致资产损失。
  • 此代码示例仅作为演示如何与币安API交互的示例，仅用于教学目的。在实际生产环境中部署和使用时，你需要加入更加完善的错误处理机制、异常捕获逻辑以及更健全的输入验证，以应对各种潜在的错误情况，例如网络连接失败、API请求超时、无效的API密钥、订单参数错误等。同时，需要考虑重试机制，以便在出现临时性问题时自动重试。
  • 强烈建议在进行任何实际交易之前，先在币安的测试网络 (Testnet) 上进行充分的测试。测试网提供一个模拟的交易环境，你可以使用模拟的数字货币进行交易，从而熟悉API的使用方法，验证你的交易策略，而无需承担任何真实的资金风险。可以通过币安官方网站申请测试网的API密钥。

本指南旨在为你提供一个快速入门币安API的基础介绍，帮助你开始构建自己的交易程序。完整的API文档包含了所有可用的API接口、参数说明、请求示例和返回数据格式，请务必参考币安官方网站上发布的最新API文档。在使用API时，请根据你的具体交易需求和策略，仔细研究文档，选择合适的API接口，并理解其使用方法和限制。同时，注意阅读API的使用条款和风险提示。

上一篇

想参与币安治理？快速上手指南！你也能影响决策！

下一篇

Bitfinex安全漏洞深度剖析：7200万美元盗窃案启示录！

相关推荐