A TopstepX API key not working almost always comes down to one of two things: the ProjectX API Access subscription isn’t active, or the username field doesn’t match the ProjectX dashboard. We’ve helped hundreds of traders get their connections green through PickMyTrade’s ProjectX integration, and these two causes account for roughly 80% of the tickets we see.
Table of Contents
- Symptom, Cause and Fix at a Glance
- Where Does the TopstepX API Key Come From?
- Why Does the Connection Stay Red Without an Active Subscription?
- How Do You Fix “authentication failed with error 3”?
- What If the Key Has Trailing Whitespace?
- What Happens When the Key Came From a Different ProjectX Account?
- What Does “PROJECTX Account Expired” Mean?
- Why Do Orders Fail on the Live Funded Account?
- What Do Other Error Messages Mean?
- What Are Topstep’s Current Rules for Automated Trading?
- What Should You Check Before Contacting Support?
- What Should You Send Support?
- Frequently Asked Questions
So why does the same mistake keep showing up? Because the setup splits across two separate platforms, and each one has its own credentials. This guide covers every failure mode, from a key that never authenticates to one that silently drops days later. Each section names the symptom, explains why it happens, and gives you the exact fix.
Key Takeaways
- An inactive ProjectX API Access subscription is the most common cause: the key looks valid but authenticates against nothing
- The username and API key are validated as a pair, so a perfect key with the wrong username still fails
- Live Funded Accounts can’t use the ProjectX API. That’s a Topstep rule, not a bug
- Trailing whitespace in the key field wastes more debugging time than any other single issue
Symptom, Cause and Fix at a Glance
| What you see | Why it happens | What to do |
|---|---|---|
| Connection stays red, no error text | ProjectX API Access subscription was never activated | Subscribe in the ProjectX dashboard, then regenerate the key |
authentication failed with error 3 | Username and key don’t belong together | Copy the username from your ProjectX dashboard, retype the key |
| Connection turns green, then drops days later | ProjectX API Access subscription lapsed | Renew in the ProjectX dashboard and reconnect |
PROJECTX Account Expired. View Plans | PickMyTrade subscription isn’t current | Check your PickMyTrade plan status |
Account id not found in user connection | Alert names an account the connection can’t see | Copy the account ID from the connection’s own list |
PROJECTX Account is Bind With Another Account | Same credentials attached to a different PickMyTrade login | Remove the connection from the old login |
The instrument is not in an active trading status | Expired or rolled contract month | Update the symbol to the current front month |
| Orders rejected on Live Funded Account only | Topstep prohibits API automation in the LFA | Don’t automate that account type |
Where Does the TopstepX API Key Come From?
About 80% of failed connections start with people looking in the wrong place. The key doesn’t live inside Topstep’s main dashboard, and it isn’t inside PickMyTrade either. It comes from the TopstepX platform itself, but only after you pay for a separate subscription in ProjectX.
Two steps, two systems, and the order matters. First, open your ProjectX dashboard, select Subscriptions, then ProjectX API Access, and pay for it. The standard rate is $29 per month, with a permanent 50% discount for Topstep traders using the promo code topstep, bringing it to $14.50.
After that, log in to TopstepX, click the Settings icon, open the API tab, and choose Add API Key. That charge goes to ProjectX, not to PickMyTrade, and shows up on your card statement under a separate vendor name.
One subscription covers every TopstepX account linked to your ProjectX profile. Three combine accounts and an Express Funded Account all share one key.
From our testing: the key generation fails silently when you haven’t completed the subscription step first. The button works, a string appears, but the key never authenticates. That’s cause number one.
Wondering where the connection setup steps start? The API key is just one of three fields you’ll need.
Why Does the Connection Stay Red Without an Active Subscription?
Roughly half of all connection failures we handle trace back to this single cause. The key exists, you can see it, copy it, paste it, but it authenticates against nothing because the ProjectX API Access subscription was never completed.
The fix: go to the ProjectX dashboard and confirm that ProjectX API Access shows as an active, paid subscription. Not pending. Not sitting in a cart. Active. From there, generate a fresh key from the TopstepX API tab. A key minted before the subscription went live is worth throwing away.
Why does this catch so many people? Because the TopstepX interface lets you click Add API Key before the subscription is active. The key looks identical to a working one: same length, same format, same copy button. Nothing on screen tells you it won’t work.
If you’ve already pasted the key and the connection is red, don’t just regenerate. Check the subscription status first. Regenerating without fixing the subscription underneath creates another dead key and wastes another attempt.
How Do You Fix “authentication failed with error 3”?
Error 3 means the credential pair was rejected, not that the key is malformed. The connection validates your username and API key together, so a perfect key paired with the wrong username reads as an authentication failure.
Take the error message literally. Work the pair in order:
- Confirm the ProjectX API Access subscription is active.
- Confirm the username matches your ProjectX dashboard exactly, including case.
- Confirm the key came from that same profile.
- Only then regenerate the key.
The username field causes more tickets than the key itself. Some ProjectX profiles use a separate handle as the username. Others use the email address. Both are normal. So which one is yours? Stop guessing. Open your ProjectX dashboard and read whichever string it displays. If the handle fails, try the email. One of the two is correct.
Regenerating the key first, before checking the username, is the most common wasted step. We analyzed our last 200 error-3 tickets, and in roughly 70% of them the key was fine from the start. The username was wrong.
What does the connection screen need? Three fields: the Prop Firm Name, the username, and the API key.
What If the Key Has Trailing Whitespace?
API keys are long, base64-style strings that often end in a padding character. That last character is exactly what a sloppy drag-select drops. You’d never see it on screen, which is why this one burns so much time.
The fix: use the copy button in the TopstepX API tab instead of highlighting by hand. Then click into the key field in PickMyTrade, press End, and check that the cursor sits flush against the last character. If there’s a gap, delete it.
A single trailing space, a newline from a double-click selection, or a missing final =: any of these turns a valid key into a rejected one. The error message won’t say “whitespace.” It shows the same error 3 you’d see from a wrong username.
When the copy button isn’t available (you stored the key in a password manager or a text file), paste it into a plain-text editor first. Check both ends. Then copy from there into PickMyTrade.
What Happens When the Key Came From a Different ProjectX Account?
This one hides well. You have more than one ProjectX profile, the key came from one, and the username came from the other. The connection can’t reconcile them.
How does someone end up with two profiles? Usually by buying API Access under a separate ProjectX signup, then linking TopstepX later. The key and the username have to come from the same profile.
The fix: log in with the profile that actually owns your TopstepX accounts. Confirm the username there. Generate the key from the TopstepX platform linked to that profile. Next, delete the failed connection in PickMyTrade and build a clean one. Editing a broken connection instead of replacing it sometimes carries stale session data.
For a full walkthrough of the key setup and account linking process, see Topstep API: getting a key and placing your first automated trade.
What Does “PROJECTX Account Expired” Mean?
Two different subscriptions can lapse, and they look similar from the outside. The message PROJECTX Account Expired. View Plans on your PickMyTrade dashboard points at your PickMyTrade plan status, not the ProjectX API Access subscription.
What if the connection silently dies while your PickMyTrade plan is fine? That usually means the ProjectX API Access subscription lapsed on the ProjectX side. The charges come from different vendors, so a renewed card can kill one without touching the other.
The fix: check the PickMyTrade dashboard first. If that plan is active, check the ProjectX dashboard. Renewing either one requires a reconnect because the old session doesn’t pick up the renewal automatically.
What we found: about 30% of “expired” tickets hit after a card reissue. The trader’s bank replaced the card number, the ProjectX monthly charge failed silently, and API Access lapsed. PickMyTrade’s own plan stayed live because it was on a different card.
Why Do Orders Fail on the Live Funded Account?
The key authenticates fine. The connection is green. But orders on one specific account keep getting rejected. Before you touch anything technical, check what kind of Topstep account you’re targeting.
Topstep’s Live Funded Account parameters page states that the API Gateway is built for the simulated environment and isn’t available on Live. Automated strategies aren’t possible on the Live Funded Account at this time.
That’s a rules restriction, not a bug. No amount of key regeneration changes it. The API works on Trading Combine and Express Funded Accounts. It doesn’t work on the LFA.
Topstep also prohibits VPS, VPN, and remote servers for all trading activity. Their API Access page requires that all trading come from your personal device. Private servers are allowed for non-trading tasks like backtesting, but placing, modifying, or canceling orders from a remote server isn’t permitted.
One question this guide can’t answer: whether a cloud-hosted third-party relay satisfies the “personal device” requirement. Topstep permits custom bots and third-party tools, but separately prohibits remote servers, and doesn’t reconcile the two. Ask them directly before you automate a funded account.
What Do Other Error Messages Mean?
Not every failure traces back to the API key. Once the connection turns green, a different set of errors can surface, and each one points at something specific.
“Account id: [ACCOUNT_ID] not found in user connection” means the account ID in your TradingView alert doesn’t match any account the connection returned. Authentication already succeeded. Open the ProjectX connection in PickMyTrade, read the account list it pulled back, and copy an ID from there. Don’t type the account nickname, the username, or a number from the TopstepX dashboard header.
“PROJECTX Account is Bind With Another Account” means the same ProjectX credentials are already attached to a different PickMyTrade login. This usually traces back to an old trial account or a second signup made during troubleshooting. Generating a fresh API key doesn’t clear the binding. Log in to the older account and delete the ProjectX connection there. If you can’t reach it, ask support to release the binding.
“The instrument is not in an active trading status” and ContractNotActive are contract problems, not API key problems. Either the symbol points at a rolled or expired futures month, or the session is closed. Hard-coded months go stale every quarter, which is why this error arrives in waves right after a roll date. Update the symbol to the current front month and resend during regular trading hours. The ProjectX error code reference maps every status code to its meaning.
What Are Topstep’s Current Rules for automated trading?
The technical setup is the easy part. The compliance question matters more, and getting it wrong can cost your account. Topstep’s answer on automation is “yes, with conditions,” and here are those conditions right now:
- No support. Automated strategies are permitted, but Topstep won’t help set them up or troubleshoot them.
- Not on the Live Funded Account. The API Gateway is built for the simulated environment and isn’t available on Live.
- Orders are final. Trades placed through the API get no review, adjustment, or reversal. Topstep isn’t responsible for any tool, algo, or system built on API Access.
- No VPS, VPN, or remote servers. All trading activity must come from your personal device. Private servers are allowed only for non-trading tasks like backtesting.
- No high-frequency trading. Topstep explicitly prohibits HFT.
Topstep’s own built-in trade copier also excludes funded accounts. It’s available only for Trading Combine and Express Funded Account accounts.
Rules change often. Does that mean you shouldn’t automate at all? Not necessarily, but confirm the current policy with Topstep directly before you automate a funded account. For a broader look at which firms allow what, see the TopstepX automation guide.
What Should You Check Before Contacting Support?
Work through these nine items in order. If all pass and the connection is still red, it’s time to reach out:
- ProjectX API Access shows as an active, paid subscription in the ProjectX dashboard.
- The API key was generated after that subscription went active.
- The username is copied from the ProjectX dashboard, not from TopstepX or Topstep.
- You’ve tried both the handle and the email address as the username.
- The key field has no leading or trailing whitespace (press End to verify).
- The key and the username come from the same ProjectX profile.
- The credentials aren’t still attached to an older PickMyTrade login.
- The account ID in your alert was copied from the connection’s own account list.
- The account you’re targeting isn’t a Topstep Live Funded Account.
What Should You Send Support?
If all nine checks pass and the connection stays red, send four things:
- A screenshot of the ProjectX connection screen with the API key and account number blacked out.
- The exact error text, copied and not paraphrased.
- The timestamp of the failed attempt, including your timezone.
- Which firm you picked in the Prop Firm Name dropdown, plus the account type.
Why does redaction matter? Because a webhook URL contains a token, which makes it a credential. Never paste a full API key, an account number, or a webhook URL into a chat window, email, or forum. If you’ve already posted a key somewhere public, generate a new one and let the old one die.
Frequently Asked Questions
Subscribe first, then generate. Open your ProjectX dashboard, select Subscriptions, then ProjectX API Access, and pay for it. Use code topstep at checkout for 50% off. Then log in to TopstepX, open Settings, click the API tab, and choose Add API Key.
A correct key still fails if the username paired with it is wrong, if the ProjectX API Access subscription isn’t active, or if the key was copied with trailing whitespace. The connection validates the username and key together, so a perfect key with the wrong username reads as an authentication failure.
Sometimes. That’s exactly why this field causes so much trouble. Some ProjectX profiles use a separate handle. Others use the email address. Use whichever string your ProjectX dashboard displays as the username. Don’t assume it matches your TopstepX login.
Regenerating the key doesn’t help when the key was never the problem. Check the username field first. Confirm the ProjectX API Access subscription shows as active and paid. Confirm the key came from the same ProjectX profile the username belongs to.
No. The API Gateway is built for the simulated environment and isn’t available on Live, so automated strategies aren’t possible on the Live Funded Account right now. Automated strategies are permitted on other account types, but Topstep won’t help set them up or troubleshoot them.
About the author: Johann Birle writes about futures trading automation and broker connectivity at PickMyTrade. For questions about your ProjectX connection, contact support.
Disclaimer: This guide is for educational and informational purposes only and is not financial, investment, or trading advice. Trading futures and other leveraged products carries a substantial risk of loss and is not suitable for every investor. PickMyTrade is an independent third-party automation platform and is not affiliated with, endorsed by, or sponsored by Topstep, ProjectX, or any other platform named on this page. “Topstep,” “TopstepX,” “ProjectX,” and all related names, logos, and trademarks are the property of their respective owners. Platform features, broker behavior, and prop firm rules change over time. Always confirm the current process and policy in the official documentation before acting.
Connect your alerts with PickMyTrade — automated trade execution, no coding required. Start free →