API

freaky.fi exposes a public API for ranking swap quotes across every supported aggregator and executing the resulting transactions. The API is in beta and shapes may change.

Discovery

freaky.fi/llms.txt indexes every public endpoint, the MCP plugin install URL, and the documentation pages. It is the fastest way for an AI assistant to learn what is available. Ask your assistant to read it, or fetch it directly.

Endpoints

• swap.freaky.fi - quote ranking and swap execution. OpenAPI at swap.freaky.fi/doc, Scalar UI at swap.freaky.fi/docs.
• prices.freaky.fi - USD prices for tokens by chain and address.
• list.freaky.fi - supported chain and token lists.

AI assistants and agentic workflows

If your assistant has Base MCP installed and you have a Base Account, install the freaky.fi plugin at mcp.freaky.fi/base/freaky.md to orchestrate swaps via send_calls. See MCP.

If you have a different wallet, call swap.freaky.fi/rank directly and sign the returned transaction yourself.

Support

[email protected] for bug reports and integration questions.