Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalogue, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn’t in the catalogue yet?

Yes, through the community Discord, on any tier.

Bybit

Bybit v5 market data: candles, 5-minute open interest and account ratios with cursor pagination, funding history and instrument specs.

11 endpoints22.4k calls11/11 passing

Get API key

Account Ratio

Long/short account ratio for one Bybit derivatives contract.

GET/v1/finance:bybit/account-ratio

passing · 0.2s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. The ratio is published for derivatives only. One of linear, inverse.
period	enum	query	Sampling interval. Default 5min. One of 5min, 15min, 30min, 1h, 4h, 1d.
start	string	query	Oldest point to include. Epoch ms/s or ISO date.
end	string	query	Newest point to include. Epoch ms/s or ISO date.
count	number	query	Points per page. Default 200, max 500.
page	number	query	Page number. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"date":"2026-08-21T14:15:00.000Z","time":1787321700000,"longRatio":0.541,"shortRatio":0.459      },      {"date":"2026-08-21T14:20:00.000Z","time":1787322000000,"longRatio":0.5405,"shortRatio":0.4595      },      {"date":"2026-08-21T14:25:00.000Z","time":1787322300000,"longRatio":0.5394,"shortRatio":0.4606      },      {"date":"2026-08-21T14:30:00.000Z","time":1787322600000,"longRatio":0.5403,"shortRatio":0.4597      },      {"date":"2026-08-21T14:35:00.000Z","time":1787322900000,"longRatio":0.541,"shortRatio":0.459      },      {"date":"2026-08-21T14:40:00.000Z","time":1787323200000,"longRatio":0.541,"shortRatio":0.459      },      {"date":"2026-08-21T14:45:00.000Z","time":1787323500000,"longRatio":0.5405,"shortRatio":0.4595      },      {"date":"2026-08-21T14:50:00.000Z","time":1787323800000,"longRatio":0.5414,"shortRatio":0.4586      }    ],"period":"5min","symbol":"BTCUSDT","dataset":"account-ratio","hasMore":true,"category":"linear","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Funding History

Settled funding rates for one Bybit perpetual.

GET/v1/finance:bybit/funding-history

passing · 0.1s1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Funding applies to perpetuals only. One of linear, inverse.
start	string	query	Oldest settlement to include. Epoch ms/s or ISO date.
end	string	query	Newest settlement to include. Epoch ms/s or ISO date.
count	number	query	Settlements per page. Default 200, max 200.
page	number	query	Page number, walking backwards in time. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"date":"2026-06-16T16:00:00.000Z","time":1781625600000,"symbol":"BTCUSDT","fundingRate":0.00004902      },      {"date":"2026-06-17T00:00:00.000Z","time":1781654400000,"symbol":"BTCUSDT","fundingRate":0.00005459      },      {"date":"2026-06-17T08:00:00.000Z","time":1781683200000,"symbol":"BTCUSDT","fundingRate":0.00001567      },      {"date":"2026-06-17T16:00:00.000Z","time":1781712000000,"symbol":"BTCUSDT","fundingRate":0.0000036      },      {"date":"2026-06-18T00:00:00.000Z","time":1781740800000,"symbol":"BTCUSDT","fundingRate":-0.00000327      },      {"date":"2026-06-18T08:00:00.000Z","time":1781769600000,"symbol":"BTCUSDT","fundingRate":-0.00001297      },      {"date":"2026-06-18T16:00:00.000Z","time":1781798400000,"symbol":"BTCUSDT","fundingRate":-0.00002986      },      {"date":"2026-06-19T00:00:00.000Z","time":1781827200000,"symbol":"BTCUSDT","fundingRate":-0.0000469      }    ],"symbol":"BTCUSDT","dataset":"funding-history","hasMore":true,"category":"linear","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Index Price Kline

Index-price candles for one Bybit derivatives contract.

GET/v1/finance:bybit/index-price-kline

