{"name":"CuckooTrade","synthetic":true,"api_version":1,"generation":1,"tagline":"Deterministic synthetic market data. No key, no signup.","disclaimer":"All data is synthetic. CuckooTrade exists for exercising code paths -- development, CI, demos, tutorials -- never for validating trading strategies: a profitable backtest on synthetic data means nothing.","path_scheme":"/api/v1/{provider}/<provider's own path> mimics that provider's wire format (point its SDK there via a base-URL override); /api/v1/... without a provider segment is CuckooTrade-native. The path version covers this API's surface; the `generation` parameter versions the data itself.","docs":{"site":"https://cuckootrade.com/docs","openapi":"/api/openapi.json","swagger":"/api/docs","llms":"https://cuckootrade.com/llms.txt"},"determinism":"Identical requests return identical bars, forever, within a generation. Add &seed=<anything> for a different but equally deterministic dataset.","magic_tickers":{"CRASH":"sharp ~25% crash mid-month, slow recovery","MOON":"parabolic monthly pump, sharp correction","FLAT":"zero-range bars, constant price","GAPPY":"large overnight gaps most days","HALTS":"missing minute bars during intraday halt windows","SPIKEY":"single-minute fat-finger wicks","PENNY":"sub-dollar prices, high volatility","CHOPPY":"high volatility, zero net drift"},"providers":{"alpaca":{"status":"available","base_url":"https://cuckootrade.com/api/v1/alpaca","compatible_with":"https://data.alpaca.markets","sdk_hint":"StockHistoricalDataClient(url_override='https://cuckootrade.com/api/v1/alpaca') with any non-empty keys","endpoints":[{"method":"GET","path":"/api/v1/alpaca/v2/stocks/bars","purpose":"Alpaca-compatible historical bars","example":"/api/v1/alpaca/v2/stocks/bars?symbols=AAPL,CRASH&timeframe=1Day&start=2026-07-01"},{"method":"GET","path":"/api/v1/alpaca/v2/stocks/bars/latest","purpose":"latest completed bar per symbol","example":"/api/v1/alpaca/v2/stocks/bars/latest?symbols=AAPL,SPY"},{"method":"GET","path":"/api/v1/alpaca/v2/stocks/{symbol}/bars","purpose":"single-symbol variant","example":"/api/v1/alpaca/v2/stocks/AAPL/bars?timeframe=15Min"}]},"alphavantage":{"status":"available","base_url":"https://cuckootrade.com/api/v1/alphavantage","compatible_with":"https://www.alphavantage.co","sdk_hint":"any Alpha Vantage client pointed at the base_url; apikey accepted and ignored","endpoints":[{"method":"GET","path":"/api/v1/alphavantage/query","purpose":"Alpha Vantage-compatible time series: TIME_SERIES_INTRADAY, TIME_SERIES_DAILY, TIME_SERIES_WEEKLY, TIME_SERIES_MONTHLY, GLOBAL_QUOTE","example":"/api/v1/alphavantage/query?function=TIME_SERIES_DAILY&symbol=IBM"}]},"polygon":{"status":"available","base_url":"https://cuckootrade.com/api/v1/polygon","compatible_with":"https://api.polygon.io","sdk_hint":"any Polygon client pointed at the base_url; apiKey accepted and ignored","endpoints":[{"method":"GET","path":"/api/v1/polygon/v2/aggs/ticker/{ticker}/range/{multiplier}/{timespan}/{from}/{to}","purpose":"Polygon-compatible aggregate bars (custom windows, cursor pagination via next_url)","example":"/api/v1/polygon/v2/aggs/ticker/MSFT/range/1/day/2026-07-01/2026-08-01"},{"method":"GET","path":"/api/v1/polygon/v2/aggs/ticker/{ticker}/prev","purpose":"previous session's daily bar","example":"/api/v1/polygon/v2/aggs/ticker/MSFT/prev"}]}},"native_endpoints":[{"method":"GET","path":"/api/v1/stream","purpose":"SSE ticks; clock=demo is an always-open synthetic session, clock=real follows the NYSE calendar","example":"/api/v1/stream?symbols=CUCKOO,CRASH"}],"rate_limit":"60 req/min sustained, burst 120, per address, no key."}