# Epsilon Developers

> Epsilon is a trading platform on Robinhood Chain with advanced order types (limit, stop loss, DCA, trailing stop) for memecoins and RWAs. This site documents the developer platform: a keyed REST API and MCP servers for AI agents.

Verbose single-file version with inline code examples (for large context windows): https://developers.epsilon.exchange/llms-full.txt
Agent index with code-generation rules (AGENTS.md): https://developers.epsilon.exchange/AGENTS.md

Key facts:

- REST API base URL: https://api.epsilon.exchange (all endpoints under /v1)
- Authentication: API key with `eps_` prefix, sent as `X-API-Key` or `Authorization: Bearer`
- Chain: Robinhood Chain, id 4663; live contract addresses at GET /v1/config (no key)
- OpenAPI spec: https://developers.epsilon.exchange/openapi.json (also served live at /v1/openapi.json)
- Hosted MCP server (read-only, Streamable HTTP): https://api.epsilon.exchange/mcp — docs tools (search_docs, list_examples, get_example) need NO key; market tools take X-API-Key
- Local MCP package with non-custodial trading (limit, stop-loss, DCA orders): `@epsilon-exchange/mcp` on npm — signs EIP-712 orders locally, the wallet key never leaves the machine
- SDKs: `@epsilon-exchange/sdk` on npm (TypeScript) and `epsilon-exchange` on PyPI (Python) — /v1 client + local EIP-712 order signing, one shared signing fixture across TS/Python/Go
- CLI: `npx @epsilon-exchange/cli` — quote/order/cancel/orders/portfolio/approve/tokens as shell commands over the TS SDK; symbol resolution, human units, --yes for cron, --json for scripts; same env vars as the MCP server
- Self-serve API keys + usage dashboard: https://developers.epsilon.exchange/dashboard (Privy sign-in); builder tier (5x rate limits) by application on the same page
- Permissionless rev-share: pass ?referrer=0xYourAddress on GET /v1/route and the referral leg of every fill you route is paid to that address on-chain — no application, earning from the first fill (ppm is policy-set; SDKs and the MCP server's EPSILON_REFERRER env pass it through)
- Orders are EIP-712 messages (domain EpsilonRouter v7) signed by the maker's wallet; funds stay in the wallet until keepers fill on-chain
- Token discovery: GET /v1/tokens?search=SYMBOL resolves symbols/names to address + decimals, ranked by 30-day USD volume
- Rate limits are tier-driven per key (free: 120 quote / 600 read / 30 order per minute; builder 5x; enterprise by contract), with X-RateLimit-* headers on every response
- Local MCP safety rails: EPSILON_MAX_ORDER_USD spend cap and EPSILON_REQUIRE_CONFIRM two-step placement confirmation
- Error catalog with retry guidance: GET /v1/errors (no key)
- Webhooks: register an HTTPS endpoint on the dashboard and receive HMAC-signed order-lifecycle events (order.filled, stop.triggered, dca.completed, order.failed, …) for your linked wallets — no polling; verify X-Epsilon-Signature (t=…,v1=HMAC-SHA256(secret, t.body)), dedupe on X-Epsilon-Delivery
- Agent plugin (skills + rules + MCP config for Cursor/Claude/any skills-compatible agent): https://github.com/alienbase-xyz/epsilon-plugin — one-command skill install: `npx skills add alienbase-xyz/epsilon-plugin`
- MCP registry entry: io.github.alienbase-xyz/epsilon
- WebMCP site tools: pages on this site register read-only docs-discovery tools (get_epsilon_overview, lookup_epsilon_endpoint, search_epsilon_docs) for WebMCP-capable browsers

## Docs

- [Quickstart, auth, rate limits, errors](https://developers.epsilon.exchange/)
- [Connect your AI agent — Cursor, Claude Code/Desktop, ChatGPT, Codex, Grok, any MCP client; scheduled-task recipes; AGENTS.md block](https://developers.epsilon.exchange/mcp.html)
- [Interactive API reference](https://developers.epsilon.exchange/api/)
- [Epsilon agent plugin (GitHub)](https://github.com/alienbase-xyz/epsilon-plugin)
- [Examples: LangChain + Vercel AI SDK tools, Telegram bot, cron DCA trader (GitHub)](https://github.com/alienbase-xyz/epsilon-examples)

## Related

- [Epsilon app](https://app.epsilon.exchange)
- [Product docs](https://docs.epsilon.exchange)
- [Landing](https://epsilon.exchange)
- [X / Twitter](https://x.com/TradeEpsilon)