Orderbook API

REST API for interacting with the CoW Protocol orderbook — quotes, order submission, retrieval, and cancellation

The Orderbook API is the primary interface for interacting with CoW Protocol’s order management system.

Start Here

If you are integrating rather than just looking up a schema:

• API Integration Guide — the full quote → sign → submit → monitor flow
• Quickstart: Raw API (cURL) — the most copy-pasteable raw HTTP walkthrough
• Testing Your Integration — Sepolia to barn to production rollout
• TypeScript OrderBookApi and Python OrderBookApi — SDK access to the same Orderbook workflows

Base URLs

Network	Production	Staging
Ethereum
Gnosis Chain
Arbitrum One
Base
Avalanche
Polygon
BNB
Linea
Plasma
Ink
Sepolia

Key Endpoints

Quotes

• POST /api/v1/quote — Get a price quote for a trade

POST /api/v1/quote returns the base order parameters in quote, plus quote metadata such as expiration and id. If your integration applies client-side slippage or partner fees before signing, see the API Integration Guide for the full amount-adjustment flow.

Orders

• POST /api/v1/orders — Submit a signed order
• GET /api/v1/orders/{UID} — Get order by UID
• DELETE /api/v1/orders/{UID} — Cancel an order
• GET /api/v1/account/{owner}/orders — Get orders for an account

Trades

• GET /api/v2/trades — Get paginated trades (preferred; filter by owner or orderUid)
• GET /api/v1/trades — Deprecated trades endpoint

Auction

• GET /api/v1/auction — Get the current batch auction
• GET /api/v1/solver_competition/{auction_id} — Get solver competition results

Interactive Reference

Browse the interactive Orderbook endpoint docs directly in this site under Orderbook Endpoints in the left navigation. Those pages are generated from the upstream OpenAPI specification, so users can inspect parameters, schemas, and playground requests without leaving docs.cow.bleu.builders.

If you want the most common raw API references directly, start with POST /api/v1/quote, POST /api/v1/orders, GET /api/v1/orders/{UID}, and GET /api/v2/trades.

If you need the upstream spec directly, use .

SDK Access

For programmatic access, you can use either SDK instead of calling the HTTP API directly:

• TypeScript OrderBookApi for quotes, orders, trades, and app-data endpoints
• Python OrderBookApi for the same Orderbook workflows in cow-py

For the raw HTTP flow, start with the API Integration Guide.