API الوثائق

Get Portfolio Statistics

get/api/v1/Wallet/portfolio-statistics

Each entry carries a {name}, a {total} value and, where the statistic is a genuine per-side figure (Gross Profit, Gross Loss, Trades PnL and the trade-count family), separate {longValue} and {shortValue} figures. Long / Short on return and risk statistics. Daily, monthly and annual return, volatility, Sharpe, Sortino and Value at Risk store a Long and Short value, but those columns are the portfolio total split by each side's share of gross trade activity — not separately measured long and short returns. Both columns always carry the same sign as the total. The published app hides them; treat only {total} as the return or risk figure. Units. Every statistic whose name ends in {%} is a decimal fraction, not a percentage: a {Net Profit %} of {0.0523} means 5.23%. Multiply by 100 to display. Money statistics such as {Net Profit} and {Gross Profit} are in the account's own currency. {Sharpe Ratio} and {Sortino Ratio} are dimensionless. The {format} field is a legacy display hint and should not be relied on to decide scaling. A statistic that has never been computed is absent from the array rather than returned as zero. A statistic that exists but has too little history to be meaningful is returned as zero, so a zero cannot always be distinguished from "not enough data yet". Null long and short. Statistics measured against the whole portfolio have no per-side figure at all, and return {longValue} and {shortValue} as {null} rather than {0}: Net Profit, Net Profit %, Worst and Average Floating Loss (and their {%} forms), Recovery Factor, Max Adverse Excursion and Max Favorable Excursion. Treat {null} as "not measured", which is distinct from a measured zero.

Wallet

حدود

accountId

query · integer

مطلوب

version

path · string

مطلوب

استجابات

200Current statistics for the account.application/json

[
  {
    "totalValue": 1000,
    "longValue": 1000,
    "shortValue": 1000,
    "name": "Alex Morgan",
    "type": 1,
    "portfolioId": 1001,
    "show": true,
    "category": "Example",
    "format": "2026-07-20T09:00:00Z",
    "typeId": 1001,
    "dateTime": "2026-07-20T09:00:00Z"
  }
]

404The caller is not signed in, or the account does not exist or is not visible to the caller.application/json

{
  "type": "Deposit",
  "title": "Example",
  "status": 1,
  "detail": "The request could not be completed. Check the values and try again.",
  "instance": "Example"
}

500Statistics could not be retrieved.

أطلق منصتك.

ابدأ.جرّبه.