SWAGGER STYLE
MT4 Manager Explorer
Inspect broker-grade MT4 management endpoints for users, balances, and symbol configuration.
Base URLhttps://api.metatraderapi.xyz/mt4/manager
AuthBearer manager credential
How To Test This API
Manager writes mutate broker state, so test read-only endpoints first and isolate finance actions behind dedicated credentials.
When trying balance operations, always include an idempotency key and an operator identifier.
- Validate your manager credential against a read endpoint such as /users/{login}.
- Inspect available groups or symbols before mutating account state.
- Exercise a small deposit or credit operation in a non-production environment.
- Store the resulting operation id and compare it with your internal audit trail.
| Header | Value | Notes |
|---|---|---|
| Authorization | Bearer <manager-key> | Scoped manager credential. |
| x-operator-id | ops-console | Recommended for audit trails. |
| x-request-id | req_mng4_demo | Recommended for retries and reconciliation. |
Sample Request
BASH
curl -X POST https://api.metatraderapi.xyz/mt4/manager/balances/deposit \
-H "Authorization: Bearer <manager-key>" \
-d '{
"login": 910024,
"amount": 5000,
"comment": "vault settlement"
}'Sample Response
JSON
{
"operationId": "bal_1902",
"status": "accepted",
"newBalance": 12500
}Common Status Codes
| Code | Meaning | Typical Cause |
|---|---|---|
| 200 | OK | Read or write operation completed successfully. |
| 201 | Created | A new account or record was created. |
| 403 | Forbidden | The current credential lacks required manager scope. |
| 409 | Conflict | A duplicate balance or lifecycle mutation was detected. |
| 503 | Manager Offline | The MT4 management plane is unavailable. |