Bitfinex API
★ 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.
Use for: Get the latest ticker for tBTCUSD, List my open positions on Bitfinex, Place a market buy for 0.01 BTC against USD, Retrieve my wallet balances across exchange, margin, and funding
Not supported: Does not handle fiat banking outside Bitfinex-supported rails, custody at other venues, or tax reporting — use for trading, market data, and wallet operations on Bitfinex only.
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.
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.
1
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 | sh2
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 instanceJentic 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
Submit deposits and withdrawals through the authenticated funding endpoints
Check platform status before sending an order to detect a maintenance window
Pull derivatives status for funding rate and mark price tracking
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
GET
/candles/{candle}/{section}
Return OHLC candles for a symbol over a chosen time window
GET
/status/deriv
Return the current derivative platform status
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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.
GET STARTED