curl --request GET \
--url 'https://gateway.amana.io/trading/session/{login}' \
--header 'Authorization: Bearer <token>'
import requests
url = "https://gateway.amana.io/trading/session/{login}"
headers = {"Authorization": "Bearer <token>"}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/trading/session/{login}', {
method: 'GET',
headers: {"Authorization": "Bearer <token>"},
});
console.log(await response.json());
{
"login": 123.45,
"balance": 123.45,
"credit": 0,
"storage": 123.45,
"assets": 0,
"prevEquity": 123.45,
"prevBalance": 123.45,
"leverage": 123.45,
"group": "<string>",
"server": "<string>",
"createdAt": 123.45,
"currency": "<string>",
"kyc_status": "<string>",
"equity": 123.45,
"Invested": 123.45,
"Profits": 123.45,
"access": {
"id": "<string>",
"name": "<string>",
"currency": "<string>",
"currencyDigits": 123.45,
"isHedged": true,
"noPl": true
},
"positions": [
{
"id": "<string>",
"symbol": "<string>",
"logo": "<string>",
"delayed": false,
"sharia": false,
"digits": 123.45,
"friendlyName": "<string>",
"units": 123.45,
"priceOpen": 123.45,
"priceCurrent": 123.45,
"timeCreate": 123.45,
"timeUpdate": 123.45,
"leverage": 123.45,
"rateMargin": 1,
"rateProfit": 1,
"isBuy": true,
"sl": 0,
"tp": 0,
"storage": 0,
"comment": "<string>",
"profit": 0,
"invested": 0
}
],
"orders": [
{
"id": "<string>",
"symbol": "<string>",
"logo": "<string>",
"friendlyName": "<string>",
"units": 123.45,
"digits": 123.45,
"state": 123.45,
"delayed": false,
"sharia": false,
"priceOpen": 123.45,
"priceCurrent": 123.45,
"leverage": 123.45,
"timeCreate": 123.45,
"timeUpdate": 123.45,
"rateMargin": 1,
"isBuy": true,
"isLimit": true,
"sl": 0,
"tp": 0,
"comment": "<string>",
"invested": 0,
"useMargin": true
}
]
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Trading
Get account snapshot
Get a full snapshot of a trading account: balance, equity, open positions, unrealized P&L, group settings, and KYC status.
GET
/
trading
/
session
/
{login}
curl --request GET \
--url 'https://gateway.amana.io/trading/session/{login}' \
--header 'Authorization: Bearer <token>'
import requests
url = "https://gateway.amana.io/trading/session/{login}"
headers = {"Authorization": "Bearer <token>"}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/trading/session/{login}', {
method: 'GET',
headers: {"Authorization": "Bearer <token>"},
});
console.log(await response.json());
{
"login": 123.45,
"balance": 123.45,
"credit": 0,
"storage": 123.45,
"assets": 0,
"prevEquity": 123.45,
"prevBalance": 123.45,
"leverage": 123.45,
"group": "<string>",
"server": "<string>",
"createdAt": 123.45,
"currency": "<string>",
"kyc_status": "<string>",
"equity": 123.45,
"Invested": 123.45,
"Profits": 123.45,
"access": {
"id": "<string>",
"name": "<string>",
"currency": "<string>",
"currencyDigits": 123.45,
"isHedged": true,
"noPl": true
},
"positions": [
{
"id": "<string>",
"symbol": "<string>",
"logo": "<string>",
"delayed": false,
"sharia": false,
"digits": 123.45,
"friendlyName": "<string>",
"units": 123.45,
"priceOpen": 123.45,
"priceCurrent": 123.45,
"timeCreate": 123.45,
"timeUpdate": 123.45,
"leverage": 123.45,
"rateMargin": 1,
"rateProfit": 1,
"isBuy": true,
"sl": 0,
"tp": 0,
"storage": 0,
"comment": "<string>",
"profit": 0,
"invested": 0
}
],
"orders": [
{
"id": "<string>",
"symbol": "<string>",
"logo": "<string>",
"friendlyName": "<string>",
"units": 123.45,
"digits": 123.45,
"state": 123.45,
"delayed": false,
"sharia": false,
"priceOpen": 123.45,
"priceCurrent": 123.45,
"leverage": 123.45,
"timeCreate": 123.45,
"timeUpdate": 123.45,
"rateMargin": 1,
"isBuy": true,
"isLimit": true,
"sl": 0,
"tp": 0,
"comment": "<string>",
"invested": 0,
"useMargin": true
}
]
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Path parameters
number
required
The MT5 login number of the authenticated user. Must match the login in the JWT — returns 403 otherwise.
Response
200 Success.
number
number
number
default:"0"
number
number
default:"0"
number
number
number
string
string
number
string
string
number
number
number
object[]
object[]
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 400 | Invalid or missing field, amount outside limits | Check the request against the schema and the instrument’s size limits. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |
curl --request GET \
--url 'https://gateway.amana.io/trading/session/{login}' \
--header 'Authorization: Bearer <token>'
import requests
url = "https://gateway.amana.io/trading/session/{login}"
headers = {"Authorization": "Bearer <token>"}
response = requests.request("GET", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/trading/session/{login}', {
method: 'GET',
headers: {"Authorization": "Bearer <token>"},
});
console.log(await response.json());
{
"login": 123.45,
"balance": 123.45,
"credit": 0,
"storage": 123.45,
"assets": 0,
"prevEquity": 123.45,
"prevBalance": 123.45,
"leverage": 123.45,
"group": "<string>",
"server": "<string>",
"createdAt": 123.45,
"currency": "<string>",
"kyc_status": "<string>",
"equity": 123.45,
"Invested": 123.45,
"Profits": 123.45,
"access": {
"id": "<string>",
"name": "<string>",
"currency": "<string>",
"currencyDigits": 123.45,
"isHedged": true,
"noPl": true
},
"positions": [
{
"id": "<string>",
"symbol": "<string>",
"logo": "<string>",
"delayed": false,
"sharia": false,
"digits": 123.45,
"friendlyName": "<string>",
"units": 123.45,
"priceOpen": 123.45,
"priceCurrent": 123.45,
"timeCreate": 123.45,
"timeUpdate": 123.45,
"leverage": 123.45,
"rateMargin": 1,
"rateProfit": 1,
"isBuy": true,
"sl": 0,
"tp": 0,
"storage": 0,
"comment": "<string>",
"profit": 0,
"invested": 0
}
],
"orders": [
{
"id": "<string>",
"symbol": "<string>",
"logo": "<string>",
"friendlyName": "<string>",
"units": 123.45,
"digits": 123.45,
"state": 123.45,
"delayed": false,
"sharia": false,
"priceOpen": 123.45,
"priceCurrent": 123.45,
"leverage": 123.45,
"timeCreate": 123.45,
"timeUpdate": 123.45,
"rateMargin": 1,
"isBuy": true,
"isLimit": true,
"sl": 0,
"tp": 0,
"comment": "<string>",
"invested": 0,
"useMargin": true
}
]
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Last modified on October 8, 2026
