> ## 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.

# Exchange

> Add, sync and manage your exchange connections.

Connect exchange accounts from **Settings → Exchange**.

Performax only reads. It reads trades, balances, positions, open orders, funding and related account history. It never places, edits, or cancels orders.

**Read-only keys only.** Never enable withdrawal permissions. Do not enable trading permissions wherever the exchange lets you leave them off. Binance is the one exception to know about: its futures data can only be read with **Enable Futures** turned on, so enable it only if you track Futures or COIN-M, and keep withdrawals disabled.

<img src="https://mintcdn.com/performax/SFtkloQ0cL6s19dU/images/settings-api-demo.png?fit=max&auto=format&n=SFtkloQ0cL6s19dU&q=85&s=dbce6f85e5653c8ab79792037ddf57ed" alt="Performax demo Exchange settings showing read-only exchange connection cards and the Automatic sync row" width="1440" height="1050" data-path="images/settings-api-demo.png" />

*Demo account. Real credentials are encrypted and never shown again after save.*

## Supported exchanges

| Exchange | Account type | Credentials | Notes |
| - | - | - | - |
| Binance | Spot, Futures (USD-M), COIN-M | API key, API secret | No passphrase. Choose the products to track when adding the account. |
| OKX | Spot and derivatives | API key, API secret, passphrase | Global or EEA site detected automatically. |
| WEEX | Spot and futures | API key, API secret, passphrase | First sync covers about the last 365 days. |
| Hyperliquid | On-chain perpetuals | Wallet address | No API key. Wallet ownership is verified by signature. |
| Lighter | Decentralized orderbook | Wallet address, API token | The token is needed to import trade history. |

## Before you connect

Prepare:

