/accounts/{accountId}/statsАгрегирует по закрытым позициям аккаунта: доля выигрышей, средняя прибыль и убыток, соотношение риска и вознаграждения, максимальная просадка и среднее время удержания.
- Отвечает пустым телом, пока у аккаунта ещё нет закрытых позиций.
- Охватывает каждую фазу, через которую прошёл аккаунт, а не только текущую.
https://api.upscale.tradeПараметры
accountIdstring · uuidобязательноИдентификатор торгового аккаунта. Должен принадлежать вызывающей стороне.
00000000-0000-4000-8000-000000000000Примеры
curl --request GET 'https://api.upscale.trade/accounts/{accountId}/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'const response = await fetch("https://api.upscale.trade/accounts/{accountId}/stats", {
method: "GET",
headers: {
"Accept": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
});
console.log(response.status, await response.text());import requests
response = requests.request(
"GET",
"https://api.upscale.trade/accounts/{accountId}/stats",
headers={"Accept":"application/json","Authorization":"Bearer YOUR_API_KEY"},
timeout=30,
)
print(response.status_code, response.text)Ответы
200Ответapplication/json
Body.riskRewardRatio must be array Body.maxDrawdownPercent must be array Body.avgLeverageProfitablePosition must be array
sumPnlstring · int32обязательноRealised pnl summed over every closed position, fp9 raw, before fees and funding.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000sumFeestring · int32обязательноTrading fees paid over every closed position, fp9 raw.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000sumFundingstring · int32обязательноFunding settled over every closed position, fp9 raw. Positive when the account received more than it paid.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000profitstring · int32обязательноNet result of the closed positions, fp9 raw: pnl minus fees plus funding. This is what the win rate splits on.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000positionsCountnumberобязательноNumber of closed positions the statistics are built from.
0profitablePositionsCountnumberобязательноClosed positions that ended at or above break-even.
0unprofitablePositionsCountnumberобязательноClosed positions that ended below break-even.
0winratePercentnumberобязательноShare of closed positions that ended at or above break-even, in percent with two decimals.
62.5minProfitstring · int32 · nullableобязательноSmallest win among profitable positions, fp9 raw. Null when there is none.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000minLossstring · int32 · nullableобязательноSmallest loss among losing positions, fp9 raw (negative, closest to zero). Null when there is none.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxProfitstring · int32 · nullableобязательноLargest win, fp9 raw. Null when no position ended in profit.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxLossstring · int32 · nullableобязательноLargest loss, fp9 raw (the most negative value). Null when no position ended in loss.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000avgProfitstring · int32 · nullableобязательноAverage win across profitable positions, fp9 raw. Null when there is none.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000avgLossstring · int32 · nullableобязательноAverage loss across losing positions, fp9 raw (negative). Null when there is none.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000riskRewardRationumber[]обязательноAverage win over the absolute average loss. Null while no losing position exists to divide by.
Элементы массива · number
number
maxDrawdownPercentnumber[]обязательноDeepest equity drawdown of the account across all its phases, in percent with two decimals.
Элементы массива · number
number
avgLongPositionHoldTimenumber[]обязательноAverage holding time of long positions, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]avgShortPositionHoldTimenumber[]обязательноAverage holding time of short positions, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]avgPositionHoldTimenumber[]обязательноAverage holding time across all closed positions, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]medianPositionHoldTimenumber[]обязательноMedian holding time across all closed positions, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]maxProfitablePositionHoldTimenumber[]обязательноLongest a profitable position was held, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]maxUnprofitablePositionHoldTimenumber[]обязательноLongest a losing position was held, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]medianProfitablePositionHoldTimenumber[]обязательноMedian holding time of profitable positions, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]medianUnprofitablePositionHoldTimenumber[]обязательноMedian holding time of losing positions, in seconds.
Элементы массива · number
number
Посмотреть пример
[
0
]avgLeverageProfitablePositionnumber[]обязательноAverage leverage of profitable positions — notional over margin, as a plain multiple.
Элементы массива · number
number
avgLeverageUnprofitablePositionnumber[]обязательноAverage leverage of losing positions — notional over margin, as a plain multiple.
Элементы массива · number
number
topMarketstring[]обязательноBase asset ticker of the most traded market, by number of closed positions. Null when nothing has been closed.
Элементы массива · string
string
topMarketPercentnumber[]обязательноShare of closed positions that were on topMarket, in percent with two decimals.
Элементы массива · number
number
Неавторизовано
Аккаунт принадлежит другому пользователю (account_access_denied), или запрос аутентифицирован с помощью API-ключа, тогда как api_trading отключён на аккаунте (api_trading_not_enabled).
Нет аккаунта с этим идентификатором.
Превышен лимит частоты запросов API-ключа (api_key_rate_limit_exceeded). Retry-After указывает, когда вернуться; тело содержит бакет (read / write), окно, которое сработало, его лимит и retryAt.