Skip to main content
Place a spot limit order priced from the current best bid or offer, which removes the need to read the order book before quoting. The client picks the role and the engine picks the price.

​
Rate limits

​
Place BBO order

​
Request parameters

The bbo_role parameter decides which side of the spread supplies the price. Sending post_only together with bbo_role: 2 is rejected as a wrong flag combination, because a taker order cannot be post-only. With bbo_role: 1 the flag is redundant but accepted.

​
Response

The response is an ordinary limit order reporting type 1 — no BBO marker survives placement. The price field records where the order landed. See the order object reference.
No re-pegging happens. The price is resolved once, at placement, and the order then behaves like any other resting limit order as the order book moves away from it. Re-quoting requires canceling and placing again, or order_modify.

​
Error codes

Standard transport errors and the shared account, rate-limit, and region codes are listed in Order Management.