Bitfinex API

Cryptocurrency / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

Bitfinex is a professional cryptocurrency exchange offering one of the most comprehensive trading APIs for both spot and margin markets. The public endpoints expose real-time order books, recent trades, and candle data for hundreds of trading pairs. Authenticated endpoints allow order placement, wallet management, and position tracking for algorithmic traders.

💡

Beginner Tip

Start with the unauthenticated v2 ticker endpoint which needs no API key — replace tBTCUSD with any valid trading pair symbol. The v2 API uses a different URL prefix (api-pub.bitfinex.com/v2/) from the older v1 endpoints and returns arrays instead of JSON objects, so read the response format docs carefully.

Available Data

coin price in USD/EUR
market capitalization
24h price change
trading volume
circulating supply
stock price and symbol

Example Response

JSON Response
{
  "id": "bitcoin",
  "symbol": "btc",
  "current_price": 65432.1,
  "market_cap": 1280000000000,
  "price_change_24h": 1250.5,
  "price_change_percentage_24h": 1.95,
  "total_volume": 28500000000
}

Field Reference

[0] BID Highest bid price in the order book.
[2] ASK Lowest ask price in the order book.
[6] LAST_PRICE Price of the most recently executed trade.
[7] VOLUME Total amount traded in the last 24 hours.
[5] DAILY_CHANGE_RELATIVE Percentage price change over the past 24 hours (e.g., 0.02 means +2%).

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://docs.bitfinex.com/docs";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

10020 Request parameters error The v2 API returns numeric error codes instead of HTTP status codes for some errors.
Always check if the response is an array starting with "error" before parsing data fields.
Incorrect symbol format Bitfinex prefixes trading pair symbols with t (e.g., tBTCUSD) and funding symbols with f (e.g., fUSD).
Prepend t to currency pairs when querying the v2 tickers or candles endpoints.
429 Rate limit exceeded Public endpoints allow 90 requests per minute; exceeding this results in a temporary ban.
Add delays between requests, use WebSocket for streaming data, or cache responses whenever possible.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Cryptocurrency
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →