Skip to main content
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.
Terms used here: scheme, paise, bps, price floor, order, position, API key, scope, idempotency key. Full list in the terminology annexure.

Next steps

Authorizations

X-ScripX-Key
string
header
required

Your API key, e.g. scripx_live_…. Bound to one firm; tenant isolation is enforced.

Headers

Idempotency-Key
string

Safe-retry key; re-sending returns the original order.

Body

application/json
side
enum<string>
required
Available options:
sell,
buy
scheme
string
required
amount_paise
integer
required
min_pct_bps
integer

sell only: price floor in bps of face; never fills below

max_pct_bps
integer

buy only: price ceiling in bps of face; never fills above

Response

OK

order
object