Calculate Plan Upgrade

POST

https://live.tradovateapi.com/v1/user/calculateplanupgrade

POST

/v1/user/calculateplanupgrade

curl -X POST https://live.tradovateapi.com/v1/user/calculateplanupgrade \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "tradovateSubscriptionPlanId": 1
}'

200Successful

{
  "startDate": {
    "year": 1,
    "month": 1,
    "day": 1
  },
  "expirationDate": {
    "year": 1,
    "month": 1,
    "day": 1
  },
  "errorText": "string",
  "errorCode": "ConflictWithExisting",
  "estimatedAmount": 1.1,
  "current": {
    "userId": 1,
    "timestamp": "2024-01-15T09:30:00Z",
    "planPrice": 1.1,
    "tradovateSubscriptionPlanId": 1,
    "startDate": {
      "year": 1,
      "month": 1,
      "day": 1
    },
    "expirationDate": {
      "year": 1,
      "month": 1,
      "day": 1
    },
    "paidAmount": 1.1,
    "id": 1,
    "cashBalanceLogId": 1,
    "accountId": 1,
    "cancelledRenewal": true,
    "cancelReason": "string"
  },
  "refund": 1.1
}

Calculate the cost of upgrading to a different subscription plan.

Available to: All authenticated users

Environments: Live

Rate Limit: No endpoint-specific limit

Preview what switching the calling user’s Tradovate subscription to another plan would cost before committing to the change. This is a read-only calculation — it doesn’t modify the subscription or charge anything.

The response returns:

estimatedAmount — the new plan’s price minus any prorated refund for the unused portion of the current plan
refund — the prorated credit from the current plan, when one applies
current — the user’s current subscription
startDate and expirationDate — the period the new plan would cover

Field Details

The tradovateSubscriptionPlanId identifies the target plan. Use the /tradovateSubscriptionPlan/list endpoint to retrieve available plan IDs.

The calculation applies to the authenticated user’s own subscription.

Common Failure Scenarios

Target plan doesn’t exist or isn’t available
Target plan is the user’s current plan
Target plan is a trial and the user already had one, or has an active live account
Switch would be a downgrade, which isn’t allowed through this flow

Error Messages

`errorText`	Trigger
`"Membership plan is not available."`	`tradovateSubscriptionPlanId` doesn’t match an available plan
`"Switch to the same plan is not allowed. Your membership will be renewed at the end of period"`	Target plan is the current plan (`errorCode: ConflictWithExisting`)
`"Gap between subscriptions are not allowed"`	Current subscription expires before the upgrade would start (`errorCode: ConflictWithExisting`)
`"Trial with active live account is not allowed"`	Target is a free trial plan and the user has an active live account (`errorCode: SingleTrialOnly`)
`"Only one trial is allowed"`	Target is a free trial plan and the user already had a trial (`errorCode: SingleTrialOnly`)
`"Cannot downgrade from Lifetime plan"`	Current plan is a lifetime membership (`errorCode: DowngradeNotAllowed`)
`"Please contact Customer Service about downgrading the plan"`	New plan’s price minus the refund is negative (`errorCode: DowngradeNotAllowed`)

Related Endpoints

Use addTradovateSubscription to apply a plan change after previewing the cost.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

tradovateSubscriptionPlanIdlongRequired

Response

PlanUpgradeResponse

startDateobject

expirationDateobject

errorTextstringOptional<=8192 characters

Non-empty if the request failed

errorCodeenumOptional

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

estimatedAmountdoubleOptional

currentobjectOptional

refunddoubleOptional