Account Actions

Perform advanced account management operations with powerful tools for resetting demo accounts, switching risk categories, updating liquidity, and managing trading halts.

Reset Demo Account State

Reset a simulation account to its market-open state on a given date. This is useful for returning accounts to their starting values or fixing issues that occurred during trading.

Via Dashboard

1. Navigate to the Query Builder and select “accounts” from the Repository Name dropdown
2. Enter IDs of accounts you want to reset to the given date
   • For example, to find accounts with a negative P/L affected by a trading issue, use a WHERE clause like active AND !isNull(cta.ctaContact) AND dollarTotalPL < 0
3. Click “Run Query” and wait for the list to populate
4. Select one or more accounts (bulk execution is allowed)
5. Click “ACTIONS”, then “Reset Demo Account State”
6. Select a date using the Date input, then click “APPLY”
   • For example, when resetting after a trading issue, select the prior trading day to restore accounts to their start-of-day state

Via API

Use the following endpoints:

Production: https://demo.tradovateapi.com/v1/account/resetDemoAccountState
Development: https://demo-api.staging.ninjatrader.dev/v1/account/resetDemoAccountState

Send a POST request with this JSON body:

1
{ 
2
  "accountIds": [12345, 67890], 
3
  "resetTradeDate": {  
4
    "day": 15,  
5
    "month": 8,  
6
    "year": 2023 
7
  }
8
}

Success Response:

1
{ "ok": true }

Error Response:

1
{ 
2
  "errorText": "Empty accountIds", 
3
  "ok": false
4
}

Switch Account’s Active Risk Category

Switch an account’s Risk Category to change risk parameters like max lot size, allowed products, or to switch to a trade-halted category.

Via Dashboard

1. Go to the Query Builder and select ‘accounts’ from the Repository Name dropdown
2. Enter relevant IDs, master ID, or SQL-like WHERE statements to filter results
3. Run the query and select one or more accounts (bulk actions are allowed)
4. Click “ACTIONS” and select “Switch Risk Category”
5. Choose from the defined Risk Category entities for your business
6. Confirm the change

Via API

Use the following endpoints:

Production: https://demo.tradovateapi.com/v1/accountRiskStatus/switchRiskCategory
Development: https://demo-api.staging.ninjatrader.dev/v1/accountRiskStatus/switchRiskCategory

Send a POST request with this JSON body:

1
{
2
  "accountIds": [12345, 67890],   	
3
  "riskCategoryId": 789
4
}

To find all Risk Categories associated with your organization, call /riskCategory/list.

Lock or Unlock an Account

Lock or unlock an account to control trading permissions and account access. For step-by-step instructions, see Immediate Trading Halts.

For the full list of available adminAction and adminActionReasonCode values, see the setAdminAutoLiqAction API reference.

Update Max Net Liquidity

Update an account’s maximum net liquidity to fix drawdown issues or adjust risk parameters.

Via Dashboard

1. Use the Query Builder to find an account or list of accounts
2. Select the account you want to modify
3. Click “ACTIONS” and select “Update MaxNetLiq”
4. Enter the desired value and click “Update”
5. You should see a confirmation message appear

Via API

Use the following endpoints:

Production: https://demo.tradovateapi.com/v1/accountRiskStatus/updateMaxNetLiq
Development: https://demo-api.staging.ninjatrader.dev/v1/accountRiskStatus/updateMaxNetLiq

Send a POST request with this JSON body:

1
{
2
  "accountId": 12345,
3
  "maxNetLiq": 50000
4
}

Halt Trading for a Risk Category

Halt trading for all accounts with a given risk category. For step-by-step instructions, see Immediate Trading Halts.

Demo Account Manual Cash Adjustment

Make direct balance changes to demo accounts. Use this carefully as it may have unexpected results when dealing with auto-liquidation configurations.

Via Dashboard

1. Use the Query Builder to find an account or list of accounts
2. Select the account you want to modify
3. Click “ACTIONS” and select “Manual Cash Adjust”
4. Fill in the adjustment details:
   • Amount: The credit (positive value) or debit (negative value) to the account
   • Type: How the credit/debit affects other values (Manual Adjustment is typically what you want)
   • Currency: The currency type of the change amount
   • Description: An arbitrary comment to describe the transaction
5. Click “APPLY”

Via API

For high-volume or automated workflows, use the adjustCash endpoint. It supports higher throughput than changeDemoBalance and gives you control over the change type, currency, and audit comments.

Production: https://demo.tradovateapi.com/v1/fundtransaction/adjustcash
Development: https://demo-api.staging.ninjatrader.dev/v1/fundtransaction/adjustcash

Send a POST request with this JSON body:

1
{
2
  "accountId": 12345,
3
  "cashChange": 1000,
4
  "cashChangeType": "ManualAdjustment",
5
  "currencyId": 1,
6
  "comment": "Balance reset for evaluation"
7
}

For simple balance changes, you can also use the changeDemoBalance endpoint, which requires only cashChange and accountId:

Production: https://demo.tradovateapi.com/v1/cashBalance/changeDemoBalance
Development: https://demo-api.staging.ninjatrader.dev/v1/cashBalance/changeDemoBalance

1
{
2
  "cashChange": -500,
3
  "accountId": 12345
4
}

Bulk Operations

Bulk Trading Permission Revocation

Revoke multiple trading permissions at once using the following endpoints:

Production: https://demo.tradovateapi.com/v1/user/revokeTradingPermissions
Development: https://demo-api.staging.ninjatrader.dev/v1/user/revokeTradingPermissions

Send a POST request with this body:

1
{
2
  "tradingPermissionIds": [123, 456, 789]
3
}

Cancel Everything

Use the special “cancelEverything” API endpoint to cancel all subscriptions, revoke trading permissions, and clear MD subscriptions and renewals.

Production Endpoints:

• https://demo.tradovateapi.com/v1/user/cancelEverything
• https://live.tradovateapi.com/v1/user/cancelEverything

Development Endpoints:

• https://demo-api.staging.ninjatrader.dev/v1/user/cancelEverything
• https://live-api.staging.ninjatrader.dev/v1/user/cancelEverything

Send a POST request with this JSON body:

1
{
2
  "userIds": [12345, 67890]
3
}

Response:

1
{
2
  "tradovateSubscriptionIds": [...],
3
  "tradingPermissionIds": [...],
4
  "userPluginIds": [...],
5
  "marketDataSubscriptionIds": [...]
6
}