Bybit Integration — Import Your Crypto Portfolio to Freenance

Import Your Portfolio from Bybit

Bybit is one of the largest cryptocurrency exchanges in the world, known for its advanced trading features, deep liquidity, and extensive range of supported assets. Whether you are trading spot markets, holding assets in Bybit Earn, or participating in Launchpad events, your Bybit holdings are an important part of your overall financial picture. Freenance lets you import your Bybit portfolio so you can track your crypto assets alongside bank accounts, investments, bonds, and other financial instruments — all in one dashboard.

Freenance integrates with Bybit through a read-only API key. After a one-time setup, your portfolio refreshes automatically — no need to export CSVs every month. The API key is read-only, which means it cannot trade or move funds even if it were leaked.

Why Track Bybit in Freenance?

Bybit provides excellent trading tools, but it does not give you a complete view of your financial life. Here is what you gain by connecting Bybit to Freenance:

• Unified net worth — See your crypto holdings alongside bank accounts, ETFs, bonds, real estate, and liabilities. Know your true net worth at a glance
• Portfolio allocation — Understand what percentage of your total wealth is in crypto. If Bybit makes up 30% of your portfolio, you might want to rebalance
• Automatic valuations — Freenance fetches current cryptocurrency prices and calculates the value of your Bybit portfolio in your base currency (PLN, EUR, USD, etc.)
• Historical tracking — See how your Bybit portfolio value changes over time with charts and trend analysis
• Financial Freedom Runway — Include your crypto assets in the calculation of how many months you could sustain your lifestyle without income
• Risk awareness — Cryptocurrencies are volatile. Seeing them in context of your total portfolio helps you make more informed decisions

Step-by-Step Guide: API Key Integration

Once set up, Freenance automatically fetches your current balances and recent transactions from Bybit.

Step 1: Navigate to API Management

1. Log in to bybit.com
2. Click on your profile icon in the upper-right corner
3. Select API or go to Account & Security → API Management
4. Click Create New Key

Step 2: Configure API Key Permissions

This is the most important step for security. Follow these guidelines carefully:

1. Key name: Enter a descriptive name like "Freenance Read-Only" so you remember what this key is for
2. API Key type: Select System-generated API Keys
3. Permissions: Enable only Read-Only permissions. Specifically:
   • ✅ Read — allows Freenance to view your balances and transaction history
   • ❌ Trade — do NOT enable this. Freenance does not need trading permissions
   • ❌ Withdraw — do NOT enable this. Freenance never moves your funds
   • ❌ Transfer — do NOT enable this
4. IP restriction (recommended): For maximum security, you can restrict the API key to specific IP addresses. If you are unsure, you can skip this step — read-only keys cannot move your funds regardless
5. Click Submit and confirm with your 2FA method

Step 3: Copy Your API Credentials

1. After creation, you will see your API Key and API Secret
2. Copy both values immediately — the API Secret is only shown once and cannot be retrieved later
3. Store them securely. Do not share them with anyone other than Freenance

Step 4: Connect to Freenance

1. Sign in to Freenance at freenance.io
2. Open Configuration → Integrations and choose Bybit
3. Paste your API Key and API Secret in the respective fields
4. Click Connect
5. Freenance will verify the connection, fetch your current balances, and import your recent transaction history
6. Your Bybit portfolio will now appear in your Freenance dashboard

What Data Is Synced from Bybit?

Freenance imports and tracks the following data from your Bybit account:

Note on derivatives: Freenance focuses on tracking your actual asset holdings and realized gains. Open futures positions are not included in portfolio valuations because their value changes continuously and unrealized PnL is not a settled asset.

Security Best Practices for API Keys

Connecting a cryptocurrency exchange via API requires attention to security. Here are the best practices for keeping your Bybit account safe:

Use Read-Only Permissions Only

Freenance only needs read access to your account. Never grant trade, withdraw, or transfer permissions to any third-party application unless absolutely necessary. With read-only permissions, even if the API key were compromised, no funds could be moved.

Enable IP Whitelisting (Optional)

Bybit allows you to restrict API keys to specific IP addresses. If you know the IP address from which Freenance connects, you can add it to the whitelist for an extra layer of security.

