Exchange Sync Errors

Exchange Sync Errors

When TraderNest encounters a problem syncing trades from your exchange, it displays an error message in Settings → Exchanges next to the affected connection. This guide explains the most common sync errors and how to resolve them.

How to Check Sync Status

Go to Settings → Exchanges. Each connected exchange shows its current status:

1. Connected (green) — Everything is working. Trades are syncing normally.
2. Syncing (blue) — A sync is currently in progress.
3. Warning (amber) — Sync completed but with warnings (e.g., rate limited, will retry).
4. Error (red) — Sync has failed. Click the error to see details and resolution steps.

Common Sync Errors

"Rate Limited" / "Too Many Requests"

What it means: Your exchange has temporarily blocked TraderNest's API requests because too many requests were made in a short period. This is normal and happens most often during the initial sync of a large account.

What to do: Nothing. TraderNest will automatically retry after a short waiting period (typically 1-5 minutes). This error resolves itself. If it persists for more than 30 minutes, try disconnecting and reconnecting the exchange.

"Authentication Failed" / "Invalid API Key"

What it means: The API key TraderNest is using to connect to your exchange is no longer valid. Common causes:

1. The API key has expired (some exchanges set expiration dates on API keys)
2. You deleted or regenerated the API key on the exchange side
3. The API key permissions were changed
4. The API key or secret was copied incorrectly during initial setup

What to do:

"IP Not Whitelisted"

What it means: Your exchange requires that API access comes from a specific IP address, and TraderNest's server IP is not on the whitelist.

What to do:

1. In TraderNest, go to Settings → Exchanges and click on the errored connection. The TraderNest server IP address will be displayed.
2. Log in to your exchange, go to API Management, and add the TraderNest IP to your API key's whitelist.
3. Save the changes on the exchange side, then click Retry Sync in TraderNest.

"No New Trades Found"

What it means: TraderNest connected to your exchange successfully but did not find any new trades to import since the last sync.

Possible reasons:

1. You have not made any new trades since the last sync.
2. Your API key only has Spot permissions. TraderNest syncs Futures trades only. Check that your API key has Futures/Derivatives permissions.
3. For Binance: the API has a 7-day historical data window. If your last trade was more than 7 days ago, it may not be found during the initial sync.

"Connection Timeout"

What it means: TraderNest's request to the exchange took too long and timed out. This usually means the exchange's API is temporarily slow or experiencing issues.

What to do: Wait 10-15 minutes and click Retry Sync. If the problem persists, check the exchange's status page (most exchanges have one) to see if they are experiencing known API issues.

"Passphrase Incorrect"

What it means: Exchanges that require a passphrase (BloFin, Bitget, OKX, KuCoin) returned an authentication error because the passphrase does not match.

What to do:

1. The passphrase is set by you when you create the API key on the exchange. It is NOT your exchange account password.
2. If you do not remember the passphrase, you will need to delete the API key on the exchange and create a new one with a new passphrase.
3. Reconnect the exchange in TraderNest with the correct key, secret, and passphrase.

How to Manually Trigger a Sync

If you want to force a sync outside the normal schedule:

1. Go to Settings → Exchanges.
2. Find your exchange connection.
3. Click the Sync Now button (circular arrow icon).
4. Wait for the sync to complete. Progress is shown in real time.