# 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.

Canonical page: https://propmetaapi.com/help/how-it-works  
Topic: Getting started  
Last updated: 2026-10-28

## 1. 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.

## 2. 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.

## 3. 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.

## 4. 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](https://propmetaapi.com/help/renew-or-change-plan).

## For developers

- [Integration guide](https://propmetaapi.com/docs/guide)

## Related guides

- [Get started with PropMetaAPI](https://propmetaapi.com/help/getting-started): Create your company account, start the free trial, copy your API token and connect your first MetaTrader account — in about ten minutes.
- [Connect a MetaTrader account](https://propmetaapi.com/help/connect-metatrader-account): What you need from the trader, how to register, check and activate an MT4 or MT5 account, and how to follow it in your panel.
- [Webhooks and events](https://propmetaapi.com/help/webhooks-and-events): Receive trades and account changes on your server, check delivery health and fix a webhook that was switched off.
