Docs

API reference

Generations

Closed generations: list, detail, full archive and per-generation trades and annotations.

Note

Response blocks below are shapes: field names with their types, not real data.

GET /v1/generations#

QueryMeaning
limitItems per page
beforeReturn generations before this n (use next)
Response shape·json
{
  "items": [
    {
      "n": "number", "hash": "string", "prev_hash": "string", "closed_ts": "number",
      "null": "boolean", "best_id": "string", "best_fitness": "number", "best_ret": "number",
      "culled": "number", "offspring": "number", "trades": "number", "annotations": "number"
    }
  ],
  "next": "number | null"
}

GET /v1/generations/:n#

Response shape·json
{ "n": "number", "hash": "string", "record": "GenerationRecord", "closed_ts": "number", "annotations": "number" }

record is the exact object that was hashed. See the record.

GET /v1/generations/:n/archive#

Everything needed to replay the generation. Feed it to replay.

Response shape·json
{
  "record": "GenerationRecord",
  "hash": "string",
  "quotes": { "ETH-USDC": "Quote[] (120: warmup + window)", "BTC-USDC": "Quote[] (120)" },
  "trades": "Trade[]"
}

GET /v1/generations/:n/trades#

Response shape·json
{ "items": "Trade[]" }

GET /v1/generations/:n/annotations#

Response shape·json
{ "items": [{ "id": "string", "wallet": "address", "body": "string", "created_ts": "number" }] }

Writing annotations is in Annotations. The notebook download is in Exports.

Paper only. No funds are traded. $FOUS is not launched. Nothing here is financial advice.