MngGetAccountsByLogins

MngGetAccountsByLogins¶

Command: MngGetAccountsByLogins

Deprecated alias: GetAccountsByLogins

GetAccountsByLogins is kept only for backward compatibility. New integrations must use MngGetAccountsByLogins; the alias may be removed in a future release.

Description:
Returns detailed account information for a specified list of login IDs. The response includes financial data, permissions, margin statistics, and online status.

Access Control¶

🛡️ Access Level Required: SESSION_MANAGER, SESSION_ADMIN, SESSION_DEALER

Endpoint¶

GET /accounts/logins/list

Request Parameters¶

Name	Type	Required	Description
logins	array	Yes	List of account login IDs (int)

Request Example¶

{
  "command": "MngGetAccountsByLogins",
  "data": {
  "logins": [1001, 1002, 1050]
  }
}

Response Structure¶

The response contains two keys:

structure — array describing column order
rows — array of account records matching the structure

Structure Fields¶

Field	Description
login	Account login ID
enable	Account enabled flag
enable_read_only	Read-only flag
enable_change_password	Change password permission
leverage	Account leverage
currency	Account currency
group	Account group
brand	Derived brand namespace from the account trading group
email	Email address
country	Country
phone	Phone number
comment	Comment
address	Address
city	City
zipcode	Zip code
name	Full name
regdate	Registration timestamp
prevbalance	Previous balance
prevmonthbalance	Previous month balance
balance	Current balance
credit	Credit amount
margin	Used margin
margin_free	Free margin
margin_level	Margin level
equity	Equity
profit	Gross floating profit
net_profit	Net profit: `profit + storage + commission`
storage	Storage/swap
commission	Commission
online	Online status flag
magic	Account magic identifier
customer_id	Linked customer ID
update_time	Last account business update timestamp

Example Response¶

{
  "structure": [
    "login", "enable", "enable_read_only", "enable_change_password",
    "leverage", "currency", "group", "brand", "email", "country", "phone",
    "comment", "address", "city", "zipcode", "name", "regdate",
    "prevbalance", "prevmonthbalance", "balance", "credit",
    "margin", "margin_free", "margin_level", "equity", "profit", "net_profit", "storage", "commission", "online", "magic", "customer_id", "update_time"
  ],
  "rows": [
    [
      1001, 1, 0, 1, 100, "USD", "standard", "ion4",
      "[email protected]", "US", "+123456789",
      "", "Street 1", "NY", "10001", "John Doe",
      1680000000, 5000.0, 4800.0, 5200.0, 0.0,
      1200.0, 4000.0, 350.0, 5200.0, 0.0, -1.6, -0.4, -1.2, 1, 0, 0
    ]
  ]
}

Error Responses¶

Validation Error¶

{
  "error": "INVALID_DATA",
  "message": "logins is required"
}

Not Found¶

{
  "error": "ACCOUNT_NOT_FOUND"
}