# 3Route

> Best-priced crypto swaps for agents, traders, and apps. 3Route aggregates DEX liquidity to return competitive quotes and swap transactions ready to sign and execute. No API key or subscription required: token discovery is free, and quote and swap endpoints require payment via x402 or MPP.

The API origin is `https://api.3route.io`. This site, `https://3route.io`, carries the product pages, agent skill, and this index.

Start with the agent skill for the operational workflow and safety requirements. Use the OpenAPI document as the canonical contract for operations, parameters, schemas, prices, and payment methods. Discover supported chains from `components.parameters.chainId.schema.enum` and token addresses and decimals from the token endpoints.

Health, OpenAPI, and token discovery endpoints are free. Quote and swap endpoints are paid. Base provides current-state, exact-input routing; Pro adds exact-output trades and historical state. Swap responses contain unsigned transactions, not proof of execution. Payments, token approvals, signing, and broadcasting require user authorization; follow the agent skill before performing them.

## Documentation

- [OpenAPI contract](https://api.3route.io/openapi.json): Current operations, parameters, schemas, prices, and accepted x402/MPP payment methods.
- [Agent skill](https://3route.io/SKILL.md): Discovery and caching, Base vs Pro selection, token amounts, payment selection, transaction validation, and failure handling. Read it before planning calls.
- [API reference](https://api.3route.io/): Human-readable rendering of the live contract.
- [Service health](https://api.3route.io/health): Liveness response.

## Payments

- [Etherlink payment skill](https://dev.agents.bakingbad.dev/skills/x402-etherlink/SKILL.md): Required when paying on `eip155:42793`. Payment networks are independent of the chain being swapped on. Download and verification instructions are in the 3Route agent skill.

## Optional

- [3Route](https://3route.io): Product site and swap interface.
- [Baking Bad](https://bakingbad.dev): Builder of 3Route.
- [Email](mailto:hello@bakingbad.dev): Product and integration contact.