Open Position
Header Parameters
Bearer token issued for your trading account.
Optional UUID that makes a retry safe.
Body Parameters
Instrument to trade.
BUY to open long, SELL to open short.
BUYSELLSize in lots. Must lie between volumeMin and volumeMax and be a multiple of volumeStep for the instrument.
Take profit price, or null for none.
Stop loss price, or null for none.
Free-text note stored with the position.
Response
Created
Response Attributes
Identifier of the newly opened position.
error://trader-api/trading-validation-failed, error://trader-api/idempotency-key-invalid
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/trading-validation-failederror://trader-api/idempotency-key-invalidA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
error://trader-api/unauthorized
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/unauthorizedA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
error://trader-api/forbidden
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/forbiddenA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
error://trader-api/symbol-not-found
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/symbol-not-foundA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
error://trader-api/trading/not-enough-margin, error://trader-api/trading/session-closed, error://trader-api/trading/not-allowed-to-trade, error://trader-api/trading-operation-failed, error://trader-api/idempotency-request-in-progress
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/trading/not-enough-marginerror://trader-api/trading/session-closederror://trader-api/trading/not-allowed-to-tradeerror://trader-api/trading-operation-failederror://trader-api/idempotency-request-in-progressA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
error://trader-api/idempotency-key-reused
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/idempotency-key-reusedA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
error://trader-api/idempotency-unavailable
Response Attributes
The request path with the actual identifiers filled in, without query parameters.
The HTTP status code, the same as the response status.
A stable identifier of the kind of error, in the form error://trader-api/{code}. Base your error handling on this field, not on title or detail.
error://trader-api/idempotency-unavailableA short, human-readable name of the error. Several types can share the same title.
A description of this particular occurrence. The wording can change, so never parse it or base logic on it.
Extra information as key-value pairs.
Response