Backtest API & SDK

Request Body

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" }
});

The API behind the “Backtest this idea” widget on /events/builder. Read-only: no card is created, no ledger or on-chain write happens, no money moves. Runs the same engine as the saved-card backtest, so an idea and a published card holding the same basket return identical numbers.

Request Body

Response

curl -X POST https://cymetica.com/api/v1/event-cards/backtest-idea \
  -H "Content-Type: application/json" \
  -d '{
    "constituents": [
      {"symbol": "BTC", "weight": 50},
      {"symbol": "ETH", "weight": 30},
      {"symbol": "SOL", "weight": 20}
    ],
    "period_days": 90,
    "starting_capital": 10000
  }'

result = await client.basket_backtest.run(
    constituents=[("BTC", 50), ("ETH", 30), ("SOL", 20)],
    period_days=90,
    starting_capital=10_000,
)
print(result["total_return_pct"], result["sharpe_ratio"])
print(result["unresolved_symbols"], result["dropped_symbols"])

const result = await client.basketBacktest.run({
  constituents: [
    { symbol: "BTC", weight: 50 },
    { symbol: "ETH", weight: 30 },
    { symbol: "SOL", weight: 20 },
  ],
  periodDays: 90,
  startingCapital: 10000,
});
console.log(result.total_return_pct, result.sharpe_ratio);

et_basket_backtest(
  constituents=[
    {"symbol": "BTC", "weight": 50},
    {"symbol": "ETH", "weight": 30},
    {"symbol": "SOL", "weight": 20}
  ],
  period_days=90,
  starting_capital=10000
)

Give it a plain-language theme and the Tuatara semantic model selects real trading vehicles (stocks, ETFs, crypto) and weights them by relevance. The basket gets an MM-… symbol and a /macromarket page.

Request Body

curl -X POST https://cymetica.com/api/v1/macromarket/build \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EVENTTRADER_API_KEY" \
  -d '{"theme": "AI infrastructure", "num_assets": 8, "weighting": "tuatara"}'

aib = await client.macromarket.build("AI infrastructure", num_assets=8)
print(aib["symbol"])   # e.g. "MM-AIINFRA"

const aib = await client.macromarket.build({
  theme: "AI infrastructure",
  numAssets: 8,
});

et_aib_build(theme="AI infrastructure", num_assets=8, weighting="tuatara")

Pass aib_symbol for an existing basket, or theme to build and persist one first. Quota-gated: an over-quota caller gets 402 before any expensive work runs. Results are simulated, not investment advice.

Request Body

curl -X POST https://cymetica.com/api/v1/macromarket/backtest \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EVENTTRADER_API_KEY" \
  -d '{"aib_symbol": "MM-AIINFRA", "period_days": 365}'

bt = await client.macromarket.backtest(aib_symbol="MM-AIINFRA", period_days=365)

# Or skip the build entirely and backtest a theme directly:
bt = await client.macromarket.backtest(theme="uranium miners")

const bt = await client.macromarket.backtest({
  aibSymbol: "MM-AIINFRA",
  periodDays: 365,
});

et_aib_backtest(aib_symbol="MM-AIINFRA", period_days=365)
et_aib_backtest(theme="uranium miners")

The headline-basket research engine behind /backtest-rally. Races strategies against BTC and can launch the winner as a Rally Card. Signal/backtest only — no orders are placed. Full reference: /backtest-rally/api.

curl -X POST https://cymetica.com/api/v1/research-backtest/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EVENTTRADER_API_KEY" \
  -d '{"themes": ["ai tokens"], "algo_model": "aib_sentiment", "hold_days": 2}'

run = await client.research_backtest.run(
    themes=["defi tokens", "ai tokens"], hold_days=2)
result = await client.research_backtest.get(run["run_id"])
await client.research_backtest.launch_rally_card(run["run_id"], basket_index=0)

const run = await client.researchBacktest.run({
  themes: ["defi tokens", "ai tokens"],
  params: { hold_days: 2 },
});
const result = await client.researchBacktest.get(run.run_id);

et_research_backtest_run(params={"themes": ["ai tokens"], "hold_days": 2})
et_research_backtest_launch_rally_card(run_id="<run_id>", basket_index=0)

Query Parameters

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

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

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

Path Parameters

curl https://cymetica.com/api/v1/backtest/bots/cryptobull-blue

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

curl https://cymetica.com/api/v1/backtest/bots/cryptobull-blue/equity

Query Parameters

curl "https://cymetica.com/api/v1/backtest/bots/cryptobull-blue/trades?limit=10"

Triggers a new backtest run for the specified bot (Bearer token; no request body — the bot's own strategy, top-10 asset universe and a 30-day window are used). Responds immediately with {"run_id", "status": "queued", "slug"}; the refreshed results appear on the bot's profile and the leaderboard when the async run completes. Also callable as the MCP tool et_backtest_bot_run.

curl -X POST https://cymetica.com/api/v1/backtest/bots/your-bot-slug/run-backtest \
  -H "Authorization: Bearer $EVENTTRADER_API_KEY"

# 200 → {"run_id": "…", "status": "queued", "slug": "your-bot-slug"}
# then stream progress on wss://cymetica.com/ws/backtest/{instance_id}?run_id={run_id}

Request Body

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

Request Body

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

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

curl https://cymetica.com/api/v1/backtest/clone/deposit-info/cryptobull-blue \
  -H "Authorization: Bearer $EVENTTRADER_API_KEY"

Query Parameters

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

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

curl https://cymetica.com/api/v1/backtest/bots/cryptobull-blue/paper-status

Message Types

// 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;
  }
};