Migrating from GRFQ
Relationship with GRFQv1
Complex Order Books are an incremental update to GRFQv1 workflows.
- In GRFQv1, Order Book API operations are synchronous
- Quote responses contain the current state of the Quote. If the quote crossed another quote, that status is included in the API response
- If there is an error in the Quote creation process, those errors are returned in the API response.
With OBv1, we move to a more common trading workflow, in which order book operations are asynchronous with API requests:
- In OBv1, Order Book API operations are asynchronous
- When creating a Quote, the Quote initially enters a
PENDING
status, and only the initial values are echoed back, along with a Paradigm-generated Quote ID. - Matching occurs asynchronously to the API request, and any Order Book operations, or Order Book validation failures (e.g., Taker Limits) are returned to the user via WebSockets
- Non-Order Book validations (e.g., authentication, price bands, or quantity validation) still occur synchronously with API processing, and are returned immediately in API response