Autopilot API
The Autopilot service manages CoW Protocol’s batch auctions by collecting orders, creating auctions, distributing them to solvers, ranking solutions, and executing settlements on-chain.
Operational Flow
Autopilot operates on a recurring schedule (typically every 12-15 seconds):
- Auction Creation - Filters solvable orders from the orderbook
- Distribution - Sends auction data to registered solvers
- Ranking - Scores and evaluates solver solutions
- Execution - Instructs winning solvers to settle on-chain
- Monitoring - Validates settlements and enforces compliance rules
Primary API Endpoints
Get Current Auction
GET /api/v1/auction
Returns the active batch auction with solvable orders and reference token prices. This endpoint requires API key authorization.
Get Native Price
GET /native_price/{token}
Internal API for retrieving cached token prices, used by CoW Protocol services.
Solver Integration Requirements
Solvers must implement four endpoints:
/solve - Receives auction data and returns potential solutions/reveal - Provides transaction calldata for verification purposes/settle - Executes the winning solution on-chain/notify - Handles outcome notifications (bans, violations)
Scoring Methodology
Solutions are ranked using:
User Surplus + Protocol Fees - Gas Cost (in native token)
Solver Types
Colocated
External teams manage their own infrastructure and settlement.
Non-Colocated
CoW Protocol operates the driver with external solver APIs (1inch, 0x, Balancer).Last modified on March 4, 2026
