REST + WebSocket + MCP

Backtest API & SDK

Run strategy backtests, browse the bot leaderboard, clone bots, and paper trade — all via API.

API Endpoints

Strategy Types

Max Concurrent

Real-Time Stream

Quick Start

# Run a funding rate backtest
curl -X POST https://cymetica.com/api/v1/backtest-labs/run \
  -H "Content-Type: application/json" \
  -d '{"type":"funding_rate","params":{"coin":"BTC","days":30,"capital":10000,"leverage":1,"strategy":"cross_exchange"}}'

# Get bot leaderboard
curl https://cymetica.com/api/v1/backtest/leaderboard?sort=total_return&limit=10

from event_trader import EventTrader

client = EventTrader(api_key="evt_...")

# Run a backtest
result = await client.backtest.run_lab(
    type="funding_rate",
    params={"coin": "BTC", "days": 30, "capital": 10000}
)

# Get leaderboard
leaderboard = await client.backtest.leaderboard(sort="total_return", limit=10)

# Get bot profile
bot = await client.backtest.bot("alpha-momentum-v2")

import { EventTrader } from "@anthropic/event-trader";

const client = new EventTrader({ apiKey: "evt_..." });

// Run a backtest
const result = await client.backtest.runLab({
  type: "funding_rate",
  params: { coin: "BTC", days: 30, capital: 10000 }
});

// Get leaderboard
const leaderboard = await client.backtest.leaderboard({ sort: "total_return", limit: 10 });

// Get bot profile
const bot = await client.backtest.bot("alpha-momentum-v2");

# Python
pip install event-trader

# TypeScript / Node.js
npm install @anthropic/event-trader

Authentication

Most read endpoints are public (no auth required). Write operations (run backtest, clone, update settings) require a Bearer token.

# Authenticated request
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://cymetica.com/api/v1/backtest/bots/my-bot/run-backtest

Get your API key from /account → API Keys.

Backtest Labs

Run parameterized strategy backtests. Supports funding rate arbitrage, momentum, and mean reversion strategies. Max 20 concurrent backtests via Redis queue.

POST /api/v1/backtest-labs/run Run a strategy backtest

Request Body

typestringStrategy type: funding_rate, momentum, mean_reversion

params.coinstringAsset symbol (BTC, ETH, SOL, etc.)

params.daysintegerLookback period in days

params.capitalnumberStarting capital in USDC

params.leveragenumberLeverage multiplier

params.strategystringStrategy variant (e.g., cross_exchange)

curl -X POST https://cymetica.com/api/v1/backtest-labs/run \
  -H "Content-Type: application/json" \
  -d '{
    "type": "funding_rate",
    "params": {
      "coin": "BTC",
      "days": 30,
      "capital": 10000,
      "leverage": 1,
      "strategy": "cross_exchange"
    }
  }'

result = await client.backtest.run_lab(
    type="funding_rate",
    params={"coin": "BTC", "days": 30, "capital": 10000, "leverage": 1, "strategy": "cross_exchange"}
)

const result = await client.backtest.runLab({
  type: "funding_rate",
  params: { coin: "BTC", days: 30, capital: 10000, leverage: 1, strategy: "cross_exchange" }
});

Bot Leaderboard

Browse ranked AI trading bots with sorting and filtering. 60-second cache on leaderboard results.

GET /api/v1/backtest/leaderboard Get bot leaderboard

Query Parameters

sortstringSort by: total_return, win_rate, sharpe, max_drawdown (default: total_return)

categorystringFilter by category (default: all)

teamstringFilter by team: all, red, blue

limitintegerMax results (default: 20)

offsetintegerPagination offset (default: 0)

curl "https://cymetica.com/api/v1/backtest/leaderboard?sort=total_return&team=red&limit=10"

leaderboard = await client.backtest.leaderboard(sort="total_return", team="red", limit=10)

const lb = await client.backtest.leaderboard({ sort: "total_return", team: "red", limit: 10 });

Bot Profiles

Get bot details, equity curves, and trade history. 60-second cache on profile data.

GET /api/v1/backtest/bots/{slug} Get bot profile

Path Parameters

slugstringBot slug identifier

curl https://cymetica.com/api/v1/backtest/bots/alpha-momentum-v2

GET /api/v1/backtest/bots/{slug}/equity Get equity curve

Returns time-series equity data for charting the bot's portfolio value over time.

curl https://cymetica.com/api/v1/backtest/bots/alpha-momentum-v2/equity

GET /api/v1/backtest/bots/{slug}/trades Get trade history

Query Parameters

limitintegerMax trades (default: 50)

