To build a request, use the following structure to append parameters:
Public: https://api-pub.bitfinex.com/v2/<endpoint>?parameter=value¶meter=value&.... Authenticated: https://api.bitfinex.com/v2/<endpoint>?parameter=value¶meter=value&....
Please note that Path Parameters are appended after the endpoint. In the documentation, Path Parameters will be listed below the example code and will also be shown in the URL above the example code. The structure is as follows:
Public: https://api-pub.bitfinex.com/v2/<endpoint>/<pathParam>?queryParam=value&queryParam=value&.... Authenticated: https://api.bitfinex.com/v2/<endpoint>/<pathParam>?queryParam=value&queryParam=value&....
When adding timestamp parameters the value needs to be expressed in UTC and in milliseconds.
For a more detailed overview of the structure of the documentation, please look the Reading the Documentation (REST) page.
For further information regarding authentication, please look to the Authenticated Endpoints page.
All pairs available in the platform are supported. A symbol can be a trading pair or a margin currency. All symbols are in uppercase (i.e. btcusd is invalid, BTCUSD is valid).
Trading pairs are prepended by a “t” before the pair (e.g. tBTCUSD, tETHUSD, ...).
Margin currencies are prepended by an “f” before the currency (e.g. fUSD, fBTC, …).
Lists of available currencies and pairs can be retrieved through the Configs endpoint.
For a list of all currencies on the platform, look to:
For a list of all trading pairs on the platform, look to:
For a list of all margin trading pairs on the platform, look to:
In order to offer the best service possible, there is a rate limit to the number of REST requests that can be made in the span of a minute. Our rate limit policy varies per endpoint and lies in the range of 10 to 90 requests per minute. For more information regarding the requirements and limitations of our API, please look to our Requirements and Limitations page.
When in maintenance, a few API endpoints (eg. books) will return a maintenance error to prevent you from using potentially inconsistent data. The error will appear as follows:
["error", 20060, "maintenance"]
Updated over 2 years ago