Place an order
Quotes & orders
Place an order
Place a duty credit scrip sell or buy order on ScripX with a price floor in bps of face and safe retries via the Idempotency-Key header.
POST
Place an order
Submits a sell or buy order for matching. Requires the
orders:write scope. Returns 201 with the created order.
Send an Idempotency-Key header on every call: re-sending the same key returns the original order, so a network timeout never becomes a duplicate trade.
Request example
side, scheme and amount_paise are required. Your limit is structural, not advisory: a sell carries min_pct_bps, the floor it never fills below; a buy carries max_pct_bps, the ceiling it never fills above.
Response example
Errors
401/403/429, the standard auth errors.422 unprocessable, invalid side, scheme or amount.
Next steps
- Get the order, or positions for the whole book.
- Register a webhook for
order.matched.
Authorizations
Your API key, e.g. scripx_live_…. Bound to one firm; tenant isolation is enforced.
Headers
Safe-retry key; re-sending returns the original order.
Body
application/json
Response
OK