Your VEXA Sync API key
The key that links your MetaTrader terminal to VEXA is shown once for 60 seconds. How to generate, rotate and revoke it, and what breaks when you do.
What this does
The VEXA Sync API key is the credential the Expert Advisor uses to prove your MetaTrader terminal is
yours. It begins vxa_, you paste it into the EA’s VexaApiKey input once, and the EA sends it
with every batch of trades after that.
You get one key per MetaTrader connection. Anyone holding it can post trades into your account, so treat it like a password.
Before you start
- The key lives on the MetaTrader broker page in the VEXA web app. There is no mobile equivalent.
- The raw key is shown once, for 60 seconds, at the moment you generate it. VEXA stores a hash, not the value, so nobody can read it back to you later. Copy it before the timer runs out.
- The card masks the key by default. Use the eye toggle to reveal it and the copy button to take it. Your clipboard is cleared after 60 seconds where the browser allows that.
Steps
Web only
Generate your first key
- Open Profile from the sidebar card that shows your name with View Profile under it.
- Open Connected Brokers and choose MetaTrader 4 or MetaTrader 5.
- On the VEXA Sync API Key card, press Generate API Key.
- Reveal the key and copy it inside the 60-second window.
- Paste it into the EA’s VexaApiKey input in MetaTrader.
Rotate a key
- On the same card, press Rotate API Key.
- Read the warning and press again to confirm. Rotating invalidates the current key immediately.
- Copy the new key inside its 60-second window.
- Open the EA’s settings in MetaTrader and replace the old key in VexaApiKey.
Revoke a key
- Press Revoke key.
- Press the confirm button that appears. It stops offering to confirm after about five seconds, so press it deliberately rather than leaving the page half-done.
What you should see
The EA Connection card sits below the key card and refreshes every 15 seconds. It reports one of four states, along with the IP address your last sync came from.
| Dot | State | What it means |
|---|---|---|
| Green, pulsing | Connected | The EA reported in recently. The card names how long ago. |
| Yellow | Idle | The EA has not reported for a while. MetaTrader is probably closed, or the EA is not attached to a chart. |
| Red | API key revoked | The key was revoked. Generate a new one and paste it into MetaTrader. |
| Grey | Not connected yet | No sync has ever arrived on this key. |
After a rotate, expect the card to go quiet until you paste the new key into MetaTrader. That gap is normal and is not data loss. The EA keeps unsent trades in a local outbox and delivers them once it can authenticate again.
Lost your key
There is no way to recover it. The raw value only existed on screen at generation time.
If you saved it somewhere, paste it into MetaTrader. If you did not, press Rotate API Key to issue a new one, then update the EA. Your existing trades and history are untouched by a rotation.
Rate limits
Each key may send one request per second, and one IP address may send ten per second across all keys. A batch carries up to 500 deals, so a normal terminal never approaches either ceiling.
Every batch also carries a timestamp, and VEXA rejects anything more than five minutes out of step with real time. That check exists to stop a captured batch being replayed later, and the practical consequence is that a badly set clock on your PC blocks syncing. See MetaTrader EA troubleshooting if that is your symptom.
If it doesn’t work
- The card says you already have a key on file. That is the state when a key was generated but never copied. Rotate to get a fresh one.
- You rotated and syncing stopped. The EA is still holding the old key. Open its settings in MetaTrader and paste the new one.
- Green dot, no trades. The connection is fine and the problem is elsewhere in the EA setup. Start with MetaTrader EA troubleshooting.
Related
Related
Still stuck? Email support@vexatrade.ai.