Create Account Lockout
Lock an account for a specified duration.
Available to: All authenticated users (own account only)
Environments: Demo
Rate Limit: No endpoint-specific limit
Traders can voluntarily lock themselves out of trading on a specific account for a set period. This helps traders protect their progress, whether that means locking in a winning day or stepping away before losses deepen.
- Traders can’t cancel their own lockouts. Once activated, the lockout stays in effect until it expires or an organization administrator manually unlocks it.
- Account-level lockout. Only the specified account is locked. Other accounts belonging to the same user are not affected.
- Closes positions and blocks orders. When a trader activates a lockout, open positions on the account are liquidated and new orders are rejected until the lockout expires.
Common Failure Scenarios
- The caller doesn’t own the account (organization administrators can’t create lockouts)
- The user’s organization doesn’t have the Tradovate Prop entitlement
- The account already has an active lockout
- The account doesn’t exist
- The
durationMinutesvalue is 0
All responses return HTTP 200. Errors are indicated by ok: false and an errorText field in the response body.
Error Messages
Related Endpoints
- Use
accountLockoutStatusto check whether accounts are currently locked - Use
expireAccountLockoutto unlock a single account early (organization administrators only) - Use
expireAllAccountLockoutsto unlock all accounts for a user (organization administrators only)
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
accountId
durationMinutes
Response
AccountLockoutResponse
errorText
Non-empty if the request failed
ok