Place Order

post

https://api.osl.com/openapi/v1/order

Submit a spot order

Notes:

When newOrderRespType is set to RESULT,
- MARKET orders return the execution result directly.
- LIMIT orders used with special timeInForce values return the execution result or expiry rejection result directly.
Either quantity or amount must be provided. When amount is provided, the system converts it into quantity based on price and rounds up to an integer multiple of the step size.

Body Params

Place order request

category

string

required

Trading type. Use SPOT.

symbol

string

required

Symbol

side

string

enum

required

Side: BUY/SELL

Allowed:

type

string

enum

required

Order type: LIMIT/MARKET

Allowed:

newClientOrderId

string

Client custom order ID. Only [a-zA-Z0-9-_] is supported. If omitted, a UUID is generated automatically.

timeInForce

string

enum

Time in force: GTC/FOK/IOC/POST_ONLY. Default: GTC. Required for LIMIT orders.

Allowed:

quantity

number

Quantity. Either this or amount must be provided.

price

number

Price. Required for LIMIT orders; must not be provided for MARKET orders.

newOrderRespType

string

enum

Response type: ACK/RESULT. Default: ACK.

Allowed:

selfTradePreventionMode

string

enum

Self-trade prevention mode: EXPIRE_TAKER/EXPIRE_MAKER/EXPIRE_BOTH. Default: EXPIRE_TAKER.

Allowed:

amount

number

Notional value. Either this or quantity must be provided. When amount is provided, the system converts it into quantity based on price and rounds up to an integer multiple of the step size.

Response

200Order placed successfully