Summarize a backtest batch

get https://api.dogabot.com/api/v1/backtests/summary

Ranks jobs in a bulk backtest batch (best per symbol by default) with compact metrics, robustness gates, and app URLs.

Scopes read:backtests read

Query parameters

batch_id string required

group_by string

symbol (default), exchange, timeframe, or none.

rank_by string

quality (default), roi, sharpe, sortino, or calmar.

top_n integer

Completed jobs kept per group after the winner (default 3, max 8).

max_drawdown number

Drop completed jobs with max_drawdown above this fraction.

require_gates string

pass drops completed jobs that fail a robustness gate (warnings still rank).

Responses

200 OK

401 Unauthorized

403 Forbidden — missing scope or feature gate

404 Not found

429 Rate limited

import os import requests resp = requests.request( "GET", "https://api.dogabot.com/api/v1/backtests/summary?batch_id=%3Cbatch_id%3E", headers={"Authorization": f"Bearer {os.environ['DOGABOT_API_KEY']}"}, timeout=30, ) resp.raise_for_status() print(resp.json())

package main import ( "fmt" "io" "net/http" "os" ) func main() { req, _ := http.NewRequest("GET", "https://api.dogabot.com/api/v1/backtests/summary?batch_id=%3Cbatch_id%3E", nil) req.Header.Set("Authorization", "Bearer "+os.Getenv("DOGABOT_API_KEY")) resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.Status, string(out)) }

{ "data": { "batch_id": "cde2a214-8827-4651-9f98-52f0221ff666", "group_by": "symbol", "rank_by": "quality", "top_n": 3, "total": 2, "groups": [ { "key": "BTCUSDT", "completed": 1, "best": { "id": "bt-1a2b3c4d", "name": "BTC 1h sample", "roi": 0.42, "max_drawdown": 0.08, "url": "https://app.dogabot.com/backtest/bt-1a2b3c4d" }, "why": "BTC 1h sample ranked first by quality" } ] } }