# freaky.fi

> Compare swap rates across 10+ DEX aggregators. Non-custodial token swaps with Permit2 security, exact approvals, and multi-chain support.

## Documentation

### General

- [Supported Aggregators](https://freaky.fi/docs/aggregators): The 10 DEX aggregators freaky.fi queries on every swap.
- [Command Line Interface](https://freaky.fi/docs/cli): Get swap quotes and trade directly from your terminal. Same 10 aggregators, same best rate.
- [FAQ](https://freaky.fi/docs/faq): How freaky.fi works, fees, security, supported chains, wallets, and why comparing quotes across aggregators gets you better trades.
- [Fees](https://freaky.fi/docs/fees): freaky.fi charges zero fees. The quote you see is what arrives in your wallet. Here's where costs come from and how to minimize them.
- [Getting Started](https://freaky.fi/docs/getting-started): Swap tokens on freaky.fi in under a minute. Connect wallet, pick tokens, compare rates, confirm.
- [What is freaky.fi](https://freaky.fi/docs/): freaky.fi queries 10 DEX aggregators at once, compares rates, and connects your wallet directly to the winner's contracts. No fees, no middleman.
- [Support](https://freaky.fi/docs/support): Questions, bugs, feature requests, chain listing requests - email hi@freaky.fi. We reply to every message.
- [Supported Chains](https://freaky.fi/docs/supported-chains): 26+ EVM chains including Ethereum, Arbitrum, Base, Optimism, Polygon, and BSC.
- [Swap History](https://freaky.fi/docs/swap-history): Every swap across every chain, tracked in one place. Volume, transaction details, and aggregator used - all at freaky.fi/history.
- [Token List](https://freaky.fi/docs/token-list): Swap any token on a supported DEX. The default list aggregates CoinGecko, 1inch, KyberSwap, and OpenOcean. Paste any contract address for unlisted tokens.
- [Integrations](https://freaky.fi/docs/integrations): Deeplinks, embeddable widget, referral links, and a beta API for integrating with freaky.fi.
- [Security](https://freaky.fi/docs/security): How freaky.fi handles token approvals and custody. No middleman contract, exact approvals, and time-bound Permit2 signatures.

### Integrations

- [API](https://freaky.fi/docs/integrations/api): Public API for ranking swap quotes and executing trades across all supported aggregators.
- [Deeplinks](https://freaky.fi/docs/integrations/deeplinks): Link directly to freaky.fi with pre-filled swap parameters via URL query strings.
- [llms.txt](https://freaky.fi/docs/integrations/llms-txt): Discovery file for AI agents browsing freaky.fi.
- [MCP](https://freaky.fi/docs/integrations/mcp): Use freaky.fi from AI assistants via the Model Context Protocol.
- [Referrals](https://freaky.fi/docs/integrations/referrals): Share freaky.fi with a referral link. All referral activity is tracked on-chain. Referral dashboard coming soon.
- [Swap Widget](https://freaky.fi/docs/integrations/widget): Embed the freaky.fi swap execution interface on your site via iframe or link to it directly.

### Security

- [Exact Approvals](https://freaky.fi/docs/security/exact-approvals): When Permit2 isn't available, freaky.fi approves the exact swap amount - never unlimited. A safer fallback until full Permit2 coverage.
- [Permit2](https://freaky.fi/docs/security/permit2): How Permit2 replaces persistent token approvals with time-bound, signature-based permissions that expire automatically.

## Public APIs

- [Swap API](https://swap.freaky.fi): Quote ranking and swap execution across all aggregators. OpenAPI at `swap.freaky.fi/doc`, Scalar UI at `swap.freaky.fi/docs`.
- [Prices API](https://prices.freaky.fi): USD prices for tokens by chain and address.
- [Token List API](https://list.freaky.fi): Chain and token lists. `/chains/evm` for popular chains (add `?onlyPopular=false` for the full supported set), `/tokens/evm/{chainId}` for tokens on a chain.
- [API overview](https://freaky.fi/docs/integrations/api): Higher-level walkthrough of the public APIs (beta).

## MCP and plugins for agents

- [mcp.freaky.fi](https://mcp.freaky.fi/): Index of agent-facing specs.
- [Base MCP plugin](https://mcp.freaky.fi/base/freaky.md): If you have Base MCP installed (or any wallet that supports atomic batch transactions), use this plugin to orchestrate swaps via `send_calls`. The user approves once; approve and swap execute atomically.
- Otherwise, if you have a private key or a connected wallet, call `swap.freaky.fi/rank` directly and sign and broadcast the returned transaction yourself. See `swap.freaky.fi/docs` for the full API surface.

## Integrations

- [Deeplinks](https://freaky.fi/docs/integrations/deeplinks): Link directly to freaky.fi with pre-filled swap parameters via URL query strings.
- [Referrals](https://freaky.fi/docs/integrations/referrals): Share freaky.fi with a referral link using your wallet address or a custom name.

## Contact

- [Support](mailto:hi@freaky.fi): hi@freaky.fi