Docs·Connections·CME · TopstepX

TopstepX troubleshooting

Every TopstepX connection and trading symptom with its cause and fix — refused credentials, empty account panel, locked order controls, missing symbols.

This page covers TopstepX. For Rithmic login and data problems, see Rithmic troubleshooting.

Symptoms are grouped by where they appear. If none of them match, disconnect, reconnect, and read the message on the row. The connector shows the venue's own reason for the failure.

Diagnostic list with an error row, a warning row and passing rows — TopstepX connection troubleshooting

The connection is refused

MessageCauseFix
Email not foundNo TopstepX profile for that address.Use the exact email you sign in to TopstepX with.
Invalid credentialsA username was entered instead of the email, or the key does not match the account.Email + key, both from the same profile.
Wrong credentialsThe key is wrong, revoked or from another profile.Generate a new key in Settings → API.
API subscription not activeAPI access is not enabled on the Topstep side.Enable it on your Topstep billing page. Detail.
API key disabledThe key exists but is toggled off.Enable it in TopstepX → Settings → API.
Auth failed (code N)The venue returned an unlabelled error.Retry once; if it persists, regenerate the key.

A trailing space or a line break in a pasted key is a common cause of "wrong credentials". Paste from your password manager, not from a document.

Connected, but nothing shows

SymptomCauseFix
Account panel is emptyThe account snapshot has not arrived yet.Press Refresh account on the row.
No account foundThe profile has no account the API can see.Check in TopstepX that the account is active.
Balance is there, positions are notYou have none open, or they are on a different account.Check the account picker.
Row sits at SyncingReconnecting to the venue. The stored key is still believed good.Wait. If it does not clear, disconnect and reconnect.
Row flipped to Disconnected mid-sessionThe session token expired or the network dropped.Reconnect. If it recurs, check whether the key was revoked at the venue.

CME symbols are missing

  • Symbols only appear after the connector is linked. Check the row says Connected.
  • In the symbol search, use the venue filter row at the bottom and pick the CME venue.
  • Search by the root — ES, NQ, CL, GC — rather than a full contract string.
  • If a symbol resolves to the wrong venue, pick it explicitly from the search results rather than typing a bare ticker.

The order controls are locked

The lock always carries its reason. Match it here:

ReasonMeaningWhat to do
Live funded accounts cannot trade via APITopstep does not offer API order entry on Live Funded.Select a Practice / Combine / Express Funded account, or trade Live in Topstep's own platform. Why.
This account cannot trade via APIThe venue reports the account as not currently tradable.Check its state at Topstep — suspended, breached or outside session hours.
No tradable account foundNothing on the profile is eligible.See above.
Select an accountConnected, no account picked.Pick one in the API Connect panel or the ladder's trade settings.
Connect the venue to tradeThe connector is not linked in this browser.Connect TopstepX.
Sign in to tradeYou are browsing as a guest.Sign in.

Order problems

SymptomCauseFix
The entry was "rejected" but a position existsAccount is in Position Brackets mode: an attached stop/target is refused while the entry still goes through.Check the Positions tab — it reflects the venue. Turn attached brackets off and send protection as separate orders. Detail.
A burst of orders went out slower than expectedEntries and modifies are paced below the venue's rate ceiling.Expected behaviour. Exits are never paced.
Cancel-all took a moment to finishOrders are cancelled one at a time, not in parallel.Expected.
An order filled on the wrong accountThe account picker was on a different account.Always check the account name on the toolbar before the session. One key reaches every eligible account.

Data looks wrong

SymptomCause
The DOM shows only the inside marketExpected. TopstepX provides best bid / best ask, not full L2. Full depth on CME needs the Rithmic connector.
Footprint cells look right but depth looks thinSame reason: the tape is real and complete, the resting book is top-of-book.
Chart froze after a long time in the backgroundCome back to the tab; the data catches up on its own. If the gap stays, reload.
Data stopped entirely and the row is DisconnectedThe Topstep subscription or the API add-on lapsed. CME data depends on your Topstep subscription.

Still stuck

  1. Disconnect and reconnect. This fixes most session problems.
  2. Reload the terminal, then retry.
  3. Confirm at topstepx.com that the subscription, the API entitlement and the key are all active, and that the account is in good standing.
  4. Still failing: contact support with the exact message on the row, the account mode (Practice / Combine / Express / Live Funded), and the time it happened. Never send your API key. Support will never ask for it.