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

REST V2WS V2
- GET Tickers
- GET Ticker
- GET Trades
- GET Book
- GET Stats
- GET Candles
- GET Status*
- GET Liquidations
- GET Market Average Price
- Ticker
- Trades
- Books
- Raw Books
- Candles
- Status*
  • 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 V2WS 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

  • See Input API for details on placing, updating, and canceling orders through WS.