API Derivatives Trading
The Bitfinex APIs are designed to allow access to all the features of the Bitfinex platform and are subject to the API Terms of Service.
The end goal is to allow users to create their own trading platforms and highly customised and advanced trading strategies.
Bitfinex APIs can be used to retrieve data and perform derivatives trading*.
*The derivatives platform is provided by iFinex Financial Technologies Limited. References to Bitfinex Derivatives on this page are references to iFinex Financial Technologies Limited. Product specifications for our derivative contracts can be found here:
Product Description
Funding Payment Summary
Retrieving derivatives data from public endpoints
Retrieving data from public endpoints for derivatives functions the same as it does for our other trading pairs. The following endpoints are available:
Trading pairs
To use these endpoints, where applicable, specify the trading pair as either tBTCF0:USTF0 or ETHF0:USTF0
- The Status endpoints are of particular interest and provide information on the derivative price, spot price, mark price, insurance fund balance, next funding timestamp, next funding accrued, next funding step, current funding, and open interest all from a single endpoint.
Authenticated derivatives data
Instructions on how to use authenticated endpoints can be found here:
The following authenticated endpoints provide information relevant to trading derivatives:
| REST V2 | WS V2 |
|---|---|
| Wallets info: - Wallets Active orders and positions: - Retrieve Orders - Retrieve Positions - Positions Audit Reports: - Orders History - Order Trades - Trades - Ledgers (*USDt0) - Positions History | Wallets info: - Wallets Active orders and positions: - Orders - Positions Reports: - Historical Orders (deprecated) - Trades |
Converting funds
Derivatives trading requires USDt0 in your derivatives wallet. Conversion and transfer can be done on the website following these instructions:
Alternatively, the API allows conversion through the following endpoint:
Trading derivatives through the API
You can submit, update, and cancel your derivative trades using the following endpoints:
Trading pairs
To use these endpoints for derivative trading, specify the trading pair as either tBTCF0:USTF0 or ETHF0:USTF0
| REST V2 | WS V2* |
|---|---|
| - Submit Order - Order Update - Order Multi-OP - Cancel Order Multi - Derivative Position Collateral | - New Order - Update Order - Order Multi-OP - Cancel Order - Cancel Order Multi |
- See Input API for details on placing, updating, and canceling orders through WS.
Updated about 1 year ago