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://stag-api.fereai.xyz/install.sh | sh

$ fere auth
$ fere chat "price of ETH on Base?"
$ fere swap --chain-in 8453 ...
44 Endpoints · 16 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://stag-api.fereai.xyz/mcp/sse"}

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

API Overview

MethodPathDescriptionAuth
GET /capabilities Capabilities —
GET /health Health —
POST /signup Signup Bearer
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/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
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
POST /credits/onchain-recharge Post Onchain Recharge Bearer
GET /credits/packs Get Credit Packs Bearer
GET /credits/recharge-chains Get Recharge Chains Bearer
GET /polymarket/activity Get Polymarket Activity Bearer
POST /polymarket/disclaimer/acknowledge Acknowledge Polymarket Disclaimer Bearer
POST /polymarket/fund-safe Polymarket Fund Safe Bearer
POST /polymarket/order Polymarket Order Bearer
POST /polymarket/order/cancel Polymarket Order Cancel Bearer
GET /polymarket/orders/open Get Polymarket Open Orders Bearer
POST /polymarket/redeem Polymarket Redeem Bearer
POST /polymarket/setup Polymarket Setup Bearer
GET /polymarket/setup/status Get Polymarket Setup Status Bearer
POST /polymarket/setup/v2 Polymarket Setup V2 Bearer
POST /polymarket/withdraw Polymarket Withdraw Bearer
PUT /disable_schedule_chats Disable Schedule Chats Bearer
GET /get_schedule_chats Get Schedule Chats Bearer
POST /schedule-chat/execution/{execution_id}/rate Rate Schedule Execution Bearer
GET /schedule-chat/list List Schedule Chats Bearer
GET /schedule-chat/schedule/{schedule_id} Get Schedule Chat Detail Bearer
POST /schedule_chat Create Schedule Chat Bearer
PUT /update_schedule_chat Update Schedule Chat Bearer
DELETE /wallet/outstanding-orders Delete Outstanding Orders Bearer
GET /wallet/outstanding-orders Get Outstanding Orders 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.3.1)
Python pip install fere-sdk (v0.3.1)
TypeScript npm i @fere/sdk (v0.3.1)