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 remote MCP connector URL, the Base 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 across every supported aggregator. Key routes: POST /rank for ranked quotes, plus /swap/prepare, /swap/relay, /swap/assemble, and /swap/status for execution scaffolding.

• OpenAPI spec: swap.freaky.fi/doc
• Scalar UI: swap.freaky.fi/docs

list.freaky.fi

Supported chains and per-chain token lists.

• OpenAPI spec: list.freaky.fi/doc
• Scalar UI: list.freaky.fi/docs

Key routes: GET /chains/evm for popular EVM chains (append ?onlyPopular=false for the full supported set), and GET /tokens/evm/{chainId} for the token list of a given chain as an address -> token mapping.

prices.freaky.fi

USD prices for tokens by chain and address.

• OpenAPI spec: prices.freaky.fi/doc
• Scalar UI: prices.freaky.fi/docs

Key route: GET /evm/{chainId}/{tokenAddress} returns { price }. Use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native tokens. Append ?metadata=true to include provider and cache details.

AI assistants and agentic workflows

The fastest path for AI assistants is the remote MCP server at https://mcp.freaky.fi. Added as a custom connector in Claude.ai, ChatGPT, or Cursor, it exposes read-only tools for ranked quotes, prices, balances, history, and widget link building. Each get_quotes response also carries a one-click widgetUrl for execution.

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

hi@freaky.fi for bug reports and integration questions.