FereAI Gateway
CLI /docs

Unified API for AI-Powered Crypto

Trading and research across Ethereum, Base, Arbitrum, BNB, and Solana.

Install CLI SDKs AI Agents
$ curl -fsSL https://api.fereai.xyz/install.sh | sh

$ fere auth
$ fere chat "price of ETH on Base?"
$ fere swap --chain-in 8453 ...
27 Endpoints · 10 MCP Tools · 5 Chains · 4 Protocols (REST, SSE, WebSocket, MCP)

Quick Start

pip install fere-sdk

client = await FereClient.create("my-bot")
result = await client.swap(
chain_id_in=8453,
chain_id_out=8453,
token_in="0xEeee...EEeE",
token_out="0x8335...2913",

For AI Agents

Read /skill.md — complete API reference for agents.

MCP: SSE transport. Add to your MCP config:

{"url": "https://api.fereai.xyz/mcp/sse"}

/skill.md · /llms.txt · /openapi.json

API Overview

MethodPathDescriptionAuth
GET /capabilities Capabilities —
GET /health Health —
POST /v1/auth/register Register —
POST /v1/auth/token Token —
POST /v1/auth/verify Verify —
GET /v1/chains Get Supported Chains —
POST /v1/chat Create Chat Sse Bearer
GET /v1/chat/threads List Threads Bearer
GET /v1/chat/threads/{thread_id} Get Thread Bearer
GET /v1/credits Get Credits Bearer
POST /v1/credits/claim-daily Claim Daily Credits Bearer
GET /v1/earn Get Earn Info Bearer
POST /v1/earn/deposit Deposit Bearer
GET /v1/earn/positions Get Positions Bearer
POST /v1/earn/withdraw Withdraw Bearer
POST /v1/hooks Set Hooks Bearer
GET /v1/limit-orders List Limit Orders Bearer
POST /v1/limit-orders Create Limit Order Bearer
DELETE /v1/limit-orders/{order_id} Cancel Limit Order Bearer
GET /v1/limit-orders/{order_id} Get Limit Order Bearer
GET /v1/notifications Get Notifications Bearer
GET /v1/notifications/stream Notifications Stream Bearer
POST /v1/swap Create Swap Bearer
GET /v1/tasks/{task_id} Get Task Status Bearer
GET /v1/user Get User Bearer
GET /v1/holdings Get Holdings Bearer
GET /v1/wallets Get Wallets Bearer

Capabilities

Chat SSE + WebSocket, threads
Trading Swap, limit orders, hooks
Earn Deposit, withdraw, positions
Wallets EVM + Solana, auto-provisioned
Notifications REST + SSE stream

Authentication

Ed25519 keypair → POST /v1/auth/register → verify → token. Use Authorization: Bearer <token>. SDKs handle this automatically.

SDKs & CLI

CLI pip install fere-cli (v0.2.3)
Python pip install fere-sdk (v0.2.2)
TypeScript npm i @fere/sdk (v0.2.1)