> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://partner.ninjatrader.com/eval/api/rest-api-endpoints/accounting/change-demo-balance/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://partner.ninjatrader.com/_mcp/server. # Change Demo Balance POST https://live.tradovateapi.com/v1/cashBalance/changedemobalance Content-Type: application/json ### Change the cash balance of a demo account.**Available to:** All authenticated users**Environments:** Demo**[Rate Limit](/overview/core-concepts/rate-limits) (organization administrators):** None**[Rate Limit](/overview/core-concepts/rate-limits) (all other users):** One balance change per account per hour, with a max account balance of \$50,000Quickly adjust the simulated cash balance of a demo account in your organization. Use this endpoint to reset a trader's balance during an evaluation, top up an account before a new challenge phase, or adjust a balance after a practice session when you don't need the additional control that [`adjustCash`](/api/rest-api-endpoints/funds/adjust-cash) provides.**Warning:** This endpoint returns **HTTP 200** for successes **and** business errors. Always check the `errorText` field in the response body to determine whether the request succeeded or failed.**Difference Between `changeDemoBalance` and [`adjustCash`](/api/rest-api-endpoints/funds/adjust-cash)**The `changeDemoBalance` endpoint is available to all traders and has rate limits to protect against abuse. Because [`adjustCash`](/api/rest-api-endpoints/funds/adjust-cash) is restricted to organization administrators with `Funds` permissions, it supports higher throughput and doesn't have a rate limit. `adjustCash` also gives you more control: you can classify the adjustment type, specify the currency, and include an audit comment.**Field Details**The `accountId` must reference an active demo account within your organization. You can look up account IDs using the Query Builder in the Admin Dashboards or via the `/account/list` endpoint.The `cashChange` value is applied as a change to the current balance (positive values increase the balance and negative values decrease it). The `cashChange` value must be between -1,000,000 and 1,000,000 (exclusive). The resulting balance cannot exceed \$50,000.If the optional `comment` field is omitted, the server defaults to "Demo Change".**Reversing a Change**While you can't undo a change, you can make another `changeDemoBalance` call with the opposite `cashChange` amount.**Common Failure Scenarios**- Account ID is invalid (must be greater than 0) - Balance change requested within one hour of the last change - Balance change would cause the total account balance to exceed \$50,000 - `cashChange` is outside the allowed range (must be between -1,000,000 and 1,000,000, exclusive) - `comment` exceeds 64 characters - Demo account is closed or inactive - Request sent to the live or replay environment**Error Messages**| `errorText` | Trigger | | -------------------------------------------------------------------------------------------- | -------------------------------------------------- | | `"Access denied"` | Called on a non-demo environment (secondary guard) | | `"Account Id should be greater than 0"` | `accountId` is 0 or negative | | `"Cash Change should be greater than -1000000"` | `cashChange` is -1,000,000 or less | | `"Cash Change should be less than 1000000"` | `cashChange` is 1,000,000 or greater | | `"Comment should be no longer than 64"` | `comment` exceeds 64 characters | | `"Demo account is closed"` | The account is inactive | | `"Maximum cash amount in the simulation account must be less than or equal to $50,000"` | Resulting balance would exceed \$50,000 | | `"One change to the simulation cash balance is permitted per hour. Please try again later."` | Called within one hour of the last change | | `"This endpoint should be called on demo.tradovateapi.com"` | Called on the live or replay environment | Reference: https://partner.ninjatrader.com/eval/api/rest-api-endpoints/accounting/change-demo-balance ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Body (application/json) This endpoint expects a ChangeDemoBalance. - `accountId` (long, required) - `cashChange` (double, required) - `comment` (string, optional) ## Response ### 200 CashBalanceSnapshot - `errorText` (string, optional) — Non-empty if the request failed - `totalCashValue` (double, optional) - `totalPnL` (double, optional) - `initialMargin` (double, optional) - `maintenanceMargin` (double, optional) - `netLiq` (double, optional) - `openPnL` (double, optional) - `realizedPnL` (double, optional) - `weekRealizedPnL` (double, optional) - `withdrawalRejectReason` (enum, optional) — NoData, PendingContactInfoChange - Allowed values: `NoData`, `PendingContactInfoChange` - `currencyCashAvailWithdrawalUSD` (double, optional) - `netLiqSOD` (double, optional) - `totalCashValueSOD` (double, optional) - `cashUSD` (double, optional) - `cashSODUSD` (double, optional) - `fullInitialMargin` (double, optional) - `fullInitialMarginSOD` (double, optional) - `autoLiqLevel` (double, optional) - `fundsInTransitUSD` (double, optional) - `fundsInTransitAppliedToCashUSD` (double, optional) ## Examples **Request** ```json { "accountId": 1, "cashChange": 1.1 } ``` **Response** ```json { "errorText": "string", "totalCashValue": 1.1, "totalPnL": 1.1, "initialMargin": 1.1, "maintenanceMargin": 1.1, "netLiq": 1.1, "openPnL": 1.1, "realizedPnL": 1.1, "weekRealizedPnL": 1.1, "withdrawalRejectReason": "NoData", "currencyCashAvailWithdrawalUSD": 1.1, "netLiqSOD": 1.1, "totalCashValueSOD": 1.1, "cashUSD": 1.1, "cashSODUSD": 1.1, "fullInitialMargin": 1.1, "fullInitialMarginSOD": 1.1, "autoLiqLevel": 1.1, "fundsInTransitUSD": 1.1, "fundsInTransitAppliedToCashUSD": 1.1 } ``` **SDK Code** ```python import requests url = "https://live.tradovateapi.com/v1/cashBalance/changedemobalance" payload = { "accountId": 1, "cashChange": 1.1 } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://live.tradovateapi.com/v1/cashBalance/changedemobalance'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"accountId":1,"cashChange":1.1}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://live.tradovateapi.com/v1/cashBalance/changedemobalance" payload := strings.NewReader("{\n \"accountId\": 1,\n \"cashChange\": 1.1\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://live.tradovateapi.com/v1/cashBalance/changedemobalance") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"accountId\": 1,\n \"cashChange\": 1.1\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://live.tradovateapi.com/v1/cashBalance/changedemobalance") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"accountId\": 1,\n \"cashChange\": 1.1\n}") .asString(); ``` ```php request('POST', 'https://live.tradovateapi.com/v1/cashBalance/changedemobalance', [ 'body' => '{ "accountId": 1, "cashChange": 1.1 }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://live.tradovateapi.com/v1/cashBalance/changedemobalance"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"accountId\": 1,\n \"cashChange\": 1.1\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "accountId": 1, "cashChange": 1.1 ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://live.tradovateapi.com/v1/cashBalance/changedemobalance")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```