passing · 0.1s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Default linear. One of linear, inverse.
interval	enum	query	Candle size in minutes, or D/W/M. Default 5. One of 1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, W, M.
start	string	query	Oldest candle to include. Epoch ms/s or ISO date.
end	string	query	Newest candle to include. Epoch ms/s or ISO date.
count	number	query	Candles per page. Default 200, max 1000.
page	number	query	Page number, walking backwards in time. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"low":76551.94,"date":"2026-08-21T14:15:00.000Z","high":76969,"open":76766.15,"close":76662.95,"openTime":1787321700000,"closeTime":1787321999999      },      {"low":76552.24,"date":"2026-08-21T14:20:00.000Z","high":77088.57,"open":76662.95,"close":77023.18,"openTime":1787322000000,"closeTime":1787322299999      },      {"low":76997.76,"date":"2026-08-21T14:25:00.000Z","high":77199.27,"open":77023.18,"close":77064.48,"openTime":1787322300000,"closeTime":1787322599999      },      {"low":77060.76,"date":"2026-08-21T14:30:00.000Z","high":77223.69,"open":77064.48,"close":77095.41,"openTime":1787322600000,"closeTime":1787322899999      },      {"low":76858.2,"date":"2026-08-21T14:35:00.000Z","high":77237.6,"open":77095.41,"close":76864.36,"openTime":1787322900000,"closeTime":1787323199999      },      {"low":76861.61,"date":"2026-08-21T14:40:00.000Z","high":77146.97,"open":76864.36,"close":77143.94,"openTime":1787323200000,"closeTime":1787323499999      },      {"low":77121.32,"date":"2026-08-21T14:45:00.000Z","high":77365.53,"open":77143.94,"close":77342.6,"openTime":1787323500000,"closeTime":1787323799999      },      {"low":77295.4,"date":"2026-08-21T14:50:00.000Z","high":77439.05,"open":77342.6,"close":77303.98,"openTime":1787323800000,"closeTime":1787324099999      }    ],"symbol":"BTCUSDT","dataset":"index-price-kline","hasMore":true,"category":"linear","interval":"5","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Instruments Info

Contract specifications: tick size, lot size, leverage, minimum notional.

GET/v1/finance:bybit/instruments-info

slow · 0.4s10m cache

Parameters

Name	Type	In	Description
category	enum	query	Product line. Default linear. One of linear, inverse, spot, option.
symbol	string	query	One symbol. Omit to list the whole product line.
baseCoin	string	query	Filter by base coin.
status	enum	query	Filter by contract status. One of Trading, PreLaunch, Delivering, Closed.
count	number	query	Instruments per page. Default 500, max 1000.
page	number	query	Page number. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":500,    "items": [      {"status":"Trading","symbol":"0GUSDT","qtyStep":0.1,"baseCoin":"0G","maxPrice":1999.9998,"minPrice":0.0001,"tickSize":0.0001,"quoteCoin":"USDT","launchDate":"2025-09-18T06:08:56.000Z","launchTime":1758175736000,"priceScale":4,"settleCoin":"USDT","copyTrading":"both","maxLeverage":50,"maxOrderQty":350000,"minLeverage":1,"minOrderQty":0.1,"contractType":"LinearPerpetual","leverageStep":0.01,"minNotionalValue":5,"unifiedMarginTrade":true,"fundingIntervalMinutes":240      },      {"status":"Trading","symbol":"1000000BABYDOGEUSDT","qtyStep":100,"baseCoin":"1000000BABYDOGE","maxPrice":1.9999998,"minPrice":1e-7,"tickSize":1e-7,"quoteCoin":"USDT","launchDate":"2024-06-11T11:34:12.000Z","launchTime":1718105652000,"priceScale":7,"settleCoin":"USDT","copyTrading":"both","maxLeverage":25,"maxOrderQty":220000000,"minLeverage":1,"minOrderQty":100,"contractType":"LinearPerpetual","leverageStep":0.01,"minNotionalValue":5,"unifiedMarginTrade":true,"fundingIntervalMinutes":240      }    ],"symbol":null,"dataset":"instruments-info","hasMore":true,"baseCoin":null,"category":"linear","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Kline

