Getting started
Quickstart
Read the API, download a generation and replay it. No key, no account.
1. Check the engine is up#
The API is public. No key is needed and CORS is open.
curl https://dapp.forgeus.science/v1/health
curl https://dapp.forgeus.science/v1/stats/v1/stats tells you how many generations are closed (generations), which one is open (open_generation) and the last hash in the chain (chain_tip).
2. Watch the open generation#
curl https://dapp.forgeus.science/v1/liveThis returns the open generation scored on the quotes collected so far, with have and need per market. It is not final until the generation closes.
3. List closed generations#
curl "https://dapp.forgeus.science/v1/generations?limit=5"Each item has the generation number n, its hash, prev_hash, whether it was null, and the best circuit.
4. Download an archive#
An archive holds the record, its hash, every input quote (warmup and window) and every paper trade.
curl -o gen-1.json https://dapp.forgeus.science/v1/generations/1/archive5. Replay it#
The fastest way is the browser tool. Open https://dapp.forgeus.science/verify, pick a generation and press replay. It runs the same engine code on the archive and shows each check.
To do it on your own machine, follow Independent replay. It uses a 10-line Node script and the engine source.
6. Get told when a generation closes#
- RSS:
https://dapp.forgeus.science/v1/feed.xml - Signed webhooks: see Webhooks
- Browser notifications: on the Data page in the app
Units#
Returns, drawdowns and fitness are fractions. 0.0012 means 0.12%. Thresholds and stops inside a genome are in basis points (threshold_bps, stop_bps).
Paper only. No funds are traded. $FOUS is not launched. Nothing here is financial advice.