Order Management
Create Order
Place new trading orders on the Roxom platform
POST
Create Order
Place a new trading order with various order types and execution options.Endpoint
Parameters
API key for authentication. Format:
your_api_key_hereRequest Body
Trading instrument symbol (e.g., “OIL-BTC”)
Instrument type: “perpetual”
Order side: “buy” or “sell”
Order type: “market”, “limit”, “stop”, “stoplimit”
Order quantity as decimal string
Order price as decimal string (required for limit and stoplimit orders)
Stop trigger price as decimal string (required for stop and stoplimit orders)
Time in force: “gtc” (Good Till Canceled), “ioc” (Immediate or Cancel), “gtd” (Good Till Date)
Price unit: “sats” or “btc”
Cancel timestamp in milliseconds (for GTD orders)
Example Requests
Response
Order creation response
Order Validation
Before placing orders, ensure they meet symbol requirements:Price Validation
Price Validation
For LIMIT and STOP_LIMIT orders:
- Price must be within min/max range
- Price must be divisible by tick size
- For BUY orders: price ≤ current ask × 1.1
- For SELL orders: price ≥ current bid × 0.9
Quantity Validation
Quantity Validation
For all orders:
- Quantity must be within min/max range
- Quantity must be divisible by step size
- Notional value (price × quantity) must exceed minimum
Balance Requirements
Balance Requirements
For order placement:
- BUY orders: require sufficient quote asset balance
- SELL orders: require sufficient base asset balance
- Margin orders: require sufficient margin available
Error Handling
Insufficient Balance
Insufficient Balance
Invalid Price
Invalid Price
Market Closed
Market Closed
Best Practices
Order Size Strategy
Order Size Strategy
- Small Orders: Execute faster with less market impact
- Large Orders: Consider breaking into smaller chunks
- Iceberg Orders: Hide large order sizes from the market
Price Selection
Price Selection
- Limit Orders: Set competitive prices for better fill rates
- Market Orders: Use for immediate execution, accept slippage
- Stop Orders: Set appropriate buffer from current price
Risk Management
Risk Management
- Always set stop losses for positions
- Use position sizing appropriate for your risk tolerance
- Monitor order status and market conditions