# Bitfinex API (slim)

> Bitfinex's v2 API for spot, margin, derivatives and peer-to-peer funding, with balances, deposits and withdrawals, through REST and WebSocket with scoped API keys, paper-trading sub-accounts and official Node, Python, Go and Ruby clients.

- Full: https://www.anchorterminal.com/tools/bitfinex.md (~8,850 tokens) · this version ~2,280 tokens · JSON https://www.anchorterminal.com/tools/bitfinex.json · canonical https://www.anchorterminal.com/tools/bitfinex
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-04 · pricing https://www.anchorterminal.com/tools/bitfinex#pricing · reviews https://www.anchorterminal.com/tools/bitfinex#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**C · 58.4/100 · rank #687 of 1349 · #10 in Crypto exchanges · not agent-ready · confidence low**


Assessment: Bitfinex gives an agent scoped keys with a separate withdraw permission, paper-trading sub-accounts on the production API, llms.txt and official clients in four languages. There is no official MCP server, responses are positional arrays with empty error bodies, rate limits run 10 to 90 a minute per IP, and the terms, API terms and privacy statement could not be read.

## Facts

- Kind: HTTP API · vendor: iFinex Inc. · category: Crypto exchanges · legal entity: iFinex Inc. · provenance 85/100
- Packages: npm `bitfinex-api-node`, pypi `bitfinex-api-py`
- Auth: API key · pricing: Pay per use · x402: no · licence: Proprietary hosted API under Bitfinex's API Terms of Service, which our reader couldn't load. The official client libraries (Node, Python, Go, Ruby) are MIT or Apache-2.0
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The hosted v2 API at api.bitfinex.com and api-pub.bitfinex.com as an agent calls it, read from docs.bitfinex.com and its llms.txt, bitfinex.com's fees and about pages, bitfinex.statuspage.io, the official MCP registry, the bitfinexcom GitHub organisation, npm and RDAP on 3 November 2026. The legal pages loaded only navigation and support.bitfinex.com answered 403. No account, key or order
- MCP server: None found. Looked in docs.bitfinex.com and its llms.txt, the bitfinexcom GitHub organisation (a search for mcp returned nothing) and the official MCP registry. Third-party only, pipeworx-io's remote `io.github.pipeworx-io/bitfinex` and mrfentmen's `bitfinex-mcp`, both public market data, neither Bitfinex's
- Key permissions: Read and write flags per scope (account, history, orders, positions, funding, settings, wallets, withdraw, ui_withdraw and bfxpay); `POST /v2/auth/r/permissions` returns the key's scopes. Keys are made with 2FA and email confirmation, shown once, and revoked from the API page. IP binding to up to 20 addresses per the support article's search text (the article answered 403). Default permissions on keys made from an email-and-password account are all enabled per the same text
- Rate limits: REST 10 to 90 requests a minute per IP by endpoint, `{"error": "ERR_RATE_LIMIT"}` and a 60-second IP block; the permissions endpoint 90 a minute. WebSocket 5 authenticated connections per 15 seconds, 20 public connections a minute, 25 channels per connection, with 15-second and 60-second blocks. No Retry-After
- Testnet or sandbox: Paper trading on a sub-account using TEST symbols (tTESTBTCF0:TESTUSDTF0 named in the docs) on the production API; no separate sandbox host
- Countries served: Unchecked. The Exchange Terms, which carry the prohibited-jurisdiction list, loaded only navigation, and the support article on restrictions answered 403. The only first-hand list we could read is for Bitfinex Securities, a separate product
- Fees at the lowest tier: Zero maker and zero taker on exchange, margin and derivatives order execution per the fees page on 3 November 2026, with no volume tiers and no date; margin funding lenders pay 15% of interest (18% when the offer is hidden), LEO holders up to 5% less; bank wires 0.1%
- FIX and WebSocket: WebSocket v2 at wss://api.bitfinex.com (authenticated) and wss://api-pub.bitfinex.com (public) with ticker, trades, books, raw books, candles and status channels, account channels and order inputs. No FIX documentation on docs.bitfinex.com; llms.txt lists none
- Terms on automated trading: Unchecked. The API Terms of Service and Exchange Terms pages draw their text by script and loaded only navigation. The docs say every API use is subject to the API Terms of Service and that keys are used at the holder's own risk
- Errors and idempotency: Authenticated endpoints answer 400 with `{}`; the rate limit answers `{"error": "ERR_RATE_LIMIT"}`; withdrawals return a notification array with STATUS SUCCESS, ERROR or FAILURE and a CODE marked work in progress. Orders take a client id (`cid`); no idempotency key is documented
- SDKs: bitfinex-api-node 9.1.0 (18 July 2026, MIT, 480 stars), bitfinex-api-py 4.0.0 (18 October 2025, Apache-2.0, 219 stars), bitfinex-api-go (pushed 18 October 2025, MIT) and bitfinex-api-rb (21 October 2025, MIT), all in github.com/bitfinexcom
- Legal entity: iFinex Inc., from the copyright line on bitfinex.com; the Exchange Terms, which would state its jurisdiction and role, loaded only navigation. Bitfinex Securities Ltd and Bitfinex Securities El Salvador S.A. de C.V. run the securities platform
- Prices: Exchange maker fee, as shown on 3 November 2026 0% percentage fee; Exchange taker fee, as shown on 3 November 2026 0% percentage fee; Margin funding lender fee on interest earned 15% percentage fee

