Contract Error Codes

This page documents the specific error codes (anomaly keywords) returned by the BigONE Contract OpenAPI (/api/contract/v2/).

Error Response Format

Errors in the Contract API return a 400 or 403 HTTP status code with the following JSON structure:

{
  "anomaly": "anomaly.order/price-out-of-range"
}

The anomaly field contains a keyword identifying the specific business logic error.

Anomaly Keyword	Description
`anomaly.trades/stopped`	Trading is suspended for the platform.
`anomaly.trades/suspended`	Trading is suspended for the specific instrument.

Anomaly Keyword	Description
`anomaly.order/price-out-of-range`	Order price is beyond the allowed price limits.
`anomaly.open-order/price-invalid-loss`	Stop loss price is invalid for the current market conditions.
`anomaly.open-order/price-invalid-profit`	Take profit price is invalid for the current market conditions.
`anomaly.request/invalid-params`	One or more request parameters are malformed or invalid.

Anomaly Keyword	Description
`anomaly.close-position/position-not-found`	Attempted to close a position that does not exist.
`anomaly.adjust-margin/invalid-lerverage`	The requested leverage adjustment is invalid.
`anomaly.adjust-margin/position-too-large`	The position size exceeds the allowed limit for the requested margin.
`anomaly.limit-risk/position-too-large`	The position size exceeds the risk limit.
`anomaly.adjust-risk-limit/too-small-or-too-large`	Risk limit adjustment value is out of allowed range.