API Bitfinex

Bitfinex

Bitfinex 是全球最大、最先进的加密货币交易平台之一。用户可以交易比特币、以太坊、瑞波币、EOS、比特币现金、Iota、NEO、莱特币、以太坊经典等。

Bitfinex WebSocket API 版本为 2.0

通过 Bitfinex WebSocket 频道发送和接收的每条消息均以 JSON 格式编码

交易对可以是交易对或保证金货币：

交易对符号的组成方式是在货币对前加上字母 "t"（例如 tBTCUSD、tETHUSD）。
保证金货币符号在货币前加前缀 "f" （例如 fUSD、fBTC……）

连接成功后，触发 OnBitfinexConnect 事件，并以 Bitfinex API 版本号作为参数。

您可以调用 Ping 方法来测试与服务器的连接。

如果服务器发送任何信息，可通过 OnBitfinexInfoMessage 事件处理，其中 Code 和 Message 是包含服务器发送消息信息的参数。示例代码：

20051：停止/重启 WebSocket 服务器（请重新连接）

20060：正在进入维护模式。请暂停所有活动，并在收到信息消息 20061 后恢复（最多需要 120 秒）。

20061：维护已结束，您可以恢复正常活动。建议重新取消订阅并订阅所有频道。

如果发生错误，将引发 OnBitfinexError，并提供错误信息。示例错误代码：

10000：未知事件

10001：未知交易对

要更改配置，请调用 Configuration 方法，并传入以下标志之一作为参数：

CS_DEC_S = 8; // Enable all decimal as strings.

CS_TIME_S = 32; // 将所有时间启用为日期字符串。

CS_SEQ_ALL = 65536; // 启用排序测试功能

CHECKSUM = 131072; // 对每次订单簿迭代启用校验和。检查订单簿每一侧的前 25 条。校验和为有符号整数。

订阅公共频道

部分通道是公开的，无需对服务器进行认证。所有消息均通过 OnBitfinexUpdate 事件触发。

SubscribeTicker

行情是对市场状态的高层概览，显示当前最优买卖价及最新成交价，并包含日成交量及过去一天的价格变动等信息。


// Trading pairs
[
  CHANNEL_ID,
  [
    BID,
    BID_SIZE,
    ASK,
    ASK_SIZE,
    DAILY_CHANGE,
    DAILY_CHANGE_PERC,
    LAST_PRICE,
    VOLUME,
    HIGH,
    LOW
  ]
]
// Funding pairs
[
  CHANNEL_ID,
  [
    FRR,
    BID,
    BID_PERIOD,
    BID_SIZE,
    ASK,
    ASK_PERIOD,
    ASK_SIZE,
    DAILY_CHANGE,
    DAILY_CHANGE_PERC,
    LAST_PRICE,
    VOLUME,
    HIGH,
    LOW
  ]
]

SubscribeTrades

每当 Bitfinex 发生交易时，该频道就会发送一条成交消息，包含成交的所有相关详情，如价格、数量和时间。


// on trading pairs (ex. tBTCUSD)
[
  CHANNEL_ID,
  [
    [
      ID,
      MTS,
      AMOUNT,
      PRICE
    ],
    ...
  ]
]
// on funding currencies (ex. fUSD)
[
  CHANNEL_ID,
  [
    [
      ID,
      MTS,
      AMOUNT,
      RATE,
      PERIOD
    ],
    ...
  ]
]

SubscribeOrderBook

Order Books 频道允许您跟踪 Bitfinex 订单簿的状态。它以价格聚合为基础提供，精度可自定义。收到响应后，您将收到订单簿的快照，随后在订单簿发生任何变化时收到更新。


// on trading pairs (ex. tBTCUSD)
[
  CHANNEL_ID,
  [
    [
      PRICE,
      COUNT,
      AMOUNT
    ],
    ...
  ]
]
  
// on funding currencies (ex. fUSD)
[
  CHANNEL_ID,
  [
    [
      RATE,
      PERIOD,
      COUNT,
      AMOUNT
    ],
    ...
  ]
]

SubscribeRawOrderBook

这些是粒度最细的订单簿。


// on trading pairs (ex. tBTCUSD)
[
  CHANNEL_ID,
  [
    [
      ORDER_ID,
      PRICE,
      AMOUNT
    ],
    ...
  ]
]
  
// on funding currencies (ex. fUSD)
[
  CHANNEL_ID,
  [
    [
      OFFER_ID,
      PERIOD,
      RATE,
      AMOUNT
    ],
    ...
  ]
]

SubscribeCandles

提供访问图表蜡烛图信息的方式。时间框架：

1m：一分钟

5m：五分钟

15m：15 分钟

30m：30 分钟

1h：一小时

3h：3 小时

6h：6 小时

12h：12小时

1D：一天

7D：一周

14D：两周

1M：一个月


[
  CHANNEL_ID,
  [
    [
      MTS,
      OPEN,
      CLOSE,
      HIGH,
      LOW,
      VOLUME
    ],
    ...
  ]
]

订阅已认证频道

此频道允许您实时了解账户状态。您可以接收关于持仓、余额、订单和交易的更新。

使用 Authenticate 方法对服务器进行身份验证并设置所需参数。

认证成功后，您将收到以下内容的更新：订单、仓位、成交、资金报价、资金信用、资金贷款、钱包、余额信息、保证金信息、资金信息、资金成交……

如果您想从服务器注销，可以调用 UnAuthenticate 方法。