- Scores: Reliability 85, Performance pending, Schema & documentation 48, Agent ergonomics 61, Security & auth 62, Payments & pricing 40, Task success pending, Maintenance & community 41, Transparency & trust 49 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines on the v2 API at api.bitfinex.com. · Schema & documentation, No OpenAPI or AsyncAPI file was found on docs.bitfinex.com, in llms.txt or in the client repositories (0). · Agent ergonomics, Graded on the REST API. · Security & auth, Revocable keys with per-scope read and write flags, a permissions endpoint, 2FA and email confirmation at creation, strictly increasing nonc… · Payments & pricing, No machine payment protocol (0). · Maintenance & community, Read as a closed service with open clients. · Transparency & trust, The editorial half.
- Sources: 23, open questions: 8, both in the full twin
- Capabilities: exchange.market-data, exchange.spot-trading, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto
- JSON: https://www.anchorterminal.com/api/v1/tools/bitfinex.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/bitfinex.svg` or a link to https://www.anchorterminal.com/tools/bitfinex from a page on bitfinex.com or one of its subdomains, or the README at the root of github.com/bitfinexcom/bitfinex-api-node, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: https://support.bitfinex.com/hc/en-us; https://cs.bitfinex.com; https://bitfinex.statuspage.io; more in the full twin

## Before you call it

1. Mint a key with read on the scopes the task needs and write only on `orders`; never grant `withdraw` to a trading key, and bind the key to known IPs
2. Use one key per client process, since each key keeps its own strictly increasing nonce and a reused nonce is rejected
3. Rehearse on a paper-trading sub-account with the TEST symbols before touching real balances; the sub-account cannot be converted later
4. Plan requests against the per-endpoint limit of 10 to 90 a minute per IP; `ERR_RATE_LIMIT` blocks the IP for 60 seconds with no Retry-After
5. Map each response by position from the docs' field tables and set a `cid` on orders, because responses are arrays and a 400 carries no reason

## Connect

```bash
npm install bitfinex-api-node
```

```bash
curl https://api-pub.bitfinex.com/v2/ticker/tBTCUSD
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/bitfinex

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Gemini Exchange API | BB | 74.6 | exchange.market-data, exchange.spot-trading, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/gemini-exchange.min.md |
| Kraken API | BB | 71 | exchange.spot-trading, exchange.market-data, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/kraken.min.md |
| OKX API | B | 64.3 | exchange.spot-trading, exchange.market-data, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/okx.min.md |
| Binance API | B | 63.2 | exchange.spot-trading, exchange.market-data, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/binance.min.md |
| Bybit | C | 57.3 | exchange.market-data, exchange.spot-trading, exchange.derivatives, exchange.balances, exchange.transfers, exchange.staking, market.crypto | https://www.anchorterminal.com/tools/bybit.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)