# uatu

> DEX aggregation and swap-quote API for EVM chains.

## Docs

- [Overview](https://docs.uatu.dev/index.md): A DEX aggregation and swap-quote API for EVM chains.
- [Quickstart](https://docs.uatu.dev/quickstart.md): Go from zero to an executable swap quote.
- [Quotes](https://docs.uatu.dev/concepts/quotes.md): What a quote contains and how to execute one.
- [Catalogue](https://docs.uatu.dev/concepts/catalogue.md): Chains, tokens, DEXes and pools, and how they're discovered.
- [Supported chains](https://docs.uatu.dev/concepts/chains.md): The 18 networks in the catalogue and which DEXes are configured on each.
- [Configuration](https://docs.uatu.dev/self-hosting/configuration.md): Requirements, environment variables and how config is loaded.
- [Running](https://docs.uatu.dev/self-hosting/running.md): Migrate, seed and start the service.
- [Rate limiting](https://docs.uatu.dev/self-hosting/rate-limiting.md): Per-client budgets, and how to configure them safely behind a proxy.
- [Adding a chain](https://docs.uatu.dev/self-hosting/adding-a-chain.md): Extend the catalogue with a new EVM network.
- [Get All Blockchains](https://docs.uatu.dev/api-reference/catalogue/get-all-blockchains.md): Returns every chain the catalogue knows about, each with its embedded token and DEX definitions.
- [Get a DEX](https://docs.uatu.dev/api-reference/catalogue/get-a-dex.md): Returns the DEX seeded under the given slug on the given chain, including the router, factory, quoter and settlement addresses used to price and encode a swap. Both chainId and slug are required, as a slug identifies a DEX only within one chain.
- [Get Pools for a Chain](https://docs.uatu.dev/api-reference/catalogue/get-pools-for-a-chain.md): Returns the liquidity pools discovered by the seeder for the given chain, optionally filtered to a single DEX. Unlike the token endpoint, chainId is required here.
- [Get All Tokens](https://docs.uatu.dev/api-reference/catalogue/get-all-tokens.md): Returns the known tokens. Omit chainId to list tokens across every chain.
- [Create a Swap Quote](https://docs.uatu.dev/api-reference/quotes/create-a-swap-quote.md): Resolves the pools for a token pair on the given chain, prices the swap against each DEX's on-chain contracts concurrently, and returns the best output together with the encoded Permit2 approval and swap calldata needed to execute it. Quotes carry a 1-minute deadline and are persisted with a pending…
- [Compare DEX Routes](https://docs.uatu.dev/api-reference/quotes/compare-dex-routes.md): Prices a swap against every supported DEX and returns the valid routes ordered by output amount.

## OpenAPI Specs

- [openapi](https://docs.uatu.dev/api-reference/openapi.json)