Tickerbot API — The stock market in SQL

GET/v2/strategies/{name}/backtest

For strategies with exit policy, this walks bars in order and produces a series of (entry, exit, pnl, exit_reason) records the way a real trading bot would. With no exit policy, the strategy exits when the condition flips false; PnL is null unless `position_size` is supplied. Distinct from /history (per-bar boolean) and /events (condition-true spans). Backtest is the only one of the three that consumes the exit-policy fields.

Plan access

Hobby and above.

Rate limit

Hobby 60/min · Pro 2,000/min · Scale 10,000/min.

Capacity

Counts against your saved-rule capacity until v1.5 introduces a separate cap.

Query parameters

namestringrequired

Strategy slug.

tickerstringrequired

Ticker symbol to backtest on.

intervalstringdefault 1d

Bar resolution. Defaults to 1d.

frominteger

Earliest epoch ms.

tointeger

Latest epoch ms.

position_sizenumber

Dollars per trade. When supplied, the PnL fields become absolute; otherwise PnL is expressed as percent.

Status codes

200

{ as_of, ticker, interval, trades: [...], summary: { n_trades, win_rate, total_pnl_pct, total_pnl_abs?, avg_hold_bars } }

curl "https://api.tickerbot.io/v2/strategies/{name}/backtest" \
  --get \
  --data-urlencode 'interval=1d' \
  -H "Authorization: Bearer YOUR_KEY"

Try it

This endpoint requires an authenticated key. Sign in to run it from your dashboard, or get a free key. tickerbot.io/dashboard.

Sample response

{
  "as_of": "2026-05-21T18:55:00.000Z",
  "ticker": "AAPL",
  "interval": "1d",
  "trades": [
    {
      "entry_t": 1707264000000, "entry_price": 187.32,
      "exit_t": 1708127200000, "exit_price": 198.55,
      "exit_reason": "take_profit",
      "hold_bars": 10,
      "pnl_pct": 0.0599
    }
  ],
  "summary": {
    "n_trades": 1,
    "win_rate": 1.0,
    "total_pnl_pct": 0.0599,
    "avg_hold_bars": 10
  }
}