Bitfinex™ is a Hong Kong based digital currency exchange that supports about 200 crypto
currencies and partially free API access. With Zorro
S, the Bitfinex API plugin can be used with or without a
Bitfinex account; in the latter case only price data and history is available.
For opening a Bitfinex account, visit
https://bitfinex.com/ and apply. Demo accounts are not available - you must
really deposit some bitcoin or dollar amount. You can set up the bitcoin symbol and the
number of decimals to display in prices in the account
list. For acessing your
account via API, you will need a public and a private key since all API
commands must be hash signed. The steps:
- Login to Bitfinex, in locate the gear icon in the upper-right of the
page and click it.
- Select API Keys and click on
Create New Key to create your
- Select the permissions of the key. For trading, enable "ACCOUNT INFO",
"ACCOUNT HISTORY", and "ORDERS" (or just enable everything).
You're now all set to trade with the Bitfinex plugin. The plugin uses API
version 1.1 for trading and prices, and API 2.0 for history.
|| Bitfinex API key, or empty for accessing live prices only
|| Bitfinex Secret, or empty for accessing live prices only
Bitfinex asset symbols
The Bitfinex plugin requires symbols in the usual forms XXX/BTC or XXXBTC, where BTC is the
currency and XXX the currency to trade. An asset list AssetsBitfinx.csv
with about 100 main cryto currencies is included.
Supported broker commands
The Bitfinex plugin supports the brokerCommand function with the following commands:
More commands can be implemented on user request.
Known Bitfinex API issues
- Price data. Only a few minutes are available
with API 1.1,
so when trading systems need price history, it must be downloaded with API
2.0 by calling the FROM_BITTREX
assetHistory function. For getting live volume, use the
SET_VOLTYPE command with parameter 4.
- Asset parameters. All data besides spread and price must
be manually entered in the asset list. The PIP size and LotAmount can
be set arbitrarily, since Bitfinex has no minimum lot size, but a minimum trade
volume; on error messages like DUST TRADE DISALLOWED MIN VALUE 50K
increase the trade volume or the LotAmount in the asset list.
Make sure that PIPCost is adapted to LotAmount.
Example asset list entry:
ETH/BTC,0.01,0.0001,0,0, 0.000001,0.000001, 0,1,1,0,ETHBTC
- Order filling. The API supports exchange market
orders and exchange limit orders. If
the order is not filled within a certain time (to be defined with
SET_WAIT), it is cancelled and the limit can
be adapted for the next try. If it is partially filled, the
TradeLots and TradeUnits
values of the open trade are accordingly adapted. Positions can be read with
the GET_POSITION command.
- Compliance. Bitfinex requires the NFA
flag. Only long positions are supported; for short trades the account must
already contain a sufficient position of the asset. Otherwise an error message like
INSUFFICIENT FUNDS is issued.
- Trading hours. Bitfinex trades 24/7.
- Trade and account parameters. Trade profit is not
available via API and estimated by Zorro from the trading costs entered in the
asset list. Account requests return the BTC balance by default (the account
currency can be set up in the Account column of the account list). The balance is
reduced by opening a long position, and increased by closing the position.
Equity is estimated by Zorro through summing up the open trades. Example
account list entry:
- Request rate. Bitfinex writes on their website: In
order to offer the best service possible we have added a rate limit to the
number of REST requests.
Our rate limit policy can vary in a range of 10
to 90 requests per minute depending on some factors (e.g. servers load,
endpoint, etc.). That's no idle words: By default, the request rate on
a Bitfinex connection is set to 30 requests per minute, but sometimes you
need to reduce it indeed to 10 requests per minute (MaxRequests =
10./60;). Otherwise price requests and orders return occasionally a
RATE LIMIT error message.
Links, order, brokers, broker plugin,
MTR4 bridge, IB,
► latest version online