Skip to main content

What you are doing

This is the main place call: you send one or more orders to /session/v2/place. The sample body shows the usual case—resting a new offer on the board.

When orderType is post

  • Use post when you want your risk to sit on the book until another user matches you (or you cancel).
  • If you want to immediately take existing liquidity, use the same endpoint with orderType set to anything other than post (e.g. limit).
  • Orders settle in coins or cash depending on your account’s current player mode — see Place coins orders and Switch player mode.

Request body (field by field)

Example response

  • createdSessions — one entry per submitted order.
  • matched — instant fills (usually empty for a pure post).
  • unmatched — what is still live: use orderID with Cancel order / Look up single order; offered / remaining show how much risk is still working.
Replace sample ids and side with values from your environment before expecting a real fill.

Request

POST https://api.4cx.io/session/v2/place POST
Headers: Authorization, Content-Type: application/json