# FereAI Gateway

> Unified API for AI-powered crypto trading and research across
> Ethereum, Base, Arbitrum, BNB, and Solana.
> Includes fully gasless cross-chain swaps with built-in bridging —
> the most complete swap primitive in the industry.
> Base URL: https://api.fereai.xyz
> No SDK required — use any HTTP client.

Auth uses Ed25519 keypairs. CLI and SDKs handle auth automatically.

## Install (recommended)

curl -fsSL https://api.fereai.xyz/install.sh | sh

## Documentation

- CLI Reference: https://api.fereai.xyz/cli
- Skill File: https://api.fereai.xyz/skill.md
- OpenAPI Spec: https://api.fereai.xyz/openapi.json
- Interactive Docs: https://api.fereai.xyz/docs
- Capabilities: https://api.fereai.xyz/capabilities
- MCP: https://api.fereai.xyz/mcp

Wait-mode query `timeout` is 5–90 seconds (REST default 60; SDK/CLI/MCP
default 90). Values above 90 return 422. MCP write tools wait up to 90s;
do not pass a timeout. Poll GET /v1/tasks/{task_id} for longer waits.

## CLI & SDKs

- CLI (fere-cli v0.4.0): curl -fsSL https://api.fereai.xyz/install.sh | sh  (or: pip install fere-cli)
- Python (fere-sdk v0.6.0): pip install fere-sdk
- TypeScript (@fereai/sdk v0.6.0): npm i @fereai/sdk

## SDKs (Optional)

- Python (fere-sdk v0.6.0): pip install fere-sdk
- TypeScript (@fereai/sdk v0.6.0): npm i @fereai/sdk

## Quick Reference

- Health: https://api.fereai.xyz/health
- Chains: https://api.fereai.xyz/v1/chains