> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.paradigm.co/unified-markets/o-bv-1/migrating-from-grfq/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.paradigm.co/_mcp/server.

# 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

## Docs

- [Quote Creation Workflow](https://docs.paradigm.co/unified-markets/o-bv-1/migrating-from-grfq/quote-creation-window.md)
- [Quote Cancel Workflow](https://docs.paradigm.co/unified-markets/o-bv-1/migrating-from-grfq/quote-cancel-window.md)
- [Improved \`trade\` WS Channel](https://docs.paradigm.co/unified-markets/o-bv-1/migrating-from-grfq/improved-trade-ws-channel.md)