# Freed Finance — AI Agent Discovery

> Freed Finance is the world's first DeFi SuperApp with 21-chain support
> (19 EVM + Solana + Bitcoin). Self-custodial portfolio management, gasless
> swaps, perpetual futures, synthetic stocks, AI-powered yields, and Visa
> card spending. Use the MCP server for tool discovery; see
> /.well-known/mcp.json.

## Full Reference
For the complete AI agent reference (all 33 tools, API endpoints, setup
guides, and security architecture), see: https://freed.finance/llms-full.txt

## What Freed Finance Does
Freed Finance is a non-custodial DeFi SuperApp that provides:
- Multi-chain portfolio management (19 EVM chains + Solana + Bitcoin)
- Gasless cross-chain token swaps via 7 DEX aggregators (Relay, Jupiter, 0x)
- Lending across 6 protocols (Aave V3, Morpho, Compound, Kamino, MarginFi, Solend)
- Perpetual futures trading via Hyperliquid DEX (up to 50x leverage)
- Synthetic stocks (xStocks) — trade AAPL, TSLA, NVDA 24/7 via CoW Protocol
- AI agent wallets with Turnkey infrastructure and spending policies
- FreedShield wallet security scanner with gasless approval revocation
- Real-time oracle data (OHLCV, RSI, MACD, Bollinger Bands, Fear & Greed Index)
- Visa card spending from crypto portfolio

## Available API Endpoints
Base URL: https://freed.finance/api

### Portfolio
- GET /api/portfolio/aggregate?address={addr} — Full multi-chain portfolio
- GET /api/activity?address={addr} — Transaction history

### Trading
- POST /api/swap/quote — Get gasless swap quote across DEX aggregators
- POST /api/swap/execute — Execute approved gasless swap
- GET /api/tokens/prices — Current token prices

### Oracle
- GET /api/oracle/candles?pair={pair}&interval={interval} — OHLCV data
- GET /api/oracle/indicators?pair={pair} — Technical indicators (RSI, MACD, BB)
- GET /api/market/fear-greed — Fear & Greed Index

### Lending
- GET /api/lending/markets — Available lending markets
- GET /api/lending/positions?address={addr} — User lending positions

### Perpetual Futures
- GET /api/perps/markets — Hyperliquid markets
- GET /api/perps/funding — Real-time funding rates

### Security
- POST /api/shield/scan — Scan wallet for risky approvals
- POST /api/shield/revoke — Gasless approval revocation

### Agent
- POST /api/chat — Chat with Freed AI agent
- GET /api/agents/status — Agent swarm status

## MCP Server
Freed Finance exposes an MCP (Model Context Protocol) server with 33 tools
and 3 AI skill playbooks. Compatible with Cursor, VS Code, Claude Desktop,
Windsurf, Antigravity (Google DeepMind), and OpenClaw.

MCP discovery: https://freed.finance/.well-known/mcp.json
MCP server card: https://freed.finance/.well-known/mcp/server-card.json

## SDK
TypeScript SDK with 80+ functions, 60+ types, covering all capabilities.
SDK access is currently invite-only — request access at
https://freed.finance/waitlist

## AI Skills
3 downloadable skill playbooks for AI agents:
- Freed Finance API (33 tools)
- Market Analyst (12 tools)
- Risk Manager (8 tools)
Skills index: https://freed.finance/.well-known/agent-skills/index.json

## Authentication
API Key: Bearer freed_pk_live_...
API access is invite-only during the current phase — request access at
https://freed.finance/waitlist

## Supported Chains
Ethereum, Polygon, Arbitrum, Base, Optimism, Avalanche, BNB Chain, Fantom,
zkSync Era, Linea, Ink, Zora, Sonic, Abstract, Blast, Gnosis, FlowMainnet,
Lisk, Polygon zkEVM, Solana, Bitcoin

## Machine-Readable Discovery
- AI manifest: https://freed.finance/.well-known/ai.json
- MCP manifest: https://freed.finance/.well-known/mcp.json
- OpenAPI spec: https://freed.finance/api/openapi
- Sitemap: https://freed.finance/sitemap.xml

## Contact
Website: https://freed.finance
X/Twitter: @freed_finance
Discord: https://discord.gg/uhChTk3C
Founder: @octavianlojnita