Users

Cancel Tradovate Subscription

Cancel a Tradovate Trader membership plan.

Available to: All authenticated users

Environments: Live

Rate Limit: No endpoint-specific limit

Cancels a user's Tradovate Trader membership subscription. Identify the subscription with tradovateSubscriptionId (the integer entity ID). Optionally provide a cancelReason for record-keeping, and set expire to control whether the subscription is canceled immediately or allowed to lapse at the end of its current period.

This is a Live-only endpoint; calling it on Demo returns an environment error directing you to the Live host. The request is forwarded to the license service, which performs the cancellation and returns the result.

On success, the response returns the updated tradovateSubscription with an empty errorText. On a handled failure, the response carries a non-empty errorText (and may include an errorCode) describing the problem.

Common Failure Scenarios

  • The endpoint is called on Demo rather than Live (returns an environment error).
  • The tradovateSubscriptionId doesn't exist or isn't accessible to the caller.
  • The license service is unavailable or returns an error during cancellation.
  • The access token is missing or invalid (returns HTTP 401).

Error Messages

errorTextTrigger
"This endpoint should be called on live.tradovateapi.com"The request was sent to the Demo host.
Non-empty errorTextThe request failed; the field describes the reason.
post/user/canceltradovatesubscription

Request

  • Base URL: https://demo.tradovateapi.com/v1
  • URL: https://demo.tradovateapi.com/v1/user/canceltradovatesubscription
  • Auth: HTTP bearer

Request body

tradovateSubscriptionIdinteger required
cancelReasonstring
expireboolean

Response

TradovateSubscriptionResponse

errorTextstring

Non-empty if the request failed

errorCode'ConflictWithExisting' | 'DowngradeNotAllowed' | 'IncompatibleCMEMarketDataSubscriptionPlans' | 'IncorrectPaymentMethod' | 'InsufficientFunds' | 'PaymentProviderError' | 'PlanDiscontinued' | 'SingleTrialOnly' | 'Success' | 'UnknownError'

ConflictWithExisting, DowngradeNotAllowed, IncompatibleCMEMarketDataSubscriptionPlans, IncorrectPaymentMethod, InsufficientFunds, PaymentProviderError, PlanDiscontinued, SingleTrialOnly, Success, UnknownError

Changes

No recorded changes to this operation across all 1 revision of this API.