币安API系列第I部分 – 使用Postman进行现货交易

导语

这一系列文章旨在介绍币安推出的REST API并演示具体的交互方法。经过学习，您可以游刃有余地查询有关市场和头寸的信息并下达各种不同类型的订单。

先决条件

测试网密钥

演示过程将在测试网中完成，事先可以领取没有任何实际价值的虚拟资金，它们的功能与真实货币和代币完全相同。在您熟练使用这款API后，即可通过其交易真实资金。

1. 首先，登录现货测试网络。
2. 如需获得访问权限，应使用GitHub帐户登录。如果是新用户，请首先创建GitHub帐户。
3. 点击验证并通过GitHub登录。
4. 在API密钥目录下，系统将通知您尚未注册密钥。点击生成HMAC_SHA256密钥，创建密钥对。
5. 在下一个画面中，为密钥添加标签。您可以随意取名，然后点击生成。
6. 此时可以看到两个密钥：API密钥和加密密钥。请将这两项重要内容记录下来，否则您将需要重新再创建一组密钥。我们建议将其存储在计算机的记事本程序中，以便日后轻松复制粘贴。

下载并安装Postman

Postman是一种API协作平台。对我们来说，它是一个完美的起点——不必编写任何代码，即可通过Postman访问我们需要测试的币安请求集合。

下载完毕后，请在文件浏览器中找到该文件并进行安装。然后启动应用程序，即可完成操作。请注意，您可以通过创建帐户登录程序，但创建账户并非必要的步骤。如果您想要跳过该步骤，只需选择窗口底部的选项即可。

创建环境

在此阶段，屏幕中应显示类似于下图的界面。

下载过程应该很快。在文件浏览器中找到该文件并解压。然后，即可返回Postman。

1. 选择导入并转至刚刚提取的文件夹（“binance-postman-api”）。
2. 进入文件夹并选择环境文件夹。
3. 您将看到两个文件（分别应用于主网和测试网）。此时，我们选择binance_com_spot_testnet_api.postman_environment.json。必须输入正确的密码，因为两个密码不能混用。

此画面中的“时间戳”和“签名”字段为空，具体值将在每次请求时自动创建。

导入集合

现在我们导入集合——其中包含各种各样的请求，在我们调用时执行繁重而复杂的任务。如需将其载入我们的环境：

1. 点击左上角的导入。
2. 在弹出窗口的文件选项卡下，选择上传文件。
3. 再次找到binance-postman-api文件夹并将其打开。
4. 此时，请在子目录中输入集合。
5. 画面中再次出现两个文件：其中一个适用于期货API，而我们需要使用现货文件，因此请选择binance_spot_api_v1.postman_collection.json文件。
6. 现在应显示确认画面，显示导入的集合被标识为Postman集合格式。选择“导入”。

在窗口左侧的“集合”选项卡下，可以找到一个存储100多种请求的文件夹。恭喜您，导入成功！在下一节中，我们将详细说明可以提出的各种请求。

提出请求

如果在“集合”选项卡下展开文件夹，可以看到许多不同的请求。根据颜色编码，我们一般可以使用三种方法：

• GET：GET方法用于检索服务器中的内容。我们通过其查询帐户余额和资产价格等信息。
• POST：我们通常使用POST方法在服务器中创建信息，为下订单和请求提现等操作提供帮助。
• DELETE：DELETE方法是请求服务器删除信息，可在取消订单时发挥重要作用。

查询资产列表和交易规则

现在我们提出第一项请求！我们将获得可以在交易平台交易的资产以及交易规则：

GET/exchangeInfo

这项请求不需要其他任何参数，将其复制粘贴到地址栏即可获得响应。如果是包含多项参数的请求，则可通过Postman轻松查看和修改。

在最上方高亮显示的部分，会显示一些重要信息：

• 响应状态（200表示操作成功，400-499表示遇到问题）

• 响应接收时间（不到1秒）

• 响应文本大小（约为22 KB）。

第二个框是响应的容量。为了便于阅读和学习，我们进行了仔细编排——其中包含交易平台信息、可以交易的货币对及其最低/最高金额。

