Skip to content

Reset subscriber stop outs#

About#

Resets a subscriber-level stop out. Please note that before resetting a stopout via this API you need to adjust startTime setting of your stopout or risk limit configuration of your subscriber.

POST /users/current/subscribers/:subscriberId/stopouts/:reason/reset

For more information see Swagger documentation

Headers#

Name Type Required Description
auth-token string Yes authorization token. See Authentication & authorization

Path parameters#

Name Type Required Description
subscriberId string Yes subscriber id
reason string Yes reason of a stop out to reset. Formed by concatenation of risk limit type and apply to values. One of year-balance-difference, year-to-date-balance-difference, quarter-balance-difference, quarter-to-date-balance-difference, month-balance-difference, month-to-date-balance-difference, week-balance-difference, week-to-date-balance-difference, day-balance-difference, date-balance-difference, lifetime-balance-difference, year-balance-minus-equity, year-to-date-balance-minus-equity, quarter-balance-minus-equity, quarter-to-date-balance-minus-equity, month-balance-minus-equity, month-to-date-balance-minus-equity, week-balance-minus-equity, week-to-date-balance-minus-equity, day-balance-minus-equity, date-balance-minus-equity, lifetime-balance-minus-equity, year-equity-difference, year-to-date-equity-difference, quarter-equity-difference, quarter-to-date-equity-difference, month-equity-difference, month-to-date-equity-difference, week-equity-difference, week-to-date-equity-difference, day-equity-difference, date-equity-difference, lifetime-equity-difference

Response#

Responses:

  • 204 - Stopouts were reset successfully
  • 401 - Authorization failed. Response schema: Error
  • 404 - Subscriber not found. Response schema: Error

Examples#

Example request:

First step is to adjust the startTime setting on the stopout or risk limit configuration or both. See Update subscriber API for more details.

curl -X PUT --header 'Accept: application/json' --header 'auth-token: token' -d '{
  "name": "Demo account",
  "accountId": "105646d8-8c97-4d4d-9b74-413bd66cd4ed",
  "riskLimits": [
    {
      ... (risk limit settings go here),
      "type": "day",
      "applyTo": "balance-difference",
      "startFrom": "2021-03-22T00:00:00.000Z" (current time)
    }
  ]
  "subscriptions": [
    ... (subscriptions settings)
  ]
}' 'https://copyfactory-api-v1.new-york.agiliumtrade.ai/users/current/configuration/subscribers/105646d8-8c97-4d4d-9b74-413bd66cd4ed'

Finally, you can reset the stopout so that trading can continue.

curl -X POST --header 'Accept: application/json' --header 'auth-token: token' 'https://copyfactory-api-v1.new-york.agiliumtrade.ai/users/current/subscribers/105646d8-8c97-4d4d-9b74-413bd66cd4ed/stopouts/day-balance-difference/reset'