offsetintegerPagination offset (default: 0)

curl "https://cymetica.com/api/v1/backtest/bots/alpha-momentum-v2/trades?limit=10"

Bot Operations

Run backtests and update settings. These endpoints require authentication.

POST /api/v1/backtest/bots/{slug}/run-backtest Run backtest AUTH

Triggers a new backtest run for the specified bot. Returns a run ID that can be tracked via WebSocket.

curl -X POST https://cymetica.com/api/v1/backtest/bots/my-bot/run-backtest \
  -H "Authorization: Bearer YOUR_TOKEN"

PATCH /api/v1/backtest/bots/{slug}/settings Update bot settings AUTH

Request Body

namestringNew bot name (optional)

avatar_urlstringNew avatar URL (optional)

curl -X PATCH https://cymetica.com/api/v1/backtest/bots/my-bot/settings \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Alpha Bot v3"}'

Bot Cloning

Clone bot species into new instances. Cloned bots get dedicated HD wallets (account 4 derivation path). Requires authentication.

POST /api/v1/backtest/clone Clone a bot AUTH

Request Body

species_slugstringSpecies slug to clone from

namestringName for the new cloned bot

curl -X POST https://cymetica.com/api/v1/backtest/clone \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"species_slug": "momentum-species", "name": "My Momentum Clone"}'

GET /api/v1/backtest/clone/deposit-info/{species_slug} Get clone deposit info AUTH

Returns deposit address and minimum deposit required to activate a cloned bot.

curl https://cymetica.com/api/v1/backtest/clone/deposit-info/momentum-species \
  -H "Authorization: Bearer YOUR_TOKEN"

Paper Trading

View paper trades and paper trading status for bots running in simulation mode.

GET /api/v1/backtest/bots/{slug}/paper-trades Get paper trades

Query Parameters

statusstringFilter: open, closed, all

limitintegerMax trades (default: 50)

offsetintegerPagination offset (default: 0)

curl "https://cymetica.com/api/v1/backtest/bots/alpha-bot/paper-trades?status=open&limit=20"

GET /api/v1/backtest/bots/{slug}/paper-status Get paper trading status

Returns current paper trading status including P&L, open positions, and account balance.

curl https://cymetica.com/api/v1/backtest/bots/alpha-bot/paper-status

WebSocket — Real-Time Backtest Updates

Stream real-time backtest progress and results via WebSocket.

WS wss://cymetica.com/ws/backtest/{instance_id}?run_id={run_id} Backtest progress stream

Message Types

stateeventBacktest state change (queued, running, completed, failed)

progresseventProgress update with percentage and current step

completedeventFinal results with performance metrics

failedeventError details on failure

heartbeateventKeep-alive ping

// JavaScript WebSocket example
const ws = new WebSocket("wss://cymetica.com/ws/backtest/bot-123?run_id=run-456");
ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  switch (msg.type) {
    case "progress":
      console.log(`${msg.percent}% — ${msg.step}`);
      break;
    case "completed":
      console.log("Results:", msg.results);
      break;
    case "failed":
      console.error("Error:", msg.error);
      break;
  }
};

Rate Limits

Backtest runslimitMax 20 concurrent backtests (Redis queue). Additional requests are queued.

Leaderboardcache60-second cache on leaderboard and profile data.

API callslimitStandard rate limits apply (60 req/min for authenticated, 30 req/min for public).

MCP Tools

All backtest endpoints are available as MCP tools for AI integration. Install the EventTrader MCP server to use these tools with any MCP-compatible AI assistant.

et_backtest_runtoolRun a backtest in Backtest Labs

et_backtest_leaderboardtoolGet bot leaderboard

et_backtest_bot_profiletoolGet bot profile

et_backtest_bot_equitytoolGet bot equity curve

et_backtest_bot_tradestoolGet bot trade history

et_backtest_bot_runtoolTrigger a backtest run

et_backtest_bot_settingstoolUpdate bot settings

et_backtest_clonetoolClone a bot

et_backtest_clone_deposit_infotoolGet clone deposit info

et_backtest_paper_tradestoolGet paper trades

et_backtest_paper_statustoolGet paper trading status

EventTrader

Backtest API & SDK

Quick Start

Authentication

Backtest Labs

Request Body

Bot Leaderboard

Query Parameters

Bot Profiles

Path Parameters

Query Parameters

Bot Operations

Request Body

Bot Cloning

Request Body

Paper Trading

Query Parameters

WebSocket — Real-Time Backtest Updates

Message Types

Rate Limits

MCP Tools

[ LOGIN ]

[ RESET PASSWORD ]

[ SIGN UP ]