* A key created directly on the exchange, limited to reading wherever possible.
* Withdrawal permission disabled.
* API secret and passphrase copied once when the exchange shows them.
* IP restrictions disabled unless you know how to allow Performax (see [Troubleshooting](#troubleshooting)).
* For Hyperliquid and Lighter: a browser with the wallet extension that holds the address.

Performax encrypts credentials before storing them and never displays the secret, passphrase or token again after save. The account card only shows a short masked hint.

## Binance

Binance covers three products: Spot, Futures (USD-M) and COIN-M. When you add the account you choose which of these Performax tracks under **Products to track**. Spot and Futures are checked by default; COIN-M is opt-in.

1. Open [Binance API Management](https://www.binance.com/en/my/settings/api-management).
2. Create an API key, for example labelled `Performax`.
3. Keep **Enable Reading** checked for Spot.
4. If you track Futures (USD-M) or COIN-M, also turn on **Enable Futures**. Binance has no read-only futures scope. Do not enable withdrawals.
5. Copy the API key and secret key. Binance shows the secret only once.
6. In Performax, open **Settings → Exchange → Add connection**.
7. Select **Binance**.
8. Paste the API key and API secret.
9. Check the products you trade: Spot, Futures (USD-M), COIN-M.
10. Optionally add a label.
11. Click **Add**.

Binance has no API passphrase. Performax tests each checked product separately; if one fails, the error starts with `Spot:`, `Futures:` or `COIN-M:` so you know which permission to fix or which product to uncheck. If a coin was delisted from Binance spot but still trades as a perpetual (for example XMR), its Journal chart is sourced from the futures market.

## OKX

1. Open [OKX API Management](https://www.okx.com/account/my-api).
2. Create a V5 API key yourself. Do not look for Performax in the third-party application list.
3. Give the key read access only. Disable trading and withdrawal.
4. Set a passphrase. It is mandatory, cannot be recovered, and is not your OKX login password.
5. Copy the API key, secret key, and passphrase.
6. In Performax, open **Settings → Exchange → Add connection**.
7. Select **OKX**.
8. Paste the API key, API secret, and passphrase.
9. Optionally add a label.
10. Click **Add**.

You do not need to choose a region: Performax detects whether the account uses the global or EEA site.

Expected result: Performax validates the key, creates the account card, and starts the first sync.

## WEEX

1. Open [WEEX API Management](https://www.weex.com/en-us/account/api).
2. Create an API key.
3. Set permissions to read-only. Disable order placement and withdrawals.
4. Set a passphrase and keep it somewhere safe.
5. Copy the API key, secret key, and passphrase.
6. In Performax, open **Settings → Exchange → Add connection**.
7. Select **WEEX**.
8. Paste the API key, API secret, and passphrase.
9. Optionally add a label.
10. Click **Add**.

The first sync reads about the last 365 days of WEEX spot and futures history; later syncs read recent activity. Spot trades are found from the coins you currently hold and the most common USDT pairs, so a spot pair you no longer hold may not appear.

## Hyperliquid

Hyperliquid needs no API key. Performax reads your trades from the blockchain using your wallet address.

1. Open [Hyperliquid](https://app.hyperliquid.xyz) and connect the wallet you trade with.
2. Copy your wallet address (`0x...`).
3. In Performax, open **Settings → Exchange → Add connection**.
4. Select **Hyperliquid**.
5. Paste the address in **Wallet address**.
6. Optionally add a label.
7. Click **Add**, then sign the verification message in your wallet extension. No transaction is sent.
8. In **Configure HIP-3 markets**, turn on **Enable HIP-3 sync for this wallet** if you trade HIP-3 markets, then click **Activate wallet**.

The first sync starts once the wallet is activated. HIP-3 can be enabled on one wallet only; change it later with the gear icon (**Configure HIP-3**) on the account card.

## Lighter

Lighter uses your wallet address to identify the account and an API token to read your private trade history.

1. Open [Lighter](https://app.lighter.xyz) and connect the wallet you trade with.
2. Copy your Ethereum wallet address.
3. Generate an API token in Lighter.
4. In Performax, open **Settings → Exchange → Add connection**.
5. Select **Lighter**.
6. Paste the address in **Wallet address**.
7. Paste the token in **API token (optional)**.
8. Optionally add a label.
9. Click **Add**, then sign the verification message in your wallet extension. No transaction is sent.

The token field is marked optional, but without it Performax cannot import your Lighter trades or funding. Add it if you want your history in the Journal.

## Account limits

Binance, OKX and WEEX accept one connected API key each. Hyperliquid and Lighter accept up to 3 wallets each. Under **Connected exchanges**, each exchange shows its slot counter (for example `0/1`); in the picker, a full exchange is greyed out. The same key or wallet cannot be added twice.

Your plan can also cap the number of connected exchanges. When that cap is reached, **Exchange limit reached** appears with an **Upgrade plan** button.

## Account cards

Each card shows the exchange, your label, a status (**Pending**, **Connected**, **Sync error** or **Error**), the masked key or wallet, and **Last sync**.

* The eye icon (**Hide from app** / **Show in app**) hides an account from your views. A hidden account keeps syncing.
* The trash icon disconnects the account. Your past trades stay in your journal. If the account still has open positions, you can also mark them as closed in the journal.
* A wallet added before ownership checks existed shows **Verify wallet**. Verify it to keep automatic sync active.

Keys and labels cannot be edited after creation: disconnect the account and add it again with the new key.

## Auto-sync

After a successful connection, the first sync imports your history, positions, balances and funding. Automatic sync then keeps your connected accounts fresh in the background.

* The **Automatic sync** row in the Exchange tab shows whether background sync is **Active** or **Disabled**, and the last sync time. Its switch turns automatic sync on or off. The interval adapts to your recent activity: syncs run more often when you traded recently.
* The sync button in the sidebar shows **Auto sync** and **Last sync at**. It runs **Sync All** only when automatic sync is off.

Manual sync does not bypass exchange rate limits.

## Delete trade data

Below **Automatic sync**, the **Delete all data** row has a **Delete all** button that deletes all your trades and resets balances to zero. **Or by exchange** offers the same deletion for one exchange at a time. A **Confirm deletion** dialog shows what will be deleted and how many trades, before you click **Delete**.

Connected, active accounts then re-sync their history from the exchange. Data from disconnected accounts is gone for good.

## Troubleshooting

### Invalid key

Create a fresh read-only key. Most exchanges show the secret only once.

### Passphrase error

Re-enter the exact API passphrase created with the key. It is case-sensitive and is not your exchange login password.

### IP restriction error

Remove the IP restriction or contact `support@performax.ai` for the current allowlisting guidance.

### Wallet verification fails

Open Performax in a browser where your wallet extension is installed and make sure the connected wallet is the address you entered.

### No trades imported

Check:

* The selected account has closed trades.
* The first sync has finished.
* The date range includes the trades.
* For Lighter, the API token was added.
* The exchange API exposes that history.

See [Troubleshooting](/support/troubleshooting) for the full diagnostic flow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.