Skip to navigation
REST API EndpointsRisks

Update Max Net Liq

View as Markdown

Update a subaccount’s Max Net Liquidity.

Available to: Organization administrators (Demo); the organization administrator who owns the subaccount (Live)

Environments: Demo, Live

Rate Limit: No endpoint-specific limit

Set a subaccount’s Max Net Liquidity (maxNetLiq). What you can set depends on the domain:

  • In Demo, an organization administrator can set maxNetLiq to any value, to configure or adjust a subaccount’s risk parameters.
  • In Live, the organization administrator who owns the subaccount can raise maxNetLiq, for the cases the automatic reset on trading-permission approval doesn’t cover.

The Live path is raise-only: a request that would lower maxNetLiq is rejected, and the current value is left unchanged. Re-sending the current value is allowed and refreshes its timestamp.

NinjaTrader enables the Live raise-only control per organization, so work with the NinjaTrader Support team to turn it on. The Demo action needs no enablement.

In Live, a rejected raise returns HTTP 200 with errorText set, not an error status. Check errorText to confirm the new value was applied.

Common Failure Scenarios

  • In Live, the requested value is below the current value. The raise is rejected and the current value is unchanged.
  • In Live, the caller doesn’t own the subaccount, the account isn’t an open subaccount, or the feature isn’t enabled for the organization. The request is denied.

Error Messages

A failed request returns one of these messages:

MessageResponseTrigger
"maxNetLiq can only be raised: current 2500.0, requested 1000.0"200 (in errorText)In Live, the requested value is below the current value. The message shows the actual current and requested values.
"Access is denied"401In Live, the caller doesn’t own the subaccount, the account isn’t an open subaccount, or the feature isn’t enabled.

Related Resources

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
accountIdlongRequired
maxNetLiqdoubleRequired

Response

AccountRiskStatusResponse
errorTextstringOptional<=8192 characters

Non-empty if the request failed

accountRiskStatusobjectOptional