Introduction

The Bitfinex API’s are designed to allow access to all of the features of the Bitfinex platform. The end goal is to allow people to potentially recreate the entire platform on their own.

If you would like to suggest changes to the documentation, please see the github at https://github.com/bitfinexcom/api_docs

Open Source Libraries

The following open source projects are works in progress. We will be continually improving them, but we want to release them early so that the community can take a look, make use of them, and offer pull requests. Nothing in the Bitcoin world exists in isolation.

Get Started    

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 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:

Active orders and positions:

Reports:

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.

API Derivatives Trading


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.