OHLCV candles for one Bybit spot or derivatives symbol.

GET/v1/finance:bybit/kline

passing · 0.1s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Default linear. One of linear, inverse, spot.
interval	enum	query	Candle size in minutes, or D/W/M. Default 5. One of 1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, W, M.
start	string	query	Oldest candle to include. Epoch ms/s or ISO date.
end	string	query	Newest candle to include. Epoch ms/s or ISO date.
count	number	query	Candles per page. Default 200, max 1000.
page	number	query	Page number, walking backwards in time. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"low":76535.3,"date":"2026-08-21T14:15:00.000Z","high":76968.9,"open":76762.3,"close":76662.9,"volume":571.511,"openTime":1787321700000,"turnover":43857483.1506,"closeTime":1787321999999      },      {"low":76544,"date":"2026-08-21T14:20:00.000Z","high":77094.2,"open":76662.9,"close":77012.4,"volume":950.169,"openTime":1787322000000,"turnover":73025640.7736,"closeTime":1787322299999      },      {"low":76979.6,"date":"2026-08-21T14:25:00.000Z","high":77215.7,"open":77012.4,"close":77057.9,"volume":451.086,"openTime":1787322300000,"turnover":34779300.3926,"closeTime":1787322599999      }    ],"symbol":"BTCUSDT","dataset":"kline","hasMore":true,"category":"linear","interval":"5","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Mark Price Kline

Mark-price candles for one Bybit derivatives contract.

GET/v1/finance:bybit/mark-price-kline

passing · 0.1s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Default linear. One of linear, inverse.
interval	enum	query	Candle size in minutes, or D/W/M. Default 5. One of 1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, W, M.
start	string	query	Oldest candle to include. Epoch ms/s or ISO date.
end	string	query	Newest candle to include. Epoch ms/s or ISO date.
count	number	query	Candles per page. Default 200, max 1000.
page	number	query	Page number, walking backwards in time. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"low":76549.86,"date":"2026-08-21T14:15:00.000Z","high":76952.7,"open":76762.4,"close":76661.02,"openTime":1787321700000,"closeTime":1787321999999      },      {"low":76553.34,"date":"2026-08-21T14:20:00.000Z","high":77090.5,"open":76661.02,"close":77023.13,"openTime":1787322000000,"closeTime":1787322299999      },      {"low":76996.67,"date":"2026-08-21T14:25:00.000Z","high":77185.03,"open":77023.13,"close":77060.69,"openTime":1787322300000,"closeTime":1787322599999      },      {"low":77058.8,"date":"2026-08-21T14:30:00.000Z","high":77225.06,"open":77060.69,"close":77090.06,"openTime":1787322600000,"closeTime":1787322899999      },      {"low":76855.1,"date":"2026-08-21T14:35:00.000Z","high":77233.3,"open":77090.06,"close":76862.9,"openTime":1787322900000,"closeTime":1787323199999      },      {"low":76855.1,"date":"2026-08-21T14:40:00.000Z","high":77145.77,"open":76862.9,"close":77145.77,"openTime":1787323200000,"closeTime":1787323499999      },      {"low":77123.25,"date":"2026-08-21T14:45:00.000Z","high":77366.91,"open":77145.77,"close":77345.3,"openTime":1787323500000,"closeTime":1787323799999      },      {"low":77296.48,"date":"2026-08-21T14:50:00.000Z","high":77443.34,"open":77345.3,"close":77308.42,"openTime":1787323800000,"closeTime":1787324099999      }    ],"symbol":"BTCUSDT","dataset":"mark-price-kline","hasMore":true,"category":"linear","interval":"5","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Open Interest

Open-interest series for one Bybit derivatives contract, down to five minutes.

GET/v1/finance:bybit/open-interest

passing · 0.1s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Open interest is published for derivatives only. One of linear, inverse.
intervalTime	enum	query	Sampling interval. Default 5min. One of 5min, 15min, 30min, 1h, 4h, 1d.
start	string	query	Oldest point to include. Epoch ms/s or ISO date.
end	string	query	Newest point to include. Epoch ms/s or ISO date.
count	number	query	Points per page. Default 200, max 200.
page	number	query	Page number. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"date":"2026-08-21T14:15:00.000Z","time":1787321700000,"openInterest":49825.159,"singleOpenInterest":24912.58      },      {"date":"2026-08-21T14:20:00.000Z","time":1787322000000,"openInterest":49904.981,"singleOpenInterest":24952.491      },      {"date":"2026-08-21T14:25:00.000Z","time":1787322300000,"openInterest":49950.202,"singleOpenInterest":24975.101      },      {"date":"2026-08-21T14:30:00.000Z","time":1787322600000,"openInterest":49894.376,"singleOpenInterest":24947.188      },      {"date":"2026-08-21T14:35:00.000Z","time":1787322900000,"openInterest":49893.606,"singleOpenInterest":24946.803      },      {"date":"2026-08-21T14:40:00.000Z","time":1787323200000,"openInterest":49727.085,"singleOpenInterest":24863.543      },      {"date":"2026-08-21T14:45:00.000Z","time":1787323500000,"openInterest":49747.449,"singleOpenInterest":24873.725      },      {"date":"2026-08-21T14:50:00.000Z","time":1787323800000,"openInterest":49773.817,"singleOpenInterest":24886.909      }    ],"symbol":"BTCUSDT","dataset":"open-interest","hasMore":true,"category":"linear","nextPage":2,"provider":"bybit","intervalTime":"5min"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Orderbook

Order-book snapshot for one Bybit symbol.

GET/v1/finance:bybit/orderbook

passing · 0.1sno cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Default linear. One of linear, inverse, spot, option.
count	number	query	Levels per side. Capped at 500 linear/inverse, 200 spot, 25 option.

Example response

{"project":"finance:bybit",  "data": {    "asks": [      {"size":0.009,"price":77505.3      },      {"size":0.001,"price":77505.4      },      {"size":0.001,"price":77506      },      {"size":0.071,"price":77506.7      },      {"size":0.002,"price":77507      },      {"size":0.001,"price":77508.9      },      {"size":0.001,"price":77510.4      },      {"size":0.002,"price":77510.5      }    ],    "bids": [      {"size":5.51,"price":77505.2      },      {"size":0.001,"price":77505.1      },      {"size":0.565,"price":77504.8      },      {"size":0.287,"price":77504.5      },      {"size":0.433,"price":77504.1      },      {"size":0.288,"price":77504      },      {"size":0.002,"price":77503.8      },      {"size":0.432,"price":77503.7      }    ],"date":"2026-08-22T06:51:01.405Z","time":1787381461405,"symbol":"BTCUSDT","dataset":"orderbook","askCount":50,"bidCount":50,"category":"linear","provider":"bybit","sequence":786674036292,"updateId":12964032,"matchTime":1787381461404  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Premium Index Kline

Premium-index candles — the basis Bybit funds against — for one perpetual.

GET/v1/finance:bybit/premium-index-kline

passing · 0.1s30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Premium index is published for linear contracts only. One of linear.
interval	enum	query	Candle size in minutes, or D/W/M. Default 5. One of 1, 3, 5, 15, 30, 60, 120, 240, 360, 720, D, W, M.
start	string	query	Oldest candle to include. Epoch ms/s or ISO date.
end	string	query	Newest candle to include. Epoch ms/s or ISO date.
count	number	query	Candles per page. Default 200, max 1000.
page	number	query	Page number, walking backwards in time. Default 1, max 20.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"low":-0.00011059,"date":"2026-08-21T14:15:00.000Z","high":-0.00008915,"open":-0.00005986,"close":-0.00011059,"openTime":1787321700000,"closeTime":1787321999999      },      {"low":-0.00004943,"date":"2026-08-21T14:20:00.000Z","high":0.00014251,"open":-0.00011059,"close":-0.00004943,"openTime":1787322000000,"closeTime":1787322299999      },      {"low":-0.00000355,"date":"2026-08-21T14:25:00.000Z","high":0,"open":-0.00004943,"close":-0.00000355,"openTime":1787322300000,"closeTime":1787322599999      },      {"low":-0.00013182,"date":"2026-08-21T14:30:00.000Z","high":0,"open":-0.00000355,"close":-0.00013182,"openTime":1787322600000,"closeTime":1787322899999      },      {"low":-0.000099,"date":"2026-08-21T14:35:00.000Z","high":0,"open":-0.00013182,"close":0,"openTime":1787322900000,"closeTime":1787323199999      },      {"low":-0.00002121,"date":"2026-08-21T14:40:00.000Z","high":0,"open":0,"close":-0.00002121,"openTime":1787323200000,"closeTime":1787323499999      },      {"low":0.00003269,"date":"2026-08-21T14:45:00.000Z","high":0.00003375,"open":-0.00002121,"close":0.00003269,"openTime":1787323500000,"closeTime":1787323799999      },      {"low":0.00007119,"date":"2026-08-21T14:50:00.000Z","high":0.00014635,"open":0.00003269,"close":0.00014635,"openTime":1787323800000,"closeTime":1787324099999      }    ],"symbol":"BTCUSDT","dataset":"premium-index-kline","hasMore":true,"category":"linear","interval":"5","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Recent Trade

Public prints for one Bybit symbol, newest first.

GET/v1/finance:bybit/recent-trade

passing · 0.1s5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt. Required.
category	enum	query	Product line. Default linear. One of linear, inverse, spot, option.
baseCoin	string	query	Base coin, for option prints across a whole coin.
count	number	query	Prints to return. Default 100, max 1000 (spot caps at 60).

Example response

{"project":"finance:bybit",  "data": {"count":100,    "items": [      {"date":"2026-08-22T06:51:00.881Z","side":"sell","size":0.001,"time":1787381460881,"price":77501,"symbol":"BTCUSDT","tradeId":"2c89e68c-fb52-5c18-8b88-5220608dc058","sequence":786674002571,"isRpiTrade":false,"isBlockTrade":false      },      {"date":"2026-08-22T06:51:00.881Z","side":"sell","size":0.001,"time":1787381460881,"price":77501.1,"symbol":"BTCUSDT","tradeId":"98100331-249f-5bcd-9d63-b74b03aed3bc","sequence":786674002571,"isRpiTrade":false,"isBlockTrade":false      },      {"date":"2026-08-22T06:51:00.881Z","side":"sell","size":0.001,"time":1787381460881,"price":77501.1,"symbol":"BTCUSDT","tradeId":"5511e988-a85a-59ed-843c-5b358bf46ab9","sequence":786674002571,"isRpiTrade":false,"isBlockTrade":false      }    ],"symbol":"BTCUSDT","dataset":"recent-trade","category":"linear","provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Tickers

24h statistics for every Bybit symbol in one product line, or for one symbol.

GET/v1/finance:bybit/tickers

slow · 0.4s15s cache

Parameters

Name	Type	In	Description
category	enum	query	Product line. Default linear. One of linear, inverse, spot, option.
symbol	string	query	One symbol. Omit to list the whole product line.
baseCoin	string	query	Filter by base coin. Required for option when no symbol is given.
expDate	string	query	Option expiry filter, Bybit's own DDMMMYY form.

Example response

{"project":"finance:bybit",  "data": {"count":837,    "items": [      {"symbol":"0GUSDT","askSize":387.8,"bidSize":385.9,"askPrice":0.1687,"bidPrice":0.1686,"lastPrice":0.1687,"markPrice":0.1687,"volume24h":13622457.9,"indexPrice":0.1686,"fundingRate":0.00005,"lowPrice24h":0.1415,"prevPrice1h":0.1673,"turnover24h":2302180.649,"highPrice24h":0.1891,"openInterest":10957531.4,"prevPrice24h":0.1641,"nextFundingDate":"2026-08-22T08:00:00.000Z","nextFundingTime":1787385600000,"openInterestValue":1848535.55,"priceChangePct24h":0.028031      },      {"symbol":"1000000BABYDOGEUSDT","askSize":390300,"bidSize":165200,"askPrice":0.0003929,"bidPrice":0.0003927,"lastPrice":0.000393,"markPrice":0.0003925,"volume24h":3443243800,"indexPrice":0.0003918,"fundingRate":0.00005,"lowPrice24h":0.0003689,"prevPrice1h":0.0003946,"turnover24h":1345216.6154,"highPrice24h":0.0004229,"openInterest":1236552200,"prevPrice24h":0.0003735,"nextFundingDate":"2026-08-22T08:00:00.000Z","nextFundingTime":1787385600000,"openInterestValue":485346.74,"priceChangePct24h":0.052208      },      {"symbol":"1000000MOGUSDT","askSize":2193,"bidSize":4930,"askPrice":0.1227,"bidPrice":0.1225,"lastPrice":0.1227,"markPrice":0.12261,"volume24h":19550740,"indexPrice":0.12184,"fundingRate":0.00043828,"lowPrice24h":0.1183,"prevPrice1h":0.1225,"turnover24h":2460836.7394,"highPrice24h":0.1367,"openInterest":9500852,"prevPrice24h":0.1186,"nextFundingDate":"2026-08-22T08:00:00.000Z","nextFundingTime":1787385600000,"openInterestValue":1164899.46,"priceChangePct24h":0.034569      }    ],"symbol":null,"dataset":"tickers","baseCoin":null,"category":"linear","provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Try it

Live request with your key

const data = await client.run(  "finance:bybit",  "account-ratio",  { symbol: "BTCUSDT", category: "linear", period: "5min", start: "2020-07-20T00:00:00Z", end: "2020-07-21T00:00:00Z", count: 200, page: 1 });

Bybit

Bybit v5 market data: candles, 5-minute open interest and account ratios with cursor pagination, funding history and instrument specs.

11 endpoints22.4k calls11/11 passing

Get API key

Long/short account ratio for one Bybit derivatives contract.

GET/v1/…bybit/account-ratio

passing · 0.2s30s cache

Try it

Parameters

symbol

string · query · required

Trading symbol. Accepts BTCUSDT, BTC/USDT or btc-usdt.

Example response

{"project":"finance:bybit",  "data": {"page":1,"count":200,    "items": [      {"date":"2026-08-21T14:15:00.000Z","time":1787321700000,"longRatio":0.541,"shortRatio":0.459      },      {"date":"2026-08-21T14:20:00.000Z","time":1787322000000,"longRatio":0.5405,"shortRatio":0.4595      },      {"date":"2026-08-21T14:25:00.000Z","time":1787322300000,"longRatio":0.5394,"shortRatio":0.4606      },      {"date":"2026-08-21T14:30:00.000Z","time":1787322600000,"longRatio":0.5403,"shortRatio":0.4597      },      {"date":"2026-08-21T14:35:00.000Z","time":1787322900000,"longRatio":0.541,"shortRatio":0.459      },      {"date":"2026-08-21T14:40:00.000Z","time":1787323200000,"longRatio":0.541,"shortRatio":0.459      },      {"date":"2026-08-21T14:45:00.000Z","time":1787323500000,"longRatio":0.5405,"shortRatio":0.4595      },      {"date":"2026-08-21T14:50:00.000Z","time":1787323800000,"longRatio":0.5414,"shortRatio":0.4586      }    ],"period":"5min","symbol":"BTCUSDT","dataset":"account-ratio","hasMore":true,"category":"linear","nextPage":2,"provider":"bybit"  },"timestamp":"2026-08-20T14:56:32Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:bybit",  "account-ratio",  { symbol: "BTCUSDT", category: "linear", period: "5min", start: "2020-07-20T00:00:00Z", end: "2020-07-21T00:00:00Z", count: 200, page: 1 });