Your first API request

1. Connect a Demo account

Sign in after approval, add the exact broker server and wait for the session to be ready.

2. Create a read key

Select your account and the read permission. Copy the key once and keep it out of source control.

3. List your accounts

curl https://app.metatraderapi.cloud/api/v1/accounts/ \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY"

4. Read account data

curl https://app.metatraderapi.cloud/api/v1/accounts/ACCOUNT_UUID/ \
  -H "Authorization: Bearer YOUR_PRIVATE_KEY"

Other read endpoints: positions/, quote/?symbol=EURUSD, history/?from=UTC&to=UTC. Use whole UTC seconds such as 2026-11-01T00:00:00Z. History windows cover at most 31 days and 1000 deals; split larger windows.

Trading is explicit and Demo-only

A trade key and enabled account are required. Every trade must send a UUID in Idempotency-Key. After a timeout, reuse the same ID and same request body. Never retry uncertain execution with a new ID. Reads and trades stop when your pilot expires. All your keys share 60 requests per minute.