MetaTrader API
Metatrader 4 api

Trade Stats

Trading statistic

Equity history

GET
/EquityHistory
x-api-key<token>

Your API key

In: header

Query Parameters

idstring

Your Account UUID which you connected via the Dashboard

Default"{{id}}"
fromstring

From datetime

Default"2024-10-01T00:00:00"
excludeSameBars?boolean

Return short version without equal bars

Defaulttrue

Response Body

curl -X GET "https://api.metatraderapi.dev/EquityHistory?id=%7B%7Bid%7D%7D&from=2024-10-01T00%3A00%3A00&excludeSameBars=true"
[
  {
    "time": "2019-08-24T14:15:22Z",
    "balance": 0.1,
    "equity": 0.1,
    "balanceDrawdownRaw": 0.1,
    "balanceDrawdownRelative": 0.1,
    "equityDrawdownRaw": 0.1,
    "equityDrawdownRelative": 0.1,
    "realizedPL": 0.1,
    "unrealizedPL": 0.1
  }
]
{
  "message": "string",
  "code": "INTERNAL_ERROR",
  "stackTrace": "string"
}

Get Trade Statistics Equity History

Returns StatsResult that contains calulcated parameters and charts.

GET
/TradeStatsEquityHistory
x-api-key<token>

Your API key

In: header

Query Parameters

idstring

Your Account UUID which you connected via the Dashboard

fromstring

'From date' in format: yyyy-MM-ddTHH:mm:ss

Default"2024-01-01T00:00:00"
excludeSameBars?boolean

Return short version without equal bars

Defaulttrue

Response Body

curl -X GET "https://api.metatraderapi.dev/TradeStatsEquityHistory?id=string&from=2024-01-01T00%3A00%3A00&excludeSameBars=true"
{
  "stats": {
    "summary": {
      "openTrades": 0,
      "openProfit": 0.1,
      "dayProfit": 0.1,
      "weekProfit": 0.1,
      "monthProfit": 0.1,
      "totalProfit": 0.1
    },
    "maxBalanceDrawdownRaw": 0.1,
    "maxBalanceDrawdownRelative": 0.1,
    "maxEquityDrawdownRaw": 0.1,
    "maxEquityDrawdownRelative": 0.1,
    "markets": [
      {
        "marketName": "string",
        "count": 0
      }
    ],
    "profitability": {
      "wonTrades": 0,
      "wonTradesPercent": 0.1,
      "lostTrades": 0,
      "lostTradesPercent": 0.1
    },
    "pips": 0.1,
    "lots": 0.1,
    "comissions": 0.1,
    "averageWin": {
      "averagePips": 0.1,
      "averageUsd": 0.1
    },
    "averageLost": {
      "averagePips": 0.1,
      "averageUsd": 0.1
    },
    "longsWon": {
      "wonCount": 0,
      "all": 0,
      "wonPersent": 0.1
    },
    "shortsWon": {
      "wonCount": 0,
      "all": 0,
      "wonPersent": 0.1
    },
    "bestTrade": {
      "tiket": 0,
      "date": "2019-08-24T14:15:22Z",
      "profit": 0.1
    },
    "worstTrade": {
      "tiket": 0,
      "date": "2019-08-24T14:15:22Z",
      "profit": 0.1
    },
    "bestTradePips": {
      "tiket": 0,
      "date": "2019-08-24T14:15:22Z",
      "profit": 0.1
    },
    "worstTradePips": {
      "tiket": 0,
      "date": "2019-08-24T14:15:22Z",
      "profit": 0.1
    },
    "averageTradeLength": "string",
    "profitFactor": 0.1,
    "standardDeviation": 0.1,
    "sharpeRatio": 0.1,
    "zScore": {
      "zScoreDecimal": 0.1,
      "zScoreProbability": 0.1
    },
    "expectancy": {
      "pips": 0.1,
      "dollar": 0.1
    },
    "ghpr": 0.1,
    "trades": 0
  },
  "charts": [
    {
      "time": "2019-08-24T14:15:22Z",
      "balance": 0.1,
      "equity": 0.1,
      "balanceDrawdownRaw": 0.1,
      "balanceDrawdownRelative": 0.1,
      "equityDrawdownRaw": 0.1,
      "equityDrawdownRelative": 0.1,
      "realizedPL": 0.1,
      "unrealizedPL": 0.1
    }
  ]
}
{
  "message": "string",
  "code": "INTERNAL_ERROR",
  "stackTrace": "string"
}