Endpoint Parameters

  • Request parameters

    Name Type Origin Description
    AccountGroupKey AccountGroupKey Query-String Id of the account containing the historical positions.
    AccountKey AccountKey Query-String Id of the account containing the historical positions.
    ClientKey ClientKey Route Id of the client owning the account
    FieldGroups AccountPerformanceFieldGroup [] Query-String Specifies which data to return. Default is
    FromDate Date Query-String From date from which the historical positions are requested.
    MockDataId String Query-String Optional Mock Data Parameter
    StandardPeriod AccountPerformanceStandardPeriod Query-String Standard period for account performance.
    ToDate Date Query-String To date till which the historical positions are requested.

  • Response Parameters

    View Response Codes
    Name Type Description
    AccountSummary AccountSummary The account summary consists performance metrics which is based on closed positions for an account over the entire lifespan of the account.
    Allocation Allocation The trades allocation.
    AvailableBenchmarks BenchMark [] The list of available benchmarks.
    BalancePerformance BalancePerformance Balance AccountPerformance metrics.
    BenchMark BenchMark The bench mark.
    BenchmarkPerformance TimeValuePair [] The benchmark performance.
    Currency String The currency in which the data is calculated on.
    From Date The start date is the offset date for all performance metrics that is a part of the 'AccountPerformance'.
    InceptionDay Date The date where the first account deposit have been registred.
    LastTradeDay Date Performance data that is returned is limited to the be data that lies between the first trade day and the last trade day for the account. The last trade day is the last day that one or more trades have been registred.
    Thru Date The end date is the ending date for all returned performance metrics that is a part of the 'AccountPerformance'. The 'ActualThruDate' date is included.
    TimeWeightedPerformance TimeWeightedPerformance Time weighted performance metrics.
    TotalCashBalance Number The total cash balance
    TotalCashBalancePerCurrency StringValuePair [] The total cash balance grouped by currency.
    TotalOpenPositionsValue Number The total value of client's open positions
    TotalPositionsValuePerCurrency StringValuePair [] The total position value grouped by currency.
    TotalPositionsValuePerProductPerSecurity PositionOnSecurityAndProduct [] The total position value grouped by product.
    TradeActivity TradeActivity The trade activity.

  • Request Example

    Request URL
    GET /hist/v3/perf/{ClientKey}?AccountGroupKey={AccountGroupKey}&AccountKey={AccountKey}&FieldGroups=AccountSummary&FromDate={FromDate}&MockDataId={MockDataId}&StandardPeriod=AllTime&ToDate={ToDate}

  • Response Example

    Response body
    {
  "AccountSummary": {
    "AverageTradeDurationInMinutes": 34260,
    "AverageTradesPerWeek": 48.2325728770595,
    "NumberOfDaysTraded": 1589,
    "NumberOfLongTrades": 5434,
    "NumberOfShortTrades": 5263,
    "TopTradedInstruments": [
      "DAX.I",
      "DJI.I",
      "EURUSD",
      "GBPUSD",
      "NAS100.I",
      "NOKSEK",
      "EURNOK",
      "SP500.I"
    ],
    "TotalReturnFraction": -0.9999963956455,
    "TradedInstruments": [
      "FxSpot",
      "Stock",
      "FxVanillaOption",
      "ContractFutures"
    ],
    "TradesTotalCount": 10697,
    "TradesWonCount": 6499,
    "WinFraction": 0.61
  },
  "Allocation": {
    "TradesPerAssetType": {
      "ClosedTradesAllocations": [
        {
          "AssetClassType": "Equity",
          "ReturnAttribution": 1,
          "TradeCount": 168,
          "TradePercent": 0.380090497737557
        },
        {
          "AssetClassType": "Currency",
          "ReturnAttribution": 0.249937016456527,
          "TradeCount": 112,
          "TradePercent": 0.253393665158371
        },
        {
          "AssetClassType": "Commodity",
          "ReturnAttribution": 0.562878945000956,
          "TradeCount": 105,
          "TradePercent": 0.237556561085973
        },
        {
          "AssetClassType": "Fixed Income",
          "ReturnAttribution": -0.0131508561362492,
          "TradeCount": 57,
          "TradePercent": 0.1289592760181
        }
      ]
    },
    "TradesPerInstrument": {
      "ClosedTradesAllocations": [
        {
          "AssetType": "ContractFutures",
          "InstrumentDescription": "30-Year U.S. Treasury Bond - Sep 2016",
          "InstrumentSymbol": "ZBU6",
          "InstrumentUic": 3626018,
          "ReturnAttribution": -0.159871010056843,
          "TradeCount": 40,
          "TradePercent": 0.0904977375565611
        },
        {
          "AssetType": "FxSpot",
          "InstrumentDescription": "British Pound/US Dollar",
          "InstrumentSymbol": "GBPUSD",
          "InstrumentUic": 31,
          "ReturnAttribution": 0.146851552251858,
          "TradeCount": 37,
          "TradePercent": 0.083710407239819
        }
      ]
    }
  },
  "BalancePerformance": {
    "AccountBalanceTimeSeries": [
      {
        "Date": "2016-03-28T00:00:00Z",
        "Value": 0
      },
      {
        "Date": "2016-03-29T00:00:00Z",
        "Value": 0
      }
    ],
    "AccountValueTimeSeries": [
      {
        "Date": "2016-03-28T00:00:00Z",
        "Value": 0
      },
      {
        "Date": "2016-03-29T00:00:00Z",
        "Value": 0
      }
    ],
    "MonthlyProfitLossTimeSeries": [
      {
        "Date": "2015-11-30T00:00:00Z",
        "Value": 0
      },
      {
        "Date": "2015-12-31T00:00:00Z",
        "Value": 0
      }
    ],
    "SecurityTransferTimeSeries": [
      {
        "Date": "2016-03-28T00:00:00Z",
        "Value": 0
      },
      {
        "Date": "2016-03-29T00:00:00Z",
        "Value": 0
      }
    ],
    "YearlyProfitLossTimeSeries": [
      {
        "Date": "2015-12-31T00:00:00Z",
        "Value": 0
      },
      {
        "Date": "2016-12-31T00:00:00Z",
        "Value": 0
      },
      {
        "Date": "2017-12-31T00:00:00Z",
        "Value": 0
      }
    ]
  },
  "From": "2016-03-28T00:00:00Z",
  "InceptionDay": "2015-11-24T00:00:00Z",
  "LastTradeDay": "2017-03-27T00:00:00Z",
  "Thru": "2017-03-27T00:00:00Z",
  "TimeWeightedPerformance": {
    "AccumulatedTimeWeightedTimeSeries": [
      {
        "Date": "2016-03-25T00:00:00Z",
        "Value": 0
      }
    ],
    "MonthlyReturnTimeSeries": [
      {
        "Date": "2016-03-25T00:00:00Z",
        "Value": 0
      }
    ],
    "PerformanceFraction": -1,
    "PerformanceKeyFigures": {
      "ClosedTradesCount": 0,
      "DrawdownReport": {
        "Drawdowns": [
          {
            "DaysCount": 3,
            "DepthInPercent": 1,
            "FromDate": "2016-08-05T00:00:00Z",
            "ThruDate": "2016-08-08T00:00:00Z"
          }
        ],
        "MaxDaysInDrawdownFromTop10Drawdowns": 3
      },
      "LosingDaysFraction": 0.03,
      "MaxDrawDownFraction": 1,
      "ReturnFraction": -1,
      "SampledStandardDeviation": 0.0618018874919214,
      "SharpeRatio": -0.952069751000777,
      "SortinoRatio": -0.0591710418985739
    },
    "YearlyReturnTimeSeries": [
      {
        "Date": "2016-03-25T00:00:00Z",
        "Value": 0
      }
    ]
  },
  "TotalCashBalance": 20226.02,
  "TotalCashBalancePerCurrency": [
    {
      "StringValue": "CAD",
      "Value": -491.707122366824
    }
  ],
  "TotalOpenPositionsValue": 29571.057,
  "TotalPositionsValuePerCurrency": [
    {
      "StringValue": "CAD",
      "Value": -491.707122366824
    }
  ],
  "TotalPositionsValuePerProductPerSecurity": [
    {
      "Description": "Abengoa SA - Warrants",
      "ProductName": "Shares",
      "Symbol": "LOCK - 1496:xxxx",
      "Value": 0
    }
  ]
}