Skip to content

docs: publish API rate limits and fair use policy - #687

Draft
ahhda wants to merge 2 commits into
mainfrom
anuj/api-rate-limits
Draft

ahhda wants to merge 2 commits into
mainfrom
anuj/api-rate-limits

Conversation

@ahhda

@ahhda ahhda commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Adds an API rate limits page under Integrate (docs/cow-protocol/integrate/rate-limits.mdx): per-IP limits for api.cow.fi, what happens when a client goes over, fair-use guidance, and the ways to get higher limits (x402, Partner API).
  • Replaces the rate-limit numbers on the API integration page (10/s quotes, 5/s orders, 100/min other), which don't match anything we run, with a link to the new page.
Endpoints Limit per IP
Quotes and prices (/quote, /quote/stream, /token/{token}/native_price) 1 per second, and 500 per hour
Everything else 5 per second

The page also lists the x402 limits on x402.cow.fi, per IP: 10 per second for paid quotes and 5 per second for everything else, with no hourly cap.

Before merging

Opened as a draft. Production enforcement doesn't match these numbers yet. Merge once the WAF and ingress rules enforce the published limits and return 429 with Retry-After, so the page describes what clients will actually see.

Checks

  • Both pages compile with @mdx-js/mdx. I didn't run a full docusaurus build.

https://claude.ai/code/session_014YSC23Lch5wiP21JWkizpn

Add an "API rate limits" page under Integrate with per-IP limits for
api.cow.fi (quotes and prices: 1 per second and 500 per hour; everything
else: 5 per second), fair-use guidance, and the ways to get higher limits
(x402 and the Partner API).

Replace the outdated rate-limit numbers on the API integration page with a
link to the new page.

Claude-Session: https://claude.ai/code/session_014YSC23Lch5wiP21JWkizpn
@vercel

vercel Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Nov 12, 2026 8:14pm UTC

Request Review

@coderabbitai

coderabbitai Bot commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Document the per-IP limits on x402.cow.fi: 10 per second for paid quotes
and 5 per second for everything else, with no hourly cap. Note that
quote streaming is not available on x402.

Claude-Session: https://claude.ai/code/session_014YSC23Lch5wiP21JWkizpn

This branch was successfully deployed

1 active deployment
Preview — 968af7db Deployed Nov 12, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant