Appearance
Create Open Account Request
About 251 wordsLess than 1 minute
POST /public/v1/requests/account
Request Body
| Name | Type | Required | Rule |
|---|---|---|---|
| user_id | string | ✅ | |
| platform | string | ✅ | one of: mt4, mt5, mtr, wta, ctrader, fortex (auto lowercase) |
| connection_id | string | ✅ | |
| account_type_id | string | ❌ | allow empty string, not allowed for wta,mtr platform |
Condition: platform = mt4 or mt5
| Name | Type | Required | Rule |
|---|---|---|---|
| leverage | number | ✅ | min: 1, max: 5000 |
Condition: platform = mtr
| Name | Type | Required | Rule |
|---|---|---|---|
| offer_uuid | string | ✅ |
Condition: platform = wta
| Name | Type | Required | Rule |
|---|---|---|---|
| group | string | ✅ |
Condition: platform = ctrader
| Name | Type | Required | Rule |
|---|---|---|---|
| leverage | number | ✅ | min: 1, max: 5000 |
| group | string | ✅ | |
| currency | string | ✅ |
Condition: platform = fortex
| Name | Type | Required | Rule |
|---|---|---|---|
| leverage | number | ✅ | min: 0.01, max: 5000 |
| group | string | ✅ | |
| currency | string | ✅ | |
| fortex_username | string | ✅ |
⚠️ Notes
- Validation rules are applied dynamically based on the
platformfield. - Fields not required for a specific platform are not strictly forbidden by current validation logic.
- It is recommended to enforce strict schemas (e.g., disallow unknown fields) for better data integrity.
Expected HTTP status code
- 200
Response
| Name | Type | Description |
|---|
Error
| Code | Type | Description |
|---|---|---|
| 400 | trading_account_limit_exceeded | 账号达到了每个客户的最大申请数量 |
| 400 | pending_requests_exist | 同一个connection有待处理的开户请求 |
| 400 | servce_is_demo | 平台是demo服务器 |
| 400 | mt4_connection_not_found | mt4 connection is not exists |
| 400 | mt5_connection_not_found | mt5 connection is not exists |
| 400 | trade_connection_not_found | wta/ctrader/fortex connection is not exists |
| 400 | invalid_account_type | account type is not exists or account type's connection id is not equal connection_id params |