Build an AI trading agent on Eterna Hybrid Exchange in under 30 minutes — using Claude (MCP), the official CLI, or sandboxed TypeScript strategies.
Eterna is a no-KYC perpetual futures exchange with flat fees (0.014% maker / 0.035% taker), CEX-grade liquidity routed from Bybit, and native AI-agent tooling: an MCP server, a CLI, and a managed TypeScript sandbox with an injected eterna.* SDK.
Affiliate disclosure: links to Eterna in this repo use referral code
Steve. Signing up through them costs you nothing extra — fees are identical — and supports this project.
| Eterna | Typical setup (direct CEX API) | |
|---|---|---|
| KYC | None — wallet auth | Full KYC |
| Taker fee | Flat 0.035% | 0.045%+ before volume tiers |
| Maker fee | Flat 0.014% | 0.015%+ |
| Agent access | Native MCP server + CLI + sandbox SDK | Roll your own REST/WS client |
| Agent safety | Isolated sub-account, no withdrawal rights | API key scoping varies |
| Liquidity | $10B+ routed from Bybit order books, <200ms | Depends on venue |
Run your own numbers: Eterna vs Hyperliquid fee calculator · full comparison.
-
Sign up at ehx.app (wallet signature, ~2 minutes, no KYC).
-
In Claude: Customize → Connectors → Add Custom Connector.
-
Name it
Eterna, set the server URL to:https://mcp.eterna.exchange/mcp -
Click Add → Connect, sign in, and Authorize.
-
Keep Needs Approval on at first — approve each trade manually until you trust your prompts.
Works with claude.ai, Claude Desktop, and Claude Code. See docs/claude-setup.md for details and the generic MCP client config.
# Authenticate (browser OAuth, or device code over SSH)
npx @eterna-hybrid-exchange/cli login
# Check auth and endpoint status
npx @eterna-hybrid-exchange/cli status
# Balance and open positions
npx @eterna-hybrid-exchange/cli balance
npx @eterna-hybrid-exchange/cli positions
# Browse the sandbox SDK reference
npx @eterna-hybrid-exchange/cli sdk --search "place order"
npx @eterna-hybrid-exchange/cli sdk --detail fullCredentials are stored in ~/.eterna/credentials.json and auto-refreshed. See docs/cli-setup.md.
Your code runs in Eterna's managed Deno sandbox with the eterna.* SDK injected — no API client to build, no keys in your code.
# Run a strategy file
npx @eterna-hybrid-exchange/cli execute examples/first-session.ts
# Or pipe code directly
echo 'const balance = await eterna.getBalance(); return balance;' \
| npx @eterna-hybrid-exchange/cli execute -Starter strategies in examples/:
first-session.ts— read balance, positions, and a ticker; no orders placed. Run this first.account-snapshot.ts— a compact account + market report your agent can call on a schedule.
Agent prompts to pair with the MCP connector are in prompts/.
- The MCP/CLI agent operates an isolated sub-account: it can trade but cannot withdraw funds. Your master account keeps custody.
- Start with Needs Approval in Claude; switch to Always Allow only for strategies you have watched run.
- Fund the sub-account only with what the strategy needs.
- Perpetual futures with leverage can lose money quickly. Nothing in this repo is financial advice. See SECURITY.md.
- docs/claude-setup.md — Claude / MCP client setup
- docs/cli-setup.md — CLI reference and auth flows
- docs/fees.md — fee schedule and comparison, with sources
- Eterna AI landing: https://ai.eterna.exchange/
- MCP endpoint:
https://mcp.eterna.exchange/mcp - Official monorepo: https://github.com/EternaHybridExchange/eterna-ai
- CLI repo: https://github.com/EternaHybridExchange/eterna-cli
- Referral program details: https://eterna.exchange/blog/eterna-referral-program-earn-from-the-volume-you-bring
- 30-minute agent tutorial: https://eterna.exchange/blog/build-your-ai-trading-agent-with-eterna-mcp-in-less-than-30-minutes
Community project, not affiliated with or endorsed by Eterna Hybrid Exchange. SDK method names and commands follow the official docs at the time of writing — verify with npx @eterna-hybrid-exchange/cli sdk before trading real funds. Trading perpetual futures involves substantial risk of loss.
MIT © 2026