信息量貌似很大，但这种格式很容易通过编程处理。在编写交互脚本时，您将可以轻松地从响应中选择特定元素的特定属性。

查看帐户余额

在此处可以查看所持资产以及对应的金额：

GET/account

恭喜您获得了新资产！（但实际并不存在）

如何获取资产的当前价格

我们可以通过不同方式获取资产的当前价格。最简单的可能是通过以下请求：

GET /api/v3/ticker/24hr

GET /api/v3/price

与之前一样，您可以更改或完全删除资产变量，获得所有资产的最新价格。

查看当前订单簿深度

订单簿深度（也称为市场深度或DOM）蕴藏着许多市场信息。我们可以调用以下请求来获得这些有效信息：

GET api/v3/depth

当我们以默认值（市场 > 订单簿）发送这项请求时，它将告知我们有关BTCUSDT的出价与需求。测试网服务器产生的数据量低于实际，因此下面是在实际环境中显示的屏幕截图：

在上方高亮显示的部分中，可以看到第一笔出价。我们查看的是BTCUSDT的订单簿，上面的数字是某位交易者愿意用来支付比特币的价格，下方则是其愿意购买的数量。因此，该数据表示这份订单请求以9704.65 USDT的单价买入0.999枚BTC。继续向下观察，可以看到价格由高到低排列，代表买方的出价逐渐降低。

想让自己的资产物有所值，最高报价自然最具吸引力。也是就是说，如果在市场中出售3枚BTC，其中只有0.999枚BTC能够以最高的价格出售。剩余部分需要按后续更低的报价出售，直至整个订单成交。

发布测试订单

现在我们发布测试订单。

POST api/v3/order/test

您可以看到更多参数。我们来浏览一下选中的参数：

• symbol – 上文中已经有所介绍，表示需要交易的货币对。
• side – 在此处指定BUY或SELL。对于BTCUSDT交易对，BUY表示以USDT购买BTC，SELL则是出售USDT来换取BTC。
• type – 需要提交的订单类型。可能的数值（点击此处了解详情）：
  • LIMIT
  • MARKET
  • STOP_LOSS
  • STOP_LOSS_LIMIT
  • TAKE_PROFIT
  • TAKE_PROFIT_LIMIT
  • LIMIT_MAKER
• timeInForce– 此参数表示预期的订单执行方式：
  • GTC（取消前有效）– 这是最受欢迎的设置。GTC将确保订单在成交或取消前始终有效。
  • FOK（全部成交或取消）– FOK指示交易平台立即执行整张订单。如果无法执行操作，订单立即取消。
  • IOC（立即成交或取消）– 订单将立即全部或部分执行，否则将会取消。与FOK不同的是，如果订单可以部分执行，则不会取消。
• quantity – 就是指需要购买或出售的资产数量。
• price – 目标出售价格。在BTCUSDT交易对中，价格以USDT表示。
• newClientOrderId – 订单标识。这不是必填字段，但可以将其设置为某个标识，以便日后查询。否则，它将由交易平台随机生成。

发布真实订单

现在我们发布真实的虚拟订单。

POST /api/v3/order

如果交易成功，您的响应将返回有关订单的一系列详细信息。

查看未结订单状态

在上一章节中，我们已收到订单发布成功的确认，那如果我们后来想要查看订单，该怎么操作呢？有几项请求可供我们使用。

GET /api/v3/openOrders

GET /api/v3/allOrders

最后，可以使用以下请求查询特定订单：

GET /api/v3/order

取消订单

经过一段时间，我们可能认为4万美元的目标过于乐观，因而希望取消该订单。在这种情况下，需要使用：

DELETE /api/v3/order

发布即时成交的订单

下面，您可以看到我们即将提交一份市价单，按当前市场价出售BNB来换取BUSD。

请注意，该响应仅向我们提供了最简洁的信息：

检查您的交易

最后，我们了解一下检查交易的端点：

GET /api/v3/myTrades

使用Postman进行调试

Postman中可以详细显示原始HTTP请求和响应。

通过此菜单可打开Postman控制台，打印出每项请求的详细信息。

总结

本教程旨在简要介绍如何在不编写代码的情况下，使用币安API。如果已经详细阅读本文，现在应该对如何请求和提交信息有所了解。