For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Support Center
OverviewAPIResources
OverviewAPIResources
  • REST API Endpoints
      • GETAccount Risk Status Dependents
      • GETAccount Risk Status Item
      • GETAccount Risk Status Items
      • GETAccount Risk Status L Dependents
      • GETAccount Risk Status List
      • GETContract Margin Dependents
      • GETContract Margin Item
      • GETContract Margin Items
      • GETContract Margin L Dependents
      • POSTDelete User Account Position Limit
      • POSTDelete User Account Risk Parameter
      • GETPermissioned Account Auto Liq Dependents
      • GETPermissioned Account Auto Liq Item
      • GETPermissioned Account Auto Liq Items
      • GETPermissioned Account Auto Liq L Dependents
      • GETPermissioned Account Auto Liq List
      • GETProduct Margin Dependents
      • GETProduct Margin Item
      • GETProduct Margin Items
      • GETProduct Margin L Dependents
      • GETProduct Margin List
      • POSTReset Auto Liq Status
      • POSTSet Account Notes
      • POSTSet Admin Auto Liq Action
      • POSTSwitch Risk Category
      • POSTUpdate Max Net Liq
      • POSTUpdate User Auto Liq
      • POSTUser Account Auto Liq Create
      • GETUser Account Auto Liq Dependents
      • GETUser Account Auto Liq Item
      • GETUser Account Auto Liq Items
      • GETUser Account Auto Liq L Dependents
      • GETUser Account Auto Liq List
      • POSTUser Account Auto Liq Update
      • POSTUser Account Position Limit Create
      • GETUser Account Position Limit Dependents
      • GETUser Account Position Limit Item
      • GETUser Account Position Limit Items
      • GETUser Account Position Limit L Dependents
      • POSTUser Account Position Limit Update
      • POSTUser Account Risk Parameter Create
      • GETUser Account Risk Parameter Dependents
      • GETUser Account Risk Parameter Item
      • GETUser Account Risk Parameter Items
      • GETUser Account Risk Parameter L Dependents
      • POSTUser Account Risk Parameter Update
Support Center
LogoLogo
REST API EndpointsRisks

Switch Risk Category

POST
https://demo.tradovateapi.com/v1/accountRiskStatus/switchriskcategory
POST
/v1/accountRiskStatus/switchriskcategory
1const url = 'https://demo.tradovateapi.com/v1/accountRiskStatus/switchriskcategory';
2const options = {
3  method: 'POST',
4  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5  body: '{"accountIds":[1234567890,9876543210,1122334455],"riskCategoryId":3}'
6};
7
8try {
9  const response = await fetch(url, options);
10  const data = await response.json();
11  console.log(data);
12} catch (error) {
13  console.error(error);
14}
200Successful
1{
2  "ok": true,
3  "errorText": ""
4}
### Switch the active risk category for one or more accounts. **Available to:** Organization administrators **Environments:** Demo, Live **[Rate Limit](/overview/core-concepts/rate-limits):** 5,000 requests per hour, 1-second back-off, counts all requests Use this endpoint to switch the risk category of up to 10,000 accounts in a single request. Accounts that already have the target risk category are skipped. [Risk categories](/overview/prop-firm-management/risk-management/pre-trade-risk#risk-categories) are initially defined by your [Template Account](/overview/prop-firm-management/create-and-manage-users-and-accounts#template-account-id) and applied at creation, but you can adjust risk categories after by contacting Eval Support. To view the available risk categories for your organization, call `/riskCategory/list`. <Warning>Switch risk categories outside of trading hours or when affected accounts have no open positions. Switching risk categories re-evaluates open positions, potentially causing open positions to be auto-liquidated.</Warning> **Common Failure Scenarios** - `"Empty accountIds"`: the `accountIds` array is empty - `"Only 10000 accounts are allowed in single operation"`: the request exceeds the 10,000-account limit - The specified `riskCategoryId` does not exist (returns `HTTP 404`) - One or more account IDs do not exist (returns `HTTP 404`)
Was this page helpful?
Previous

Update Max Net Liq

Next
Built with

Switch the active risk category for one or more accounts.

Available to: Organization administrators

Environments: Demo, Live

Rate Limit: 5,000 requests per hour, 1-second back-off, counts all requests

Use this endpoint to switch the risk category of up to 10,000 accounts in a single request. Accounts that already have the target risk category are skipped.

Risk categories are initially defined by your Template Account and applied at creation, but you can adjust risk categories after by contacting Eval Support.

To view the available risk categories for your organization, call /riskCategory/list.

Switch risk categories outside of trading hours or when affected accounts have no open positions. Switching risk categories re-evaluates open positions, potentially causing open positions to be auto-liquidated.

Common Failure Scenarios

  • "Empty accountIds": the accountIds array is empty
  • "Only 10000 accounts are allowed in single operation": the request exceeds the 10,000-account limit
  • The specified riskCategoryId does not exist (returns HTTP 404)
  • One or more account IDs do not exist (returns HTTP 404)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
accountIdslist of longsRequired
riskCategoryIdlongRequired

Response

SimpleResponse
okboolean
errorTextstring<=8192 characters

Non-empty if the request failed