> ## Documentation Index
> Fetch the complete documentation index at: https://docs.performax.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an exchange

> Connect a read-only exchange account and run your first sync.

Connect one exchange account so Performax can import your trades and build the first dashboard.

<img src="https://mintcdn.com/performax/hkpg9NSlzXmyRSJf/images/settings-api-demo.png?fit=max&auto=format&n=hkpg9NSlzXmyRSJf&q=85&s=d92ab15297c8f9f07cd990b2b0cd36cb" alt="Performax demo API connections page showing connected exchange cards, masked credentials, and sync status" width="1440" height="1050" data-path="images/settings-api-demo.png" />

*Demo account. Use read-only credentials only.*

## Prerequisites

* A Performax account.
* Access to the exchange account or wallet you trade with.
* A read-only API key or token.
* No trading permission.
* No withdrawal permission.
* Passphrase for OKX or WEEX.

## Safe connection flow

1. Create a read-only API key on the exchange.
2. Disable trading and withdrawal permissions.
3. Copy the required credential fields once.
4. Open **Performax → Settings → API & Exchanges**.
5. Click **Add Account**.
6. Select the exchange.
7. Paste the required fields.
8. Add a clear label, such as `OKX main` or `Lighter wallet 1`.
9. Save.

Expected result: Performax validates the credentials, stores them encrypted, creates the account card, and starts the first sync.

## Credential fields

| Exchange    | API key field                         | Secret field       | Passphrase field |
| ----------- | ------------------------------------- | ------------------ | ---------------- |
| Binance     | Binance API key                       | Binance secret key | Not required     |
| OKX         | OKX API key                           | OKX secret key     | Required         |
| WEEX        | WEEX API key                          | WEEX secret key    | Required         |
| Hyperliquid | Wallet or API key, depending on setup | Secret if required | Not required     |
| Lighter     | Wallet address                        | API token          | Not required     |

If an exchange shows a secret only once, create a new key if you lose it.

When you add a Binance account you also choose which products to track: Spot, USD-M futures, and COIN-M futures. Spot and USD-M futures are selected by default; COIN-M is opt-in. See [API Connections](/settings/api-connections) for the full Binance setup.

## First sync

The first sync is the slowest. It can import:

* closed trades;
* balances;
* open positions;
* funding and fee data where available;
* deposits and withdrawals where available.

The Journal can populate before every dashboard or analytics widget is complete. Derived metrics need closed trades, cashflows, balance history, and risk settings.

## Multiple accounts

Wallet-based exchanges can support multiple wallets. Centralized exchanges are limited to one connected account per exchange.

Use the account selector on Dashboard, Analytics, and Journal views to narrow the scope when several accounts are connected.

## If sync fails

Check the account card in **Settings → API & Exchanges**.

Common causes:

* key was not read-only;
* trading or withdrawal permission is enabled;
* passphrase is wrong;
* IP restriction blocks Performax;
* exchange API is temporarily unavailable;
* account has no closed trades in the selected period.

See [API Connections](/settings/api-connections) for per-exchange setup and [Troubleshooting](/support/troubleshooting) for failure diagnosis.