Enable Two-Factor Authentication on Bybit

Always have 2FA enabled on your Bybit account. This protects not only your API keys but your entire account. Use an authenticator app (Google Authenticator, Authy) rather than SMS-based 2FA for better security.

Rotate API Keys Periodically

Consider generating a new API key every 6–12 months and revoking the old one. This limits the window of exposure if a key is ever compromised.

Monitor API Key Activity

Bybit provides logs of API key usage. Periodically check the API management page to ensure your keys are only being used as expected.

What Freenance Does NOT Do

• Freenance never executes trades on your behalf
• Freenance never withdraws or transfers funds
• Freenance never stores API keys in plain text — they are encrypted at rest
• Freenance never shares your API keys or portfolio data with third parties

Bybit vs. Binance: Which to Import?

If you use both Bybit and Binance (which many crypto traders do), import data from both exchanges into Freenance. Freenance will merge your holdings into a single, unified view of your crypto portfolio. You will see:

• Total crypto portfolio value across both exchanges
• Individual coin balances split by exchange
• Combined transaction history
• Overall crypto allocation as a percentage of your net worth

Automatic Valuations and Price Tracking

After importing your Bybit portfolio, Freenance automatically:

1. Fetches current prices — Freenance retrieves real-time cryptocurrency prices from multiple data sources to ensure accuracy
2. Converts to your base currency — all values are displayed in your chosen currency (PLN, EUR, USD, etc.)
3. Calculates portfolio value — your total Bybit portfolio value is calculated by summing the current market value of all your holdings
4. Tracks changes over time — Freenance records daily portfolio snapshots, allowing you to see historical performance charts
5. Includes in net worth — your Bybit crypto is automatically added to your total net worth, alongside bank accounts, investments, and other assets

Troubleshooting Common Issues

Problem: API connection fails with "Invalid API key"

Solution: Double-check that you copied the API Key and API Secret correctly — they are case-sensitive and include no spaces. If you cannot retrieve the secret, generate a new API key pair and try again.

Problem: Balances show as zero

Solution: Make sure your assets are in the Spot or Funding wallet. Assets locked in active trading positions (margins, open orders) may not appear in the standard balance query. Transfer idle assets to the spot wallet for accurate tracking.

Problem: Historical transactions are incomplete

Solution: Bybit may limit the export date range for certain transaction types. Export in smaller date range batches (e.g., 3 months at a time) and import each file. Freenance will merge the data and remove duplicates.

Problem: Some coins show unknown prices

Solution: Very new or low-cap tokens may not have price data available from Freenance's data sources. These tokens will appear in your portfolio with a zero or estimated value. As price data becomes available, the valuation will update automatically.

Problem: Derivatives PnL is not accurate

Solution: Freenance tracks realized PnL from closed derivative positions, but does not track unrealized PnL from open positions. For accurate derivative tracking, close positions and allow the PnL to settle before importing.

Frequently Asked Questions

Is it safe to connect my Bybit account via API?

Yes, as long as you use a read-only API key. Read-only keys can only view your balances and history — they cannot execute trades, withdraw funds, or make any changes to your account. Even if the key were exposed, your funds would remain safe.

How often does Freenance sync with Bybit?

When connected via API, Freenance syncs your Bybit balances periodically (typically every few hours). You can also trigger a manual sync from the Freenance dashboard at any time.

Can I disconnect Bybit from Freenance?

Yes. You can remove the Bybit integration from your Freenance account at any time. You can also revoke the API key directly from Bybit's API Management page, which will immediately stop all access.

Does Freenance support Bybit's copy trading feature?

Copy trading transactions are included in your spot and derivatives transaction history. They will be imported alongside your regular trades and treated the same way.

What happens if I have assets on multiple Bybit sub-accounts?

Currently, Freenance connects to your main Bybit account. If you use sub-accounts, you may need to create separate API keys for each sub-account and connect them individually.

The Complete Financial Picture

Your Bybit crypto is just one piece of the puzzle. With Freenance, you see it alongside your bank accounts, ETFs, bonds, retirement accounts, and liabilities — all in one dashboard. Stop guessing how much you are worth and start knowing.

👉 Add your Bybit crypto to Freenance — freenance.io