Bitfinex API

Name: Bitfinex API
Brand: Bitfinex API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey33 EndpointsREST

For Agents

Stream Bitfinex public market data and place authenticated trades, manage wallets, and query positions on the v2 REST API. 33 endpoints, three-header HMAC authentication.

Install Jentic One Beta

Connect the Bitfinex API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bitfinex API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Bitfinex API.

Read live ticker, order book, trades, and candles for any Bitfinex symbol from the public endpoints

Place, cancel, and inspect orders on the authenticated trading surface

Read open positions, wallet balances, ledger entries, and movement history

GET STARTED

Start building with Bitfinex API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Bitfinex API, keeping it validated and agent-ready. Bitfinex is a long-running cryptocurrency exchange offering spot, margin, and derivatives trading along with peer-to-peer funding. The v2 REST API splits into a public surface for tickers, order books, trades, candles, and platform status, and an authenticated surface for orders, positions, wallets, ledger, deposits, withdrawals, and movements. Authentication signs each request with three headers: bfx-apikey, bfx-nonce, and bfx-signature, the latter being an HMAC SHA-384 of the request payload.

Use Cases

Patterns agents use Bitfinex API for, with concrete tasks.

★ Algorithmic spot trading on Bitfinex v2

Quant teams build a trading loop that consumes public ticker and candle data, decides on a position, and then submits authenticated orders. The Bitfinex v2 REST API supports the full loop: public tickers and candles for the signal layer, and authenticated order placement for execution. The three-header HMAC authentication scheme is the only operational complexity beyond the standard order schema.

Read the latest ticker for tBTCUSD, then submit a market buy order for 0.01 BTC and confirm it appears in the open orders list

Wallet and ledger reconciliation

Finance teams reconcile their internal accounts against Bitfinex by pulling wallet balances, ledger entries, deposits, withdrawals, and movements on a daily cadence. The authenticated funding endpoints return the same records the web UI exposes, and the response schema is stable enough to feed a downstream accounting pipeline. Reconciliation jobs typically run once per UTC day and back-fill from the previous run's cursor.

Pull yesterday's ledger entries and movements for the funding wallet, sum by currency, and compare against the internal accounting balance

Market data ingestion for research

Research teams ingest Bitfinex tickers, order books, trades, and candles into a research warehouse to model microstructure and pricing. The public surface returns this data without authentication, so an ingestion job can run from any environment without managing exchange keys. Bitfinex's symbol convention prefixes trading pairs with t (e.g. tBTCUSD) and funding pairs with f.

Pull 1-minute candles for tBTCUSD over the last 24 hours and write them to the research warehouse partitioned by symbol

Agent integration via Jentic for crypto operations

An AI agent that needs to act on a user's Bitfinex account calls Jentic with a high-level intent like 'get my crypto wallet balances' or 'place a market order on Bitfinex'. Jentic returns the matching authenticated operation with its input schema, and injects the bfx-apikey, bfx-nonce, and bfx-signature headers at execution time. The agent never sees the secret used to compute the signature.

Search Jentic for 'place a bitfinex market order', load the order submission schema, and execute a 0.01 BTC buy on the user's account

Key Endpoints

33 endpoints — jentic publishes the only available openapi specification for bitfinex api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/platform/status

Return the platform's operational status (1=online, 0=maintenance)

GET

/ticker/{symbol}

Return the latest ticker for a trading or funding symbol

GET

/tickers

Return tickers for several symbols in a single call

GET

/trades/{symbol}/hist

Return historical trades for a symbol

GET

/book/{symbol}/{precision}

Return the order book for a symbol at a chosen precision

GET

/candles/{candle}/{section}

Return OHLC candles for a symbol over a chosen time window

GET

/status/deriv

Return the current derivative platform status

GET

/platform/status

Return the platform's operational status (1=online, 0=maintenance)

GET

/ticker/{symbol}

Return the latest ticker for a trading or funding symbol

GET

/tickers

Return tickers for several symbols in a single call

GET

/trades/{symbol}/hist

Return historical trades for a symbol

GET

/book/{symbol}/{precision}

Return the order book for a symbol at a chosen precision

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Bitfinex API key and secret are stored encrypted in the Jentic vault. Jentic computes the bfx-nonce and bfx-signature HMAC SHA-384 at execution time, so the agent never holds the secret used to sign requests.

Intent-based discovery

Agents search by intent (e.g. 'place a bitfinex market order' or 'get my crypto wallet balance') and Jentic returns the matching authenticated operation with its input and response schema.

Time to first call

Direct Bitfinex integration: 2-5 days to implement HMAC signing, nonce management, and per-route rate-limit handling. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Bitfinex API through Jentic.

Why is there no official OpenAPI spec for Bitfinex API?

Bitfinex does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Bitfinex API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Bitfinex API use?

Authenticated calls require three headers: bfx-apikey (the public API key), bfx-nonce (a strictly increasing counter), and bfx-signature (an HMAC SHA-384 of the request payload signed with the API secret). Through Jentic the secret is held in the vault and the signature is computed at execution time.

Can I place a market order with the Bitfinex API?

Yes. Bitfinex v2 supports market and limit orders against any listed trading symbol. Submit the order on the authenticated surface together with the three signature headers — Bitfinex returns the order id and status in the response.

What are the rate limits for the Bitfinex API?

Bitfinex enforces per-route limits (typically 10-90 requests per minute on public endpoints and tighter limits on authenticated routes). Excess calls return a 429 Too Many Requests. Bitfinex strongly recommends WebSockets for high-frequency market data; the REST surface is best for periodic polls and order management.

How do I check my Bitfinex balance through Jentic?

Run pip install jentic, search Jentic for 'get my crypto wallet balance', load the authenticated wallets operation, and execute. Jentic computes the HMAC signature from the vaulted secret so the agent never holds the API key.

Are Bitfinex public market data endpoints free?

Yes. The /platform/status, /ticker, /tickers, /trades, /book, and /candles endpoints do not require authentication and are free to call within the published rate limits. Authenticated trading and wallet endpoints require an active Bitfinex account and a generated API key pair.