Get your TopstepX API key
Enable API access on TopstepX, create the key, paste it into the terminal, then rotate or revoke it safely. Every rejection message and what it means.
Connecting TopstepX needs two things: API access enabled on your Topstep subscription, and an API key generated after that. If either is missing, the connection is refused with a message naming which one. This page covers both, plus rotation and revocation.

Step 1 — Enable API access
API access is an add-on on the Topstep side. Sign in at topstepx.com, open your billing / subscription page, and switch it on. Topstep sets the terms and the price; we neither resell it nor see it.
Until it is active, a key you generate will authenticate and then be refused with:
API subscription not active — check topstepx.com/billing
Step 2 — Create the key
- In TopstepX, go to Settings → API.
- Add API Key.
- Name it for the tool that will use it —
Tape Delta— so you can revoke precisely later. - Copy the key string immediately and store it in your password manager.
- Confirm the key is enabled. A key that exists but is toggled off is refused with
API key disabled — enable it in TopstepX Settings → API.
The key is a long-lived secret with full trading access to every eligible account on your profile. Treat it like a password.
Step 3 — Paste it into the terminal
Chart terminal → Widgets → API Connect → group tab CME → TopstepX → Connect.
| Field | Value |
|---|---|
| The email you use to sign in to TopstepX. Not a username, not a display name. | |
| API Key | The string from Step 2. The field is masked; use the eye toggle to verify a paste. |
Press Connect. Authentication happens straight away; the row flips to Connected or shows the refusal reason.
What happens to the key after you submit it
- It is encrypted at rest on our side and never returned to any browser again, including yours.
- The panel shows a masked remnant so you can tell two keys apart. The full value is never shown again.
- Each trading session uses a short-lived token created from it, not the key itself.
- It is never written to logs, never included in a diagnostic bundle, never sent to a third party.
- Press Disconnect and the stored credential is deleted on the spot.
Our broader key-handling policy: API key permissions.
Rejection messages
| Message | Meaning | Fix |
|---|---|---|
| Email not found | No TopstepX profile for that address. | Use the exact email you signed up with. |
| Wrong credentials | The email exists; the key does not match it. | Re-copy the key, or generate a new one. |
| Invalid credentials | Usually a username was entered where the email belongs. | Use the email. |
| API subscription not active | Step 1 was skipped, or the add-on lapsed. | Enable API access on your Topstep billing page. |
| API key disabled | The key is switched off in TopstepX. | Toggle it back on, or generate a new one. |
| Auth failed (code N) | An error the venue did not label. | Retry; if it persists, regenerate the key. |
More symptoms, including ones that appear after a successful connect: Troubleshooting.
Rotating the key
Rotate whenever you suspect exposure, and as routine hygiene every few months:
- Generate a new key in TopstepX → Settings → API.
- In the terminal, Disconnect TopstepX, then Connect with the new key.
- Confirm the row returns to Connected and your account reappears.
- Delete the old key in TopstepX.
This takes under a minute. Do it between sessions, not with a position on: disconnecting stops the live account feed for a moment.
Revoking in a hurry
If a key is exposed, delete it in TopstepX → Settings → API first. That disables it everywhere at once, including here. Then disconnect in the terminal to clear the stored copy.
Deleting the key at the venue does not touch your positions or working orders. They stay exactly as they are and can still be managed from Topstep's own platform.
Good practice
- One key per tool. Shared keys cannot be revoked precisely.
- Never paste the key into a chat, an issue tracker or a screenshot. Support will never ask you for it.
- Sign out of the terminal on shared machines — the API Connect panel is reachable from any signed-in tab.
- Rotate after you hand a device on, or after any password reset on your Topstep account.
Related pages
- Connect TopstepX — the end-to-end path.
- Trade CME from the terminal — what to know before the first order.
- Troubleshooting.