Bybit trading journal
FOQUS keeps a trading journal for your Bybit account by itself. Every USDT and USDC perpetual position goes in without manual entry, with its fees, funding and stop history. It connects with a Read-Only key on a Unified Trading Account, and the journal is free forever.
What FOQUS records from Bybit
FOQUS records Bybit perpetual futures settled in USDT, such as BTCUSDT, and in USDC, such as BTCPERP. An open position appears in the journal at once. Its profit, stop and time in the trade update live.
Every trade keeps:
- Fills. Opening, adding, trimming and closing, each at its price and size and with its fee.
- Stop and take-profit. Every placement, removal and move, and whether the order fired.
- Funding. Each settlement credited or charged during the hold.
- Liquidation. Marked on the trade's timeline as an action of its own.
- Entry limit orders. From placement through amendments to cancellation.
- The account at the open. Wallet balance, equity and whatever else was open at that moment.
- The market at each action. How far price moved and how much traded in the last 5 minutes, hour and day, plus RSI, funding, open interest and the long/short ratio.
- Order book. Recorded for a minute either side of every open, add, trim and close: Bybit's futures book, and the spot book alongside when the coin has one. Ten recordings a day on the free plan.
What all this looks like on one trade — the second you entered, a moved stop, funding — is shown by the timeline on the home page. What a trade could have made and how much it gave back is covered in the guide to MAE and MFE.
Which Bybit sites work
Bybit runs separate sites for several countries, each with its own API address, and a key works only with the address of its own site. FOQUS connects six: bybit.com, bybit.tr, bybit.kz, bybitgeorgia.ge, bybit.ae and bybit.id. There is nothing to pick: at connection FOQUS tries the addresses one after another and stops at the first that recognises your key.
FOQUS doesn't connect Bybit EU, Japan or Hong Kong accounts. Bybit's documentation says the Bybit EU API serves only brokers' third-party apps. FOQUS won't find such a key and answers: “Bybit doesn’t know this key”.
One more condition: a Unified Trading Account (UTA). FOQUS won't save a key from a classic account and says “Bybit rejected the key. Check the key and secret — and remove the IP restriction if one is set.” If the key and secret are definitely correct and the error repeats, check your account type.
How to create a read-only Bybit API key
Keys are created on the Bybit website only; the app can't do it. A new Bybit account may be unable to create keys for the first 48 hours after sign-up.
- Log in on the Bybit site that holds your account. Click the profile icon at the top right and choose API. On bybit.com that is the API Management page.
- Click Create New Key and choose System-generated API Keys: Bybit creates the key and the secret itself.
- Under API Key Usage, keep API Transaction. Connect to Third-Party Applications is for the apps on Bybit's list.
- Name the key, FOQUS for example. Under API Key Permissions, choose Read-Only.
- Tick every box you can: Orders, Positions and the rest. In Read-Only mode each of them only views.
- Choose No IP restriction. FOQUS publishes no list of its addresses, so a key bound to IPs won't work.
- Click Submit, enter the verification codes, one from the email and one from Google Authenticator, and click Next Step. Copy the API Key and API Secret: Bybit shows the secret once.
- Create a FOQUS account and pick Bybit under Connect your own account. If you already use FOQUS, open the account menu → Add account. Paste the key and the secret and click Connect exchange.
The labels above are from bybit.com in English; other languages and regional Bybit sites may word them differently. The guide to the read-only API key walks through Bybit's key next to Binance's and OKX's.
How long a Bybit API key without IP restriction lasts
Bybit keeps a key without an IP binding for three months, and a key bound to IPs for good. After you change your account password, old keys stop working within 7 days. When a key expires, FOQUS marks the account “The exchange refused the key — the account is not being recorded”.
Extend the key before then, without replacing it. Open API Management and click edit in the IP Address Added column. Choose No IP restriction, click Submit and confirm with your email and 2FA codes. The key is valid for 90 days from that day again, with the same key and secret.
If it has already expired, create a new key and paste it into FOQUS: account menu → Edit account. The new key has to be from the same Bybit account. FOQUS refuses a key from another one with “This key belongs to a different exchange account”.
Is it safe to give FOQUS a Bybit key?
- Read-Only is checked, not assumed. At connection FOQUS asks Bybit for the key's mode. A Read-Write key gets “The key is not read-only” and is thrown away.
- Only reads go out. FOQUS sends Bybit GET requests for fills, orders, positions and balance. None of them places an order, moves funds or withdraws, and a Read-Only key couldn't anyway.
- Kept on file: the key, the secret in encrypted form, and which Bybit site the key belongs to.
- Leaving: remove the account in FOQUS, which takes its trades with it, then delete the key in Bybit's API Management.
Out of FOQUS's sight on Bybit: spot, options, dated futures and coin-margined inverse contracts such as BTCUSD. Trades from before the connection stay out too: an account's history at Bybit has no order book for them, and Bybit's order history returns cancelled orders for the last 24 hours only. Before the next entry, the position size calculator works out the size for a given stop. Prefer a spreadsheet? There is a free trading journal template. The other venues: Binance, OKX, MetaTrader 5.
Bybit trading journal FAQ
Will my old Bybit history be imported?
No, by design: an old history holds too little to review a trade. It has no order book, and Bybit's order history returns cancelled stops for the last 24 hours only. So FOQUS records each trade itself from the minute you connect: the stops, the account and market snapshots at entry, the order book. A position opened earlier stays out, even if you close it afterwards.
Does FOQUS work with Bybit spot?
No. FOQUS records USDT and USDC perpetual futures only, and spot trades stay out of the journal. But an order-book recording shows the coin's spot book next to its futures book.
Will a bybit.tr, bybit.kz or other regional account work?
Yes. bybit.com, bybit.tr, bybit.kz, bybitgeorgia.ge, bybit.ae and bybit.id all work. Create the key on the site that holds your account, and FOQUS finds out whose key it is. Bybit EU, Japan and Hong Kong accounts don't connect.
Why did my Bybit account stop updating?
Most often the key has expired: without an IP binding Bybit keeps it for three months. After a password change, old keys stop working within 7 days. Extend the key, or paste a new one from the same account into Edit account.
Can I connect several accounts or a subaccount?
Yes. Every account or subaccount needs its own Read-Only key, and there is no cap on how many you add. A subaccount must be unified (UTA) as well. Adding the same Bybit account a second time fails, whichever key you use.
Sources
- Bybit: How to Create Your API Key? — keys are created on the website only, the 48-hour limit for new accounts, the steps and the Create New Key window: API Transaction, Read-Only, No IP restriction. Its picture of the API Management page also says a key not bound to IPs is valid for three months, an old key expires within 7 days of a password change, and the secret is shown once. Last updated 25 November 2025.
- Bybit API: FAQ — a key without IP binding expires after 90 days; how to extend it while keeping the key and secret.
- Bybit API: Get API Key Information — the readOnly and uta fields FOQUS checks.
- Bybit API: Get Order History — orders that are Cancelled, Rejected or Deactivated are returned for the last 24 hours only; beyond 7 days only orders with fills.
- Bybit API: Get Orderbook — the order-book request takes an instrument and a depth, never a time, and returns the current book.
- Bybit API: Integration Guidance — the API addresses of regional Bybit sites; the Bybit EU API serves brokers' third-party apps only.