Skip to main content

HitBTC Trade Connector

Features​

crypto-hitbtcConnector Key
Instruments
FXFUTURE
Request Types
SUBMITCANCELREPLACE
Order Types
MARKETLIMITSTOP_LIMIT
Time In Force
GTCIOCFOKDAYGTD
Order ID Mapper
SEQUENCE
✗
Order Status Request
✗
Cancel On Disconnect
✓
Commission
✓
Post Only
✓
Fast Cancel
✓
Fast Replace

Notes​

Rate limits​

The following Rate Limits are applied:

  • For the Market data, the limit is 100 requests per second for one IP;
  • For Trading, the limit is 300 requests per second for one user;
  • For other requests, including Trading history, the limit is 10 requests per second for one user.

Margin trading​

Margin trading is supported over WebSocket. Enable it with:

tradingType = MARGIN

Futures trading​

Futures trading is supported over WebSocket. Enable it with:

tradingType = FUTURES

ClientOrderId​

Must be between 8 and 32 characters (inclusive).

Display Quantity​

The only valid value is "0". For some symbols display_quantity is unavailable. In that case, a reject event is returned from the exchange with a "symbol code not supported" message.

Symbology​

Currency pairs without separator, e.g. ETHBTC.

Pairs can be retrieved via the API: https://api.hitbtc.com/api/3/public/symbol

Configuration​

Connector settings​

ParameterDefault ValueDescription
tradingTypeSPOTAllow to trade in Margin mode. Supported values: SPOT, MARGIN, FUTURES.
marginModeISOLATEDDefault margin mode. Supported values: ISOLATED, CROSS.

Config sample​

connectors {
  HITBTC: ${template.connector.crypto.hitbtc}{
    settings: {
      restUrl = "https://api.hitbtc.com"
      websocketUrl = "wss://api.hitbtc.com/api/3/ws/trading"

      tradingType = SPOT # valid values: SPOT, MARGIN, FUTURES
      marginMode = ISOLATED # valid values: ISOLATED, CROSS

      apiKeys: [{
        apiKey = "<API_KEY>"
        apiSecret = "<API_SECRET>"
      }]
    }
  }
}