Simulation API

Backtest index strategies against historical data

Simulation API

Hindsight as a service. Run backtests against crypto data from 2020 to today. The results are always instructive and never actionable — past performance guarantees nothing except the knowledge that you could have done better.

All GET requests. No authentication. Base URL: https://generalmarket.io/api

---

List Categories

The universe of things you can backtest.

GET /sim/categories

cURL

curl "https://generalmarket.io/api/sim/categories"

Show Response

{
  "categories": [
    { "id": "layer-1", "name": "Layer 1", "coin_count": 45, "source": "coingecko" },
    { "id": "dl-dexes", "name": "Decentralized Exchanges", "coin_count": 32, "source": "defillama" },
    { "id": "meme-token", "name": "Meme Coins", "coin_count": 120, "source": "coingecko" },
    { "id": "artificial-intelligence", "name": "AI & Big Data", "coin_count": 38, "source": "coingecko" }
  ]
}

---

Run Backtest

One simulation. One set of parameters. Cached when possible, computed when not.

GET /sim/run

cURL

curl "https://generalmarket.io/api/sim/run?\
category_id=layer-1&\
top_n=10&\
weighting=mcap&\
rebalance_days=30&\
base_fee_pct=0.1&\
spread_multiplier=1.0"

Parameters

Parameter	Type	Required	Default	Description
category_id	string	Yes	—	Category slug from /sim/categories
top_n	int	Yes	—	Number of top assets by market cap
weighting	string	Yes	—	Weighting scheme (see Backtesting Guide)
rebalance_days	int	Yes	—	Days between rebalances
base_fee_pct	float	No	0.1	Fee percentage per rebalance
spread_multiplier	float	No	1.0	Slippage multiplier
start_date	string	No	Earliest data	ISO date YYYY-MM-DD
force	bool	No	false	Skip cache, recompute
threshold_pct	float	No	—	Drift-based rebalance threshold (%)
fng_mode	string	No	—	Fear & Greed regime (fear, greed, both)
fng_fear_threshold	int	No	25	FNG below this = fear regime
fng_greed_threshold	int	No	75	FNG above this = greed regime
fng_cash_pct	float	No	0.4	% to stables during greed
dom_mode	string	No	—	Dominance regime (btc, eth, inverse)
dom_lookback	int	No	30	Lookback days for dominance trend
vc_mode	string	No	—	VC filter mode
vc_investors	string	No	—	Comma-separated investor names
vc_min_amount_m	float	No	—	Min funding amount ($M)
vc_round_types	string	No	—	Comma-separated round types

Response

Show Full Response Schema

{
  "run_id": 4821,
  "config": {
    "category_id": "layer-1",
    "top_n": 10,
    "weighting": "mcap",
    "rebalance_days": 30,
    "base_fee_pct": 0.1,
    "spread_multiplier": 1.0
  },
  "stats": {
    "total_return_pct": 312.45,
    "annualized_return": 32.8,
    "max_drawdown_pct": -72.1,
    "sharpe_ratio": 0.94,
    "total_fees_pct": 1.8,
    "total_trades": 248,
    "total_rebalances": 72,
    "total_delistings": 5,
    "start_date": "2020-01-01",
    "end_date": "2026-02-27"
  },
  "nav_series": [
    { "date": "2020-01-01", "nav": 1.0 },
    { "date": "2020-01-02", "nav": 1.012 }
  ],
  "cached": true,
  "computed_in_ms": 0
}

Field	Type	Description
run_id	int	Unique ID for fetching holdings or comparing runs
stats.total_return_pct	float	Cumulative return (e.g., 312.45 = 312.45%)
stats.annualized_return	float	Annualized return %
stats.max_drawdown_pct	float	Maximum peak-to-trough decline (negative)
stats.sharpe_ratio	float	Risk-adjusted return metric
stats.total_fees_pct	float	Cumulative fees across all rebalances
stats.total_trades	int	Number of individual trades executed
stats.total_rebalances	int	Number of rebalance events
stats.total_delistings	int	Assets removed mid-backtest
nav_series	array	Daily NAV points starting at 1.0
cached	bool	Whether the result was served from cache
computed_in_ms	int	Computation time (0 if cached)

---

Run Backtest (Streaming)

Same simulation, but streamed. Watch the backtest compute in real time.

GET /sim/run-stream

cURL

curl -N "https://generalmarket.io/api/sim/run-stream?\
category_id=layer-1&top_n=10&weighting=mcap&rebalance_days=30"

SSE event types:

Type	Fields	Description
progress	pct, current_date	Simulation progress (0–100%)
result	Same as /sim/run response	Final result
error	error	Error message if simulation fails

---

Sweep Stream

Vary one parameter, hold the rest constant. See what matters and what does not.

GET /sim/sweep-stream

Parameter	Type	Required	Description
sweep	string	Yes	Dimension to sweep: top_n, weighting, rebalance, category, threshold
category_id	string	Yes	Category slug
categories	string	No	Comma-separated category IDs (for sweep=category)
All /sim/run params	—	Varies	Base configuration (the non-swept param values)

Sweep top_n

curl -N "https://generalmarket.io/api/sim/sweep-stream?\
sweep=top_n&category_id=layer-1&weighting=mcap&rebalance_days=30"

Sweep values per dimension:

Sweep	Values Tested
top_n	5, 10, 20, 30, 50, 100, 200
weighting	All available schemes (11 base + 9 DeFi for dl-* categories)
rebalance	14d, 30d, 60d, 90d, 180d + drift bands at 3%, 5%, 10%, 15%

---

Get Holdings

What the backtest was holding at any point in time.

GET /sim/holdings

Parameter	Type	Required	Description
run_id	int	Yes	Run ID from a backtest result
date	string	No	Specific rebalance date (YYYY-MM-DD). Defaults to latest.

cURL

curl "https://generalmarket.io/api/sim/holdings?run_id=4821"

---

Compare Runs

Multiple backtests, overlaid. The comparison is the point.

GET /sim/compare

Parameter	Type	Required	Description
run_ids	string	Yes	Comma-separated run IDs (e.g., 4821,4822,4823)

curl "https://generalmarket.io/api/sim/compare?run_ids=4821,4822,4823"

---

List Cached Results

Everything the engine has already computed. Filtered by category if you wish.

GET /sim/results

Parameter	Type	Required	Description
category_id	string	No	Filter by category

curl "https://generalmarket.io/api/sim/results?category_id=layer-1"

---

Get Benchmarks

BTC and ETH, normalized to 1.0 at the start date. The benchmarks against which every strategy is judged.

GET /sim/benchmarks

Parameter	Type	Required	Description
start_date	string	Yes	ISO date YYYY-MM-DD
end_date	string	No	ISO date (defaults to today)

curl "https://generalmarket.io/api/sim/benchmarks?start_date=2020-01-01"