Skip to main content

API rate limits

The CoW Protocol API at api.cow.fi is free to use within the limits below. Quotes and prices have the tightest limits because each one asks solvers to search for a route.

Limits​

Limits apply per IP address, across all networks combined.

EndpointsLimit
Quotes and prices: POST /api/v1/quote, POST /api/v1/quote/stream, GET /api/v1/token/{token}/native_price1 per second, and 500 per hour
Everything else5 per second

Both quote limits apply: you can send up to 1 request per second, but no more than 500 in any hour.

x402 limits​

x402 at x402.cow.fi has its own limits, also per IP address:

Endpoints on x402.cow.fiLimit
Paid quotes10 per second
Everything else5 per second

There is no hourly cap on x402. POST /api/v1/quote/stream is not available on x402.

If you go over a limit​

You get 429 Too Many Requests with a Retry-After header. Wait that long, then retry with exponential backoff. Clients that keep sending far above their limit are blocked for an hour.

Fair use​

  • Request a quote when the user changes the trade, then refresh it at most every 30 seconds while it is on screen.
  • Don't use quotes as a price feed or for analytics.
  • Poll order status at most every 2 seconds, and stop once the order is filled, cancelled or expired.
  • Don't spread requests across IP addresses to get around the limits.
  • Set your appCode in the order's app data so we can recognise your integration.

Need higher limits?​

  • Pay per quote with x402: no sign-up or API key, and no hourly cap.
  • Partner API: for integrations routing more than $1M a month in trading volume through CoW Protocol. Contact @MooKeeper on the CoW Protocol Discord.

We don't raise limits on the public API. We may change these limits; this page always shows the current ones.