Docs

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.

bash
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#

bash
curl https://dapp.forgeus.science/v1/live

This 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#

bash
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.

bash
curl -o gen-1.json https://dapp.forgeus.science/v1/generations/1/archive

5. 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.