How PropMetaAPI works
The basics in plain words: what we run for each account, active and standby accounts, and how your software gets live data.
One terminal per connected account
PropMetaAPI is a REST and WebSocket API for MetaTrader 4 and MetaTrader 5 accounts. For each account you connect, we run a MetaTrader terminal on our servers that logs in to your broker with the credentials you give us. Your software talks to our API; we talk to the broker.
We are a technology service, not a broker: orders are executed by your broker, at the broker's prices and under the broker's rules.
Registered, active and standby accounts
Every account you add is registered. A registered account is in one of these states:
- STANDBY — stored, no connection. It does not use an active slot of your plan. Reads still work: they log in briefly when needed.
- ACTIVE — a permanent connection with live data, events, risk rules and fast trading. Your plan limits how many accounts can be ACTIVE at the same time.
- A check is a one-off login (up to about a minute) that verifies the password and reads balance and history, then logs out.
You can keep more accounts registered than your plan's active limit (by default three times as many) and switch which ones are active.
Getting data: push, not polling
There are three ways to receive what happens on your accounts:
- Webhooks — signed calls to your server for trades, state changes and risk events, retried for up to 72 hours.
- Event feed (
GET /v1/events) — the same events, read with a cursor and kept for 14 days. A good safety net after downtime. - WebSocket (
/v1/ws) — live quotes, profits, order updates and events over one connection, ideal for dashboards.
Polling every account every few seconds wastes your rate limit and is slower than these.
Your plan
A plan is a time-limited subscription (for example one month) with a maximum number of active accounts. It does not renew by itself; buying again adds a new period and keeps the same API token. See Renew or change your plan.
For developers
The API side of this topic, with every field and code examples: