← Back to PerpLog

Guide

How to create a read-only Bybit API key

Connect Bybit to PerpLog in about a minute. A read-only key lets PerpLog read your trade history — it can never place orders, change positions, or move funds. Follow the steps below.

  1. Open Bybit API Management

    Log in to your Bybit account and open the API management page.

    Open Bybit API Management
  2. Click “Create New Key”

    On the API management page, click “Create New Key”.

  3. Choose “System-generated API Key”

    Pick the system-generated option — that's the key type PerpLog connects with.

  4. Name the key, set read-only permissions

    Give the key a name, then under Contract enable Positions & Orders: read, plus Wallet: read. Do not enable any trade permissions — PerpLog rejects keys that can trade.

  5. Decide on the IP restriction

    Without an IP restriction the key expires after ~3 months — PerpLog reminds you in time. For a key that never expires, restrict it to PerpLog's server IP: 46.225.183.27

  6. Copy the API key and secret

    Bybit shows the secret only once — copy both right away.

  7. Paste both into PerpLog and connect

    Enter the key and secret in PerpLog's Add-Account form and connect.

Read-only by design

PerpLog does not have a single order endpoint — trading with your key is technically impossible.

Common issues

Key rejected over permissions

Your key either lacks read permissions or has trade permissions enabled. Recreate it with exactly the read-only set from step 4: Contract → Positions & Orders: read, Wallet: read.

Sync suddenly fails with an expired key

Keys without an IP restriction expire after ~3 months. Create a fresh read-only key and reconnect — PerpLog emails you a reminder ~75 days after connecting, before the key expires. A key restricted to PerpLog's server IP (46.225.183.27) never expires.

“Sign error” right after connecting

Key and secret are likely swapped. Re-paste carefully: the API key is the shorter public ID, the secret is the longer string shown only once at creation.

What the Bybit trading journal shows you after the sync

Ready to review your Bybit trades?

Create your read-only key, connect it, and start finding the mistakes that cost you. 14 days of Pro included — no credit card.

Start free