Skip to main content
This page tracks user-visible changes to the DEX Aggregator API. Breaking changes are flagged explicitly.

​
2026-04-30 — Public docs published

  • Initial public documentation for the DEX Aggregator API at docs.o1.exchange/api/dex-aggregator.
  • Endpoints: /quote, /submit, /execute, /health.
  • Live on Base mainnet (chain ID 8453).
  • Default rate limit: 120 requests / minute / API key.
  • Router contract: 0x8Dc736C6BA12e1Df1c73DB6BED8d7573F0aD90B3.

​
Versioning policy

The API does not use a versioned URL prefix today. We treat published behavior as stable and add fields additively whenever possible. Breaking changes will be:
  1. Pre-announced here at least two weeks before deployment.
  2. Mirrored at a versioned path (/v1/quote, /v2/quote) for the duration of the migration window.
  3. Documented with a migration note describing the old and new shapes.

​
What “breaking” means

  • Removing or renaming a field on a response.
  • Changing the type or units of an existing field.
  • Tightening a validation rule that previously accepted a value.
  • Removing or renaming an endpoint.
Adding new optional request fields, new optional response fields, or new endpoints is not breaking.

​
Subscribing to updates

If you’d like change notifications, contact the o1 team to be added to an integrator mailing list. The changelog page here is the canonical record either way.