Features Sentinel Brokers Community Pricing About Us Why VEXA Support Get Access Now
Browse Brokers & importing trades

All topics

Connect Bybit

Bybit syncs hourly with a read-only API key, and its file export splits spot, derivatives and options into separate downloads.

Same on every platform Updated
On this page

What this does

Bybit syncs automatically once connected, pulling every hour. It covers spot, linear and inverse derivatives, and options.

Before you start

  • Read-only permissions. Account read is required, orders read is required, positions read is useful. Do not enable trading or withdrawal on the key you give VEXA.
  • The secret is shown once. Copy it immediately.
  • Bybit EU works too. If you trade on bybit.eu, create the key there. VEXA checks your key against Bybit Global and Bybit EU and connects to the right one.
  • The API reaches 180 days. Files reach two years.
  • Bybit timestamps are UTC and your trades display in UTC unless you set a display timezone.

Set up the automatic sync

Same on every platform

  1. In Bybit, open your account menu and go to API Management.
  2. Choose Create New Key and pick the API transaction type.
  3. Set the permissions to read only.
  4. Complete the verification step.
  5. Copy the key and the secret.
  6. In VEXA, open the Bybit page and paste both, then save.

Steps

Same on every platform

Download a file for older history

  1. In Bybit, open Orders, then Unified Trading Order.
  2. Pick the product tab: Spot or Futures (derivatives). Options export separately.
  3. Choose Trade History, not Order History. Trade History lists every fill; Order History lists orders, including ones that never filled, and VEXA cannot rebuild trades from it.
  4. Set the date range. Bybit allows up to six months per export within the last two years, and up to 10,000 rows per file.
  5. Click Export and download the CSV.
  6. Upload it to VEXA.
  7. Repeat for each product type you trade, and for each six-month window.

Limits and gotchas

  • Closed P&L exports are accepted for USDT and USDC perpetuals. Each closed position row becomes one trade, with P&L and fees exactly as Bybit reports them. Entry times are approximate because Bybit does not include the position’s open time. Trade History is the better export when available; Bybit allows it for the last two years.
  • Three exports, not one. A derivatives trader who exports only spot gets an import with almost nothing in it, and no error to explain why. See Some of my trades are missing.
  • Trade History, not Order History. The Order History file is a list of orders and is not an import format.
  • A file with only a header row means the date range had no fills. Widen the range and export again.
  • Fees are read from the file, so profits are net. A fee charged in a coin the file never prices is kept at zero and flagged in the import result rather than guessed.
  • Funding rows are skipped. The derivatives Trade History includes funding-fee rows (Filled Type “Funding”); they are not fills and are not booked as trades or fees.
  • Times are UTC to the minute. The derivatives export has no seconds, so fills in the same minute keep the file’s order.
  • A spot balance you are still holding is an open position. VEXA shows it in Portfolio rather than as a closed trade.

What you should see

After connecting, an Active badge and a first pull, then a last-sync time that advances hourly.

After an upload, a result panel naming the Bybit spot or derivatives format, once per file.

If it doesn’t work

  • The key was rejected. The permission set is wrong, or the secret was truncated when you copied it.
  • Most of your trades are missing. You have uploaded one product type. Export the others.
  • Trades look shifted by a few hours. Bybit reports in UTC. Set your display timezone rather than re-importing.

Related

Connect a broker Where the broker picker lives on each device, how to name the account, and what a successful first connection looks like. Connect Binance Binance syncs daily with a read-only API key. Give it reading permission and nothing else, and use the Data Download Center for history older than 180 days. When VEXA syncs your trades automatically How often each connected broker is pulled, why there is no auto-sync indicator anywhere in the app, and how to tell whether yours is running. Some of my trades are missing Part of your history imported and part did not. Almost always the export covered less than you thought, or your broker splits its history across several files.

Still stuck? Email support@vexatrade.ai.