> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://partner.tradovate.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://partner.tradovate.com/_mcp/server. # Adjust Cash POST https://demo.tradovateapi.com/v1/fundTransaction/adjustcash Content-Type: application/json ### Adjust the cash balance of a demo account. **Available to:** Organization administrators **Environments:** Demo **[Rate Limit](/overview/core-concepts/rate-limits):** No endpoint-specific limit Manage the simulated fund balances of your organization's demo accounts. Use this endpoint to top up a trader's balance mid-challenge, set starting balances for new evaluation accounts, or reset a balance after it's been depleted. If your call returns an `HTTP 401` "Access is denied" error, your API key is missing the required `Funds:FullAccess` scope. Contact Evaluation Support to have this scope added to your API key as a one-time setup during a scheduled [maintenance window](/resources/reference/maintenance-windows). After the scope change, if your API key uses a dedicated password, the password reverts to your API Admin User's password. **Difference Between `adjustCash` and [`changeDemoBalance`](/api/rest-api-endpoints/accounting/change-demo-balance)** The [`changeDemoBalance`](/api/rest-api-endpoints/accounting/change-demo-balance) endpoint is available to all traders and has rate limits to protect against abuse. Because `adjustCash` 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 `currencyId` must correspond to one of the supported currencies: USD, EUR, AUD, GBP, or CAD. Currency IDs are environment-specific. Use the `/currency/list` endpoint to retrieve valid IDs for your environment. **Relevant `cashChangeType` Values** All `CashChangeType` enum values are accepted, but these are the most relevant for typical demo balance management: * `ManualAdjustment`: General-purpose balance changes * `Courtesy`: Goodwill credits * `Debit`: Deductions from an account * `FundTransaction`: Funding-related changes * `ChallengePayout`: Challenge or evaluation payouts **Common Failure Scenarios** * Account is closed or inactive * `accountId` does not exist or does not belong to your organization * `cashChange` is outside the allowed range (must be between -100,000 and 100,000, exclusive) * `comment` exceeds 64 characters * API key is missing `Funds:FullAccess` scope (returns `HTTP 401`) * User is not an organization administrator **Reversing an Adjustment** There is no dedicated undo operation. To reverse a cash adjustment, make another `adjustCash` call with the opposite `cashChange` amount. Use the `comment` field to document the reason and link the reversal to the original entry. The response includes a full `CashBalanceSnapshot` reflecting the account's updated state. On success, the `errorText` field is absent and all balance fields are populated. Reference: https://partner.tradovate.com/api/rest-api-endpoints/funds/adjust-cash ## 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 an AdjustCash. - `accountId` (long, required) - `cashChange` (double, required) - `cashChangeType` (enum, required) — AccountClosureFee, AddUserFee, AutomaticReconciliation, BrokerageFee, CancelledPairedTrade, CashSettlement, ChallengePayout, ClearingFee, Commission, Courtesy, CurrencyConversion, CurrencyConversionFee, Debit, DepositFee, DeskFee, DormantFee, EntitlementSubscription, Escheatment, ExchangeFee, FundTransaction, FundTransactionFee, FundingRate, GoodwillCredit, IPFee, InactivityFee, LiquidationFee, LiquidationFee2, ManualAdjustment, MarketDataSubscription, NewSession, NfaFee, NsfCheckFee, OptionsTrade, OrderRoutingFee, PROMO, RithmicFee, SeatLeasePayment, StopPaymentFee, SwapTrade, ThirdPartyFee, TradePaired, TradovateSubscription - Allowed values: `AccountClosureFee`, `AddUserFee`, `AutomaticReconciliation`, `BrokerageFee`, `CancelledPairedTrade`, `CashSettlement`, `ChallengePayout`, `ClearingFee`, `Commission`, `Courtesy`, `CurrencyConversion`, `CurrencyConversionFee`, `Debit`, `DepositFee`, `DeskFee`, `DormantFee`, `EntitlementSubscription`, `Escheatment`, `ExchangeFee`, `FundTransaction`, `FundTransactionFee`, `FundingRate`, `GoodwillCredit`, `IPFee`, `InactivityFee`, `LiquidationFee`, `LiquidationFee2`, `ManualAdjustment`, `MarketDataSubscription`, `NewSession`, `NfaFee`, `NsfCheckFee`, `OptionsTrade`, `OrderRoutingFee`, `PROMO`, `RithmicFee`, `SeatLeasePayment`, `StopPaymentFee`, `SwapTrade`, `ThirdPartyFee`, `TradePaired`, `TradovateSubscription` - `currencyId` (long, required) - `comment` (string, optional) - `senderId` (long, 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) ## Examples **Request** ```json { "accountId": 1, "cashChange": 1.1, "cashChangeType": "AccountClosureFee", "currencyId": 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 } ``` **SDK Code** ```python import requests url = "https://demo.tradovateapi.com/v1/fundTransaction/adjustcash" payload = { "accountId": 1, "cashChange": 1.1, "cashChangeType": "AccountClosureFee", "currencyId": 1 } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://demo.tradovateapi.com/v1/fundTransaction/adjustcash'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"accountId":1,"cashChange":1.1,"cashChangeType":"AccountClosureFee","currencyId":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://demo.tradovateapi.com/v1/fundTransaction/adjustcash" payload := strings.NewReader("{\n \"accountId\": 1,\n \"cashChange\": 1.1,\n \"cashChangeType\": \"AccountClosureFee\",\n \"currencyId\": 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://demo.tradovateapi.com/v1/fundTransaction/adjustcash") 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 \"cashChangeType\": \"AccountClosureFee\",\n \"currencyId\": 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://demo.tradovateapi.com/v1/fundTransaction/adjustcash") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"accountId\": 1,\n \"cashChange\": 1.1,\n \"cashChangeType\": \"AccountClosureFee\",\n \"currencyId\": 1\n}") .asString(); ``` ```php request('POST', 'https://demo.tradovateapi.com/v1/fundTransaction/adjustcash', [ 'body' => '{ "accountId": 1, "cashChange": 1.1, "cashChangeType": "AccountClosureFee", "currencyId": 1 }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://demo.tradovateapi.com/v1/fundTransaction/adjustcash"); 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 \"cashChangeType\": \"AccountClosureFee\",\n \"currencyId\": 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, "cashChangeType": "AccountClosureFee", "currencyId": 1 ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://demo.tradovateapi.com/v1/fundTransaction/adjustcash")! 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() ```