Bitfinex
App · 19 actions
Read Bitfinex's public market data: the price and last 24 hours of any trading pair or all of them, hourly price history, trades, the order book, price candles, margin longs and shorts, perpetual contracts' funding and open interest, margin funding rates, liquidations and leaderboards. Convert currencies at its rate, estimate what an order would fill at, and start a workflow when a price crosses a level. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Convert currency | Convert an amount from one currency to another at Bitfinex's exchange rate, e.g. BTC to EUR, ETH to JPY or USD to EUR. |
| Estimate average price | Estimate the average price an order to buy or sell an amount of a trading pair would fill at, from its order book now, and the total it would cost or bring in. |
| Get funding book | Get the margin funding offers and bids waiting on a currency, with their daily and yearly rates, periods and amounts. |
| Get funding rates | Get a currency's margin funding rates: the last rate lent at, the best rates lenders ask and borrowers bid, the flash return rate and the last 24 hours, each daily with its yearly rate. |
| Get funding statistics | Get a currency's margin funding over time: the flash return rate, how much is lent and how much of it is in use, and the average period. |
| Get hourly price history | Get a trading pair's best bid and ask once an hour, up to a year back. |
| Get leaderboard | Get the top traders of a Bitfinex leaderboard (volume, realized or unrealized profit, over 3 hours, a week or a month), as they stand now or stood at a time. |
| Get order book | Get the buy and sell orders waiting on a trading pair, grouped by price or one by one, with the best bid and ask, the spread and the mid price. |
| Get perpetual history | Get a perpetual contract's past status about once a minute: prices, funding and open interest over time. |
| Get perpetual status | Get perpetual contracts' derivative, spot and mark prices, their funding this period and next, open interest and the insurance fund, for chosen contracts or all of them. |
| Get platform status | Check whether Bitfinex is operating or in maintenance, when trading is paused. |
| Get price | Get a trading pair's last price, best bid and ask, and its last 24 hours: change, high, low and volume. |
| Get price candles | Get a trading pair's price candles (open, close, high, low and volume) of 1 minute to 1 month each, the latest one or between two times, with the change across them. |
| Get statistic | Get one of Bitfinex's statistics, the latest value or over time: margin longs or shorts open on a pair, a pair's volume-weighted average price for the day, funding provided or used in a currency, or Bitfinex's trading volume over 1, 7 or 30 days. |
| List currencies | List the currencies Bitfinex holds with their codes and names, e.g. UST is Tether USDt, optionally only those matching some text. |
| List liquidations | List the margin and perpetual positions Bitfinex has liquidated, newest first or between two times, with the pair, side, size and prices. |
| List prices | Get the price and last 24 hours of several trading pairs in one step, or of every pair, optionally biggest rise or biggest fall first, to find the day's movers. |
| List recent trades | List a trading pair's trades, newest first or between two times, each with its side, amount and price, and the amounts bought and sold with their average price. |
| List trading pairs | List the pairs Bitfinex trades, with the smallest and largest order and whether each can be traded on margin, optionally only those with one currency. |
Convert currency
Convert an amount from one currency to another at Bitfinex's exchange rate, e.g. BTC to EUR, ETH to JPY or USD to EUR.
Inputs
- From currency
from_currencytextRequired - The currency to convert from, e.g. BTC.
- To currency
to_currencytextRequired - The currency to convert to, e.g. EUR or JPY.
- Amount
amountnumber - How much to convert. Defaults to 1.At least 0. Default:
1.
Outputs
amountnumber- The amount converted, in the first currency.
converted_amountnumber- What it is worth in the second currency.
from_currencytext- The currency converted from.
ratenumber- How much of the second currency one of the first is worth.
summarytext- One readable sentence about the answer.
to_currencytext- The currency converted to.
Example output
{
"amount": 0.5,
"converted_amount": 34355.25,
"from_currency": "BTC",
"rate": 68710.5,
"summary": "0.5 BTC is 34,355.25 EUR at Bitfinex's rate of 68,710.5.",
"to_currency": "EUR"
}Estimate average price
Estimate the average price an order to buy or sell an amount of a trading pair would fill at, from its order book now, and the total it would cost or bring in.
Inputs
- Pair
pairtextRequired - The trading pair, e.g. BTC/USD. Pick from the list, or type it as BTC/USD, btcusd or tBTCUSD.
- Side
sidetextRequired - Buy or sell.One of:
buy,sell. - Amount
amountnumberRequired - How much of the pair's first currency to buy or sell, e.g. 2 for 2 BTC on BTC/USD.At least 0.
Outputs
amount_fillednumber- How much the order book can fill of it now.
amount_requestednumber- The order's size, in the base currency.
average_pricenumber- The average price it would fill at.
fully_filledtrue/false- True when the order book holds enough to fill it all.
pairtext- The pair as people write it, e.g. BTC/USD.
sidetext- buy or sell.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the pair, e.g. tBTCUSD.
totalnumber- Average price times the amount filled, in the quote currency.
Example output
{
"amount_filled": 2,
"amount_requested": 2.0,
"average_price": 76890.42920163,
"fully_filled": true,
"pair": "BTC/USD",
"side": "sell",
"summary": "To sell 2 BTC on BTC/USD now would average 76,890.43 USD, 153,780.86 USD in all.",
"symbol": "tBTCUSD",
"total": 153780.85840326
}Get funding book
Get the margin funding offers and bids waiting on a currency, with their daily and yearly rates, periods and amounts.
Inputs
- Currency
currencytextRequired - The currency lent on Bitfinex's funding market, e.g. USD.
- Grouping
precisiontext - How finely to group the book: by price to 5 significant figures (the finest) down to 1, or every order on its own.One of:
P0(5 significant figures),P1(4 significant figures),P2(3 significant figures),P3(2 significant figures),P4(1 significant figure),R0(Every order on its own). Default:P0. - Depth
lengthtext - How many levels to list on each side.One of:
1(1 a side),25(25 a side),100(100 a side),250(250 a side). Default:25.
Outputs
best_bid_ratenumber- The highest daily rate a borrower bids.
best_offer_ratenumber- The lowest daily rate a lender offers.
bid_amountnumber- How much the listed bids add up to.
bidslist- Borrowers' bids, highest rate first.
currencytext- The currency, e.g. USD.
offered_amountnumber- How much the listed offers add up to.
offerslist- Lenders' offers, lowest rate first.
precisiontext- How rates are grouped: P0 (finest) to P4, or R0 for single offers.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the funding currency, e.g. fUSD.
Example output
{
"best_bid_rate": 0.00023287671232876712,
"best_offer_rate": 0.000139,
"bid_amount": 9637083.03859537,
"bids": [
{
"amount": 9637083.03859537,
"offer_id": null,
"orders": 1,
"period_days": 120,
"rate": 0.00023287671232876712,
"rate_yearly_percent": 8.5
}
],
"currency": "USD",
"offered_amount": 4227.23502078,
"offers": [
{
"amount": 4227.23502078,
"offer_id": null,
"orders": 3,
"period_days": 2,
"rate": 0.000139,
"rate_yearly_percent": 5.0735
}
],
"precision": "P0",
"summary": "USD funding book: lowest offer 0.0139% a day, highest bid 0.0233% a day; 1 offer and 1 bid levels.",
"symbol": "fUSD"
}Get funding rates
Get a currency's margin funding rates: the last rate lent at, the best rates lenders ask and borrowers bid, the flash return rate and the last 24 hours, each daily with its yearly rate.
Inputs
- Currency
currencytextRequired - The currency lent on Bitfinex's funding market, e.g. USD.
Outputs
ask_period_daysnumber- How many days that offer is for.
ask_ratenumber- The lowest daily rate a lender is asking.
ask_sizenumber- How much the 25 lowest offers add up to.
bid_period_daysnumber- How many days that bid is for.
bid_ratenumber- The highest daily rate a borrower is bidding.
bid_sizenumber- How much the 25 highest bids add up to.
change_24hnumber- How much the last rate moved over 24 hours.
change_24h_percentnumber- That move as a percentage of the rate.
currencytext- The currency, e.g. USD.
flash_return_ratenumber- The flash return rate: the average of fixed-rate funding over the last hour, as a daily fraction.
flash_return_rate_yearly_percentnumber- The daily rate times 365, as a percentage.
frr_amount_availablenumber- How much is offered at the flash return rate.
high_24hnumber- The highest daily rate over 24 hours.
last_ratenumber- A daily rate as a fraction: 0.0003 is 0.03% a day.
last_rate_yearly_percentnumber- The daily rate times 365, as a percentage.
low_24hnumber- The lowest daily rate over 24 hours.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the funding currency, e.g. fUSD.
volume_24hnumber- How much was lent over 24 hours, in the currency.
Example output
{
"ask_period_days": 2,
"ask_rate": 0.000139,
"ask_size": 573556.9608032,
"bid_period_days": 120,
"bid_rate": 0.00023287671232876712,
"bid_size": 22731144.16946215,
"change_24h": 8.54e-05,
"change_24h_percent": 61.0,
"currency": "USD",
"flash_return_rate": 0.0002978794520547945,
"flash_return_rate_yearly_percent": 10.8726,
"frr_amount_available": 132876813.21814813,
"high_24h": 0.00029773,
"last_rate": 0.0002254,
"last_rate_yearly_percent": 8.2271,
"low_24h": 3e-05,
"summary": "USD funding last lent at 0.0225% a day (8.2271% a year); flash return rate 0.0298% a day; 24-hour volume 181,522,688.33 USD.",
"symbol": "fUSD",
"volume_24h": 181522688.33385995
}Get funding statistics
Get a currency's margin funding over time: the flash return rate, how much is lent and how much of it is in use, and the average period.
Inputs
- Currency
currencytextRequired - The currency lent on Bitfinex's funding market, e.g. USD.
- From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most readings
limitnumber - How many readings to list, from 1 to 250. Defaults to 24.From 1 to 250. Default:
24.
Outputs
countnumber- How many rows are listed.
currencytext- The currency, e.g. USD.
statslist- The readings, newest first.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the funding currency, e.g. fUSD.
Example output
{
"count": 2,
"currency": "USD",
"stats": [
{
"average_period_days": 85.21,
"flash_return_rate": 0.0003066,
"flash_return_rate_yearly_percent": 11.1909,
"funding_amount": 5948753189.629787,
"funding_amount_used": 5884043627.469175,
"funding_below_threshold": 470258619.36756474,
"funding_used_percent": 98.9122,
"time": "2026-10-01T01:05:00Z",
"timestamp_ms": 1790816700000
},
{
"average_period_days": 85.02,
"flash_return_rate": 0.0003066,
"flash_return_rate_yearly_percent": 11.1909,
"funding_amount": 5949278527.82728,
"funding_amount_used": 5884559105.569227,
"funding_below_threshold": 470071946.6680786,
"funding_used_percent": 98.9121,
"time": "2026-10-01T00:05:00Z",
"timestamp_ms": 1790813100000
}
],
"summary": "2 readings of USD funding; at 2026-10-01T01:05:00Z the flash return rate was 0.0307% a day and 98.9122% of 5,948,753,189.63 USD lent was in use.",
"symbol": "fUSD"
}Get hourly price history
Get a trading pair's best bid and ask once an hour, up to a year back.
Inputs
- Pair
pairtextRequired - The trading pair, e.g. BTC/USD. Pick from the list, or type it as BTC/USD, btcusd or tBTCUSD.
- From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most hours
limitnumber - How many hours to list, from 1 to 250. Defaults to 24.From 1 to 250. Default:
24. - Order
ordertext - Newest first, or oldest first.One of:
newest(Newest first),oldest(Oldest first). Default:newest.
Outputs
countnumber- How many rows are listed.
historylist- The best bid and ask once an hour.
pairtext- The pair as people write it, e.g. BTC/USD.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the pair, e.g. tBTCUSD.
Example output
{
"count": 3,
"history": [
{
"ask": 83654,
"bid": 83640,
"mid_price": 83647.0,
"time": "2026-10-01T00:00:09Z",
"timestamp_ms": 1790812809000
},
{
"ask": 83528,
"bid": 83522,
"mid_price": 83525.0,
"time": "2026-10-01T01:00:09Z",
"timestamp_ms": 1790816409000
},
{
"ask": 83517,
"bid": 83509,
"mid_price": 83513.0,
"time": "2026-10-01T02:00:09Z",
"timestamp_ms": 1790820009000
}
],
"pair": "BTC/USD",
"summary": "3 hourly prices for BTC/USD, from 2026-10-01T00:00:09Z to 2026-10-01T02:00:09Z.",
"symbol": "tBTCUSD"
}Get leaderboard
Get the top traders of a Bitfinex leaderboard (volume, realized or unrealized profit, over 3 hours, a week or a month), as they stand now or stood at a time.
Inputs
- Leaderboard
leaderboardtextRequired - Which leaderboard, e.g. Volume, last week, all pairs.
- As of
as_ofdate and time - The standings as they stood at this time. Leave blank for the latest.
- Most places
limitnumber - How many places to list, from 1 to 100. Defaults to 25.From 1 to 100. Default:
25.
Outputs
countnumber- How many rows are listed.
entrieslist- The places, first first.
leaderboardtext- Bitfinex's key for the leaderboard, e.g. vol:1w:tGLOBAL:USD.
nametext- What the leaderboard ranks, over what time and pairs.
standings_timetext- When these standings were taken (ISO 8601, UTC).
summarytext- One readable sentence about the answer.
unittext- What the values count: USD, or the base currency for a pair's volume.
Example output
{
"count": 3,
"entries": [
{
"rank": 1,
"twitter_handle": null,
"username": "Wintermute",
"value": 300923462.15
},
{
"rank": 2,
"twitter_handle": null,
"username": "TheyDontKnowImJustABuyWall",
"value": 242669435.04
},
{
"rank": 3,
"twitter_handle": null,
"username": "Crypt3d",
"value": 193299822.48
}
],
"leaderboard": "vol:1w:tGLOBAL:USD",
"name": "Volume, last week, all pairs",
"standings_time": "2026-10-19T00:00:00Z",
"summary": "Volume, last week, all pairs, standings of 2026-10-19T00:00:00Z: first Wintermute (300,923,462.15 USD), 3 places listed.",
"unit": "USD"
}Get order book
Get the buy and sell orders waiting on a trading pair, grouped by price or one by one, with the best bid and ask, the spread and the mid price.
Inputs
- Pair
pairtextRequired - The trading pair, e.g. BTC/USD. Pick from the list, or type it as BTC/USD, btcusd or tBTCUSD.
- Grouping
precisiontext - How finely to group the book: by price to 5 significant figures (the finest) down to 1, or every order on its own.One of:
P0(5 significant figures),P1(4 significant figures),P2(3 significant figures),P3(2 significant figures),P4(1 significant figure),R0(Every order on its own). Default:P0. - Depth
lengthtext - How many levels to list on each side.One of:
1(1 a side),25(25 a side),100(100 a side),250(250 a side). Default:25.
Outputs
ask_amountnumber- How much the listed asks add up to, in the base currency.
askslist- Sell orders, lowest price first.
best_asknumber- The lowest ask.
best_bidnumber- The highest bid.
bid_amountnumber- How much the listed bids add up to, in the base currency.
bidslist- Buy orders, highest price first.
mid_pricenumber- Halfway between the best bid and best ask.
pairtext- The pair as people write it, e.g. BTC/USD.
precisiontext- How prices are grouped: P0 (finest) to P4, or R0 for single orders.
spreadnumber- Best ask minus best bid.
spread_percentnumber- The spread as a percentage of the mid price.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the pair, e.g. tBTCUSD.
Example output
{
"ask_amount": 0.48809561,
"asks": [
{
"amount": 0.48809561,
"order_id": null,
"orders": 7,
"price": 76970,
"value": 37568.7191017
}
],
"best_ask": 76970,
"best_bid": 76940,
"bid_amount": 0.00014,
"bids": [
{
"amount": 0.00014,
"order_id": null,
"orders": 1,
"price": 76940,
"value": 10.7716
}
],
"mid_price": 76955.0,
"pair": "BTC/USD",
"precision": "P1",
"spread": 30,
"spread_percent": 0.038984,
"summary": "BTC/USD order book: best bid 76,940, best ask 76,970 USD (spread 30); 1 bid and 1 ask levels.",
"symbol": "tBTCUSD"
}Get perpetual history
Get a perpetual contract's past status about once a minute: prices, funding and open interest over time.
Inputs
- Contract
contracttextRequired - The perpetual contract, e.g. BTC/USDT perpetual.
- From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most readings
limitnumber - How many readings to list, from 1 to 5,000. Defaults to 100.From 1 to 5000. Default:
100. - Order
ordertext - Newest first, or oldest first.One of:
newest(Newest first),oldest(Oldest first). Default:newest.
Outputs
contracttext- The contract as people write it, e.g. BTC/USDT perpetual.
countnumber- How many rows are listed.
historylist- The contract's status over time.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the contract, e.g. tBTCF0:USTF0.
Example output
{
"contract": "BTC/USDT perpetual",
"count": 2,
"history": [
{
"clamp_max": 0.0025,
"clamp_min": 0.0005,
"current_funding": 7.039e-05,
"derivative_price": 83634.3149219,
"insurance_fund_balance": 61797011.75827756,
"mark_price": 83587.7957,
"next_funding_accrued": 1.02e-06,
"next_funding_step": 18,
"next_funding_time": "2026-10-01T08:00:00Z",
"open_interest": 8955.09194121,
"spot_price": 83585.5,
"time": "2026-10-01T00:00:58Z"
},
{
"clamp_max": 0.0025,
"clamp_min": 0.0005,
"current_funding": 7.039e-05,
"derivative_price": 83607.53588228,
"insurance_fund_balance": 61797011.75827756,
"mark_price": 83559.7598,
"next_funding_accrued": 2.09e-06,
"next_funding_step": 37,
"next_funding_time": "2026-10-01T08:00:00Z",
"open_interest": 8955.11071208,
"spot_price": 83556,
"time": "2026-10-01T00:01:57Z"
}
],
"summary": "2 readings of BTC/USDT perpetual from 2026-10-01T00:00:58Z to 2026-10-01T00:01:57Z.",
"symbol": "tBTCF0:USTF0"
}Get perpetual status
Get perpetual contracts' derivative, spot and mark prices, their funding this period and next, open interest and the insurance fund, for chosen contracts or all of them.
Inputs
- Contracts
contractslist - The perpetual contracts, e.g. BTC/USDT perpetual. Leave blank for every contract.
Outputs
contractslist- Each perpetual contract's status.
countnumber- How many rows are listed.
missing_contractslist- Contracts asked for that Bitfinex doesn't list.
summarytext- One readable sentence about the answer.
Example output
{
"contracts": [
{
"clamp_max": 0.0025,
"clamp_min": 0.0005,
"contract": "BTC/USDT perpetual",
"current_funding": 7.287e-05,
"derivative_price": 76962.56751461,
"insurance_fund_balance": 60638269.77216531,
"mark_price": 76919.095,
"next_funding_accrued": 0.00027965,
"next_funding_step": 4545,
"next_funding_time": "2026-11-03T00:00:00Z",
"open_interest": 9244.60557787,
"spot_price": 76912.5,
"symbol": "tBTCF0:USTF0",
"time": "2026-11-02T19:57:23Z"
},
{
"clamp_max": 0.0025,
"clamp_min": 0.0005,
"contract": "ETH/USDT perpetual",
"current_funding": 0,
"derivative_price": 2248.499907965,
"insurance_fund_balance": 60638269.77216531,
"mark_price": 2247.9169,
"next_funding_accrued": 0.00021632,
"next_funding_step": 4545,
"next_funding_time": "2026-11-03T00:00:00Z",
"open_interest": 12110.40151433,
"spot_price": 2247.4,
"symbol": "tETHF0:USTF0",
"time": "2026-11-02T19:57:23Z"
}
],
"count": 2,
"missing_contracts": [],
"summary": "Status of 2 Bitfinex perpetual contracts."
}Get platform status
Check whether Bitfinex is operating or in maintenance, when trading is paused.
Inputs
None.
Outputs
operativetrue/false- True when Bitfinex is operating, false in maintenance.
statustext- operative or maintenance.
summarytext- One readable sentence about the answer.
Example output
{
"operative": true,
"status": "operative",
"summary": "Bitfinex is operating normally."
}Get price
Get a trading pair's last price, best bid and ask, and its last 24 hours: change, high, low and volume.
Inputs
- Pair
pairtextRequired - The trading pair, e.g. BTC/USD. Pick from the list, or type it as BTC/USD, btcusd or tBTCUSD.
Outputs
asknumber- The lowest price a seller is asking.
ask_sizenumber- How much the 25 lowest asks add up to, in the base currency.
base_currencytext- The currency bought and sold, e.g. BTC.
bidnumber- The highest price a buyer is offering.
bid_sizenumber- How much the 25 highest bids add up to, in the base currency.
change_24hnumber- How much the price moved over the last 24 hours.
change_24h_percentnumber- That move as a percentage, e.g. -1.43.
first_trade_timetext- When the pair first traded on Bitfinex (ISO 8601, UTC).
high_24hnumber- The highest price over the last 24 hours.
last_pricenumber- The price of the last trade.
low_24hnumber- The lowest price over the last 24 hours.
pairtext- The pair as people write it, e.g. BTC/USD.
quote_currencytext- The currency prices are in, e.g. USD.
spreadnumber- Ask minus bid.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the pair, e.g. tBTCUSD.
volume_24hnumber- How much was traded over the last 24 hours, in the base currency.
Example output
{
"ask": 76965,
"ask_size": 1.68408032,
"base_currency": "BTC",
"bid": 76945,
"bid_size": 2.54199778,
"change_24h": -942,
"change_24h_percent": -1.2091,
"first_trade_time": "2013-01-14T16:47:23Z",
"high_24h": 78922,
"last_price": 76967,
"low_24h": 76701,
"pair": "BTC/USD",
"quote_currency": "USD",
"spread": 20,
"summary": "BTC/USD last traded at 76,967 USD, down 1.2091% over 24 hours (high 78,922, low 76,701, volume 419.2587 BTC).",
"symbol": "tBTCUSD",
"volume_24h": 419.25869364
}Get price candles
Get a trading pair's price candles (open, close, high, low and volume) of 1 minute to 1 month each, the latest one or between two times, with the change across them.
Inputs
- Pair
pairtextRequired - The trading pair, e.g. BTC/USD. Pick from the list, or type it as BTC/USD, btcusd or tBTCUSD.
- Candle length
timeframetext - How long each candle is.One of:
1m(1 minute),5m(5 minutes),15m(15 minutes),30m(30 minutes),1h(1 hour),3h(3 hours),6h(6 hours),12h(12 hours),1D(1 day),1W(1 week),14D(2 weeks),1M(1 month). Default:1h. - Latest only
latest_onlytrue/false - Only the newest one, leaving out From, To and the rest.Default:
false. - From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most candles
limitnumber - How many candles to list, from 1 to 10,000. Defaults to 100.From 1 to 10000. Default:
100. - Order
ordertext - Newest first, or oldest first.One of:
newest(Newest first),oldest(Oldest first). Default:newest.
Outputs
candleslist- The candles, in the order asked for.
changenumber- Last close minus first open.
change_percentnumber- That change as a percentage of the first open.
closenumber- The last candle's closing price.
countnumber- How many rows are listed.
highnumber- The highest price across the candles.
lownumber- The lowest price across the candles.
opennumber- The first candle's opening price.
pairtext- The pair as people write it, e.g. BTC/USD.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the pair, e.g. tBTCUSD.
timeframetext- How long each candle is, e.g. 1h.
volumenumber- The volume across the candles, in the base currency.
Example output
{
"candles": [
{
"close": 83503,
"high": 83673,
"low": 83412,
"open": 83604,
"time": "2026-10-01T00:00:00Z",
"timestamp_ms": 1790812800000,
"volume": 8.96377584
},
{
"close": 83508,
"high": 83692,
"low": 83476,
"open": 83502,
"time": "2026-10-01T01:00:00Z",
"timestamp_ms": 1790816400000,
"volume": 2.80659228
},
{
"close": 83479,
"high": 83661,
"low": 83403,
"open": 83517,
"time": "2026-10-01T02:00:00Z",
"timestamp_ms": 1790820000000,
"volume": 3.24011824
}
],
"change": -125,
"change_percent": -0.1495,
"close": 83479,
"count": 3,
"high": 83692,
"low": 83403,
"open": 83604,
"pair": "BTC/USD",
"summary": "3 candles of 1h for BTC/USD, 2026-10-01T00:00:00Z to 2026-10-01T02:00:00Z: opened 83,604, closed 83,479 (-0.1495%), high 83,692, low 83,403.",
"symbol": "tBTCUSD",
"timeframe": "1h",
"volume": 15.01048636
}Get statistic
Get one of Bitfinex's statistics, the latest value or over time: margin longs or shorts open on a pair, a pair's volume-weighted average price for the day, funding provided or used in a currency, or Bitfinex's trading volume over 1, 7 or 30 days.
Inputs
- Statistic
statistictextRequired - Which statistic to get.One of:
longs(Margin longs open on a pair),shorts(Margin shorts open on a pair),vwap(Volume-weighted average price of the day),funding_provided(Funding provided in a currency),funding_used(Funding used in positions, in a currency),funding_used_on_pair(Funding of a currency used on a pair),volume_1d(Bitfinex trading volume, last 24 hours),volume_7d(Bitfinex trading volume, last 7 days),volume_30d(Bitfinex trading volume, last 30 days). - Pair
pairtext - The trading pair it is about, e.g. BTC/USD. Pick from the list, or type it as BTC/USD or tBTCUSD.Only when Statistic is Margin longs open on a pair, Margin shorts open on a pair, Volume-weighted average price of the day or Funding of a currency used on a pair.
- Currency
currencytext - The funding currency it is about, e.g. USD.Only when Statistic is Funding provided in a currency, Funding used in positions, in a currency or Funding of a currency used on a pair.
- Latest only
latest_onlytrue/false - Only the newest one, leaving out From, To and the rest.Default:
false. - From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most values
limitnumber - How many values to list, from 1 to 10,000. Defaults to 30.From 1 to 10000. Default:
30. - Order
ordertext - Newest first, or oldest first.One of:
newest(Newest first),oldest(Oldest first). Default:newest.
Outputs
countnumber- How many rows are listed.
currencytext- The funding currency it is about, when it is about one.
latest_timetext- When the newest value was taken (ISO 8601, UTC).
latest_valuenumber- The newest value.
pairtext- The pair it is about, when it is about one, e.g. BTC/USD.
statistictext- The statistic's choice, e.g. longs.
statistic_nametext- What the statistic measures.
summarytext- One readable sentence about the answer.
unittext- What the values count, e.g. BTC or USD.
valueslist- The values over time.
Example output
{
"count": 3,
"currency": null,
"latest_time": "2026-10-01T00:02:00Z",
"latest_value": 90117.48664207,
"pair": "BTC/USD",
"statistic": "longs",
"statistic_name": "Margin longs open on a pair",
"summary": "Margin longs open on a pair, BTC/USD: 90,117.49 BTC at 2026-10-01T00:02:00Z (newest of 3).",
"unit": "BTC",
"values": [
{
"time": "2026-10-01T00:00:00Z",
"timestamp_ms": 1790812800000,
"value": 90117.48519547
},
{
"time": "2026-10-01T00:01:00Z",
"timestamp_ms": 1790812860000,
"value": 90117.48557557
},
{
"time": "2026-10-01T00:02:00Z",
"timestamp_ms": 1790812920000,
"value": 90117.48664207
}
]
}List currencies
List the currencies Bitfinex holds with their codes and names, e.g. UST is Tether USDt, optionally only those matching some text.
Inputs
- Name or code contains
searchtext - Only currencies whose code or name contains this, e.g. tether. Leave blank for all.
Outputs
countnumber- How many rows are listed.
currencieslist- The currencies.
summarytext- One readable sentence about the answer.
Example output
{
"count": 7,
"currencies": [
{
"code": "AUSDT",
"name": "Alloy Tether",
"symbol": "aUSDT"
},
{
"code": "CNHT",
"name": "Tether CNHt",
"symbol": "CNHt"
},
{
"code": "MXNT",
"name": "Tether MXNt",
"symbol": "MXNt"
},
{
"code": "UST",
"name": "Tether USDt",
"symbol": "USDt"
},
{
"code": "USTF0",
"name": "Tether USDt",
"symbol": "USDt"
},
{
"code": "XAUT",
"name": "Tether XAUt",
"symbol": "XAUt"
},
{
"code": "XAUT0BNB",
"name": "Tether(XAU) on BNB Chain",
"symbol": "XAUt"
}
],
"summary": "Bitfinex lists 7 currencies matching 'tether'."
}List liquidations
List the margin and perpetual positions Bitfinex has liquidated, newest first or between two times, with the pair, side, size and prices. Bitfinex allows only 3 of these a minute.
Inputs
- From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most liquidations
limitnumber - How many liquidation records to list, from 1 to 500. Defaults to 50.From 1 to 500. Default:
50. - Order
ordertext - Newest first, or oldest first.One of:
newest(Newest first),oldest(Oldest first). Default:newest.
Outputs
countnumber- How many rows are listed.
liquidationslist- Each liquidation record: Bitfinex lists a position when liquidation is triggered and again when it is executed.
summarytext- One readable sentence about the answer.
Example output
{
"count": 2,
"liquidations": [
{
"amount": 1e-08,
"base_price": 0.094586,
"pair": "DOGE/USDT perpetual",
"position_id": 194310216,
"price_acquired": null,
"side": "short",
"sold_into_market": true,
"stage": "triggered",
"symbol": "tDOGEF0:USTF0",
"time": "2026-10-01T00:26:45Z",
"timestamp_ms": 1790814405426
},
{
"amount": 1e-08,
"base_price": 0.094586,
"pair": "DOGE/USDT perpetual",
"position_id": 194310216,
"price_acquired": 0.0946135,
"side": "short",
"sold_into_market": false,
"stage": "triggered",
"symbol": "tDOGEF0:USTF0",
"time": "2026-10-01T00:26:45Z",
"timestamp_ms": 1790814405428
}
],
"summary": "2 liquidation records, from 2026-10-01T00:26:45Z to 2026-10-01T00:26:45Z."
}List prices
Get the price and last 24 hours of several trading pairs in one step, or of every pair, optionally biggest rise or biggest fall first, to find the day's movers.
Inputs
- Pairs
pairslist - The trading pairs, e.g. BTC/USD and ETH/USD. Leave blank for every pair.
- Sort by
sorttext - Which pairs come first.One of:
pair,rise(Biggest rise first),fall(Biggest fall first). Default:pair. - Most pairs
limitnumber - How many pairs to list, from 1 to 500, after sorting. Leave blank for all.From 1 to 500.
Outputs
countnumber- How many rows are listed.
missing_pairslist- Pairs asked for that Bitfinex doesn't trade.
summarytext- One readable sentence about the answer.
tickerslist- Each pair's ticker.
Example output
{
"count": 2,
"missing_pairs": [],
"summary": "Prices for 2 Bitfinex trading pairs. Best 24 hours: ETH/USD (-0.6056%); worst: BTC/USD (-1.2117%).",
"tickers": [
{
"ask": 2249.3,
"ask_size": 305.71781755,
"base_currency": "ETH",
"bid": 2248.6,
"bid_size": 920.58969779,
"change_24h": -13.7,
"change_24h_percent": -0.6056,
"first_trade_time": "2016-03-09T16:04:35Z",
"high_24h": 2318.4,
"last_price": 2248.4,
"low_24h": 2238.1,
"pair": "ETH/USD",
"quote_currency": "USD",
"spread": 0.7,
"summary": "ETH/USD last traded at 2,248.4 USD, down 0.6056% over 24 hours (high 2,318.4, low 2,238.1, volume 9,663.27 ETH).",
"symbol": "tETHUSD",
"volume_24h": 9663.2726035
},
{
"ask": 76966,
"ask_size": 1.82340801,
"base_currency": "BTC",
"bid": 76949,
"bid_size": 2.87805669,
"change_24h": -944,
"change_24h_percent": -1.2117,
"first_trade_time": "2013-01-14T16:47:23Z",
"high_24h": 78922,
"last_price": 76965,
"low_24h": 76701,
"pair": "BTC/USD",
"quote_currency": "USD",
"spread": 17,
"summary": "BTC/USD last traded at 76,965 USD, down 1.2117% over 24 hours (high 78,922, low 76,701, volume 419.2649 BTC).",
"symbol": "tBTCUSD",
"volume_24h": 419.2648803
}
]
}List recent trades
List a trading pair's trades, newest first or between two times, each with its side, amount and price, and the amounts bought and sold with their average price.
Inputs
- Pair
pairtextRequired - The trading pair, e.g. BTC/USD. Pick from the list, or type it as BTC/USD, btcusd or tBTCUSD.
- From
startdate and time - Only from this time on. Leave blank for the newest.
- To
enddate and time - Only up to this time. Leave blank for up to now.
- Most trades
limitnumber - How many trades to list, from 1 to 10,000. Defaults to 50.From 1 to 10000. Default:
50. - Order
ordertext - Newest first, or oldest first.One of:
newest(Newest first),oldest(Oldest first). Default:newest.
Outputs
average_pricenumber- The volume-weighted average price of these trades.
buy_volumenumber- How much was bought in these trades, in the base currency.
countnumber- How many rows are listed.
pairtext- The pair as people write it, e.g. BTC/USD.
sell_volumenumber- How much was sold in these trades, in the base currency.
summarytext- One readable sentence about the answer.
symboltext- Bitfinex's symbol for the pair, e.g. tBTCUSD.
tradeslist- The trades.
Example output
{
"average_price": 83609.67338059,
"buy_volume": 0.00047841,
"count": 3,
"pair": "BTC/USD",
"sell_volume": 0.00061782,
"summary": "3 BTC/USD trades: 0.00047841 BTC bought and 0.00061782 BTC sold at an average 83,609.67 USD.",
"symbol": "tBTCUSD",
"trades": [
{
"amount": 0.00039782,
"price": 83604,
"side": "sell",
"time": "2026-10-01T00:00:00Z",
"timestamp_ms": 1790812800882,
"trade_id": 1985618920,
"value": 33.25934328
},
{
"amount": 0.00022,
"price": 83604,
"side": "sell",
"time": "2026-10-01T00:00:00Z",
"timestamp_ms": 1790812800882,
"trade_id": 1985618919,
"value": 18.39288
},
{
"amount": 0.00047841,
"price": 83617,
"side": "buy",
"time": "2026-10-01T00:00:01Z",
"timestamp_ms": 1790812801860,
"trade_id": 1985618921,
"value": 40.00320897
}
]
}List trading pairs
List the pairs Bitfinex trades, with the smallest and largest order and whether each can be traded on margin, optionally only those with one currency.
Inputs
- With currency
currencytext - Only pairs that buy or sell this currency, e.g. BTC. Leave blank for every pair.
Outputs
countnumber- How many rows are listed.
pairslist- The trading pairs, by name.
summarytext- One readable sentence about the answer.
Example output
{
"count": 5,
"pairs": [
{
"base_currency": "BTC",
"first_trade_time": "2021-10-01T11:45:31Z",
"margin_trading": false,
"max_order_size": 250.0,
"min_order_size": 4e-05,
"pair": "BTC/XAUT",
"quote_currency": "XAUT",
"symbol": "tBTC:XAUT"
},
{
"base_currency": "ETH",
"first_trade_time": "2021-10-01T12:02:40Z",
"margin_trading": false,
"max_order_size": 2500.0,
"min_order_size": 0.0008,
"pair": "ETH/XAUT",
"quote_currency": "XAUT",
"symbol": "tETH:XAUT"
},
{
"base_currency": "XAUT",
"first_trade_time": "2020-01-24T15:04:35Z",
"margin_trading": true,
"max_order_size": 400.0,
"min_order_size": 0.002,
"pair": "XAUT/BTC",
"quote_currency": "BTC",
"symbol": "tXAUT:BTC"
},
{
"base_currency": "XAUT",
"first_trade_time": "2020-01-24T14:35:07Z",
"margin_trading": true,
"max_order_size": 400.0,
"min_order_size": 0.002,
"pair": "XAUT/USD",
"quote_currency": "USD",
"symbol": "tXAUT:USD"
},
{
"base_currency": "XAUT",
"first_trade_time": "2020-01-25T09:45:45Z",
"margin_trading": true,
"max_order_size": 400.0,
"min_order_size": 0.002,
"pair": "XAUT/USDT",
"quote_currency": "USDT",
"symbol": "tXAUT:UST"
}
],
"summary": "Bitfinex trades 5 pairs with XAUT."
}