List runs

GET/runs

Returns your runs, newest first, without console. Call it to find a run you started earlier, or the study runs you made in the app.

Scope	Heavy call	Long poll	CLI
`scripts:read`	No	No	`chartnaut runs`

Guidance

By default only runs started through the API come back. source=app lists the study runs you made in the app, with ids starting srun_, and source=all lists both. Every run endpoint works on either kind of id.
script=bull-bar keeps runs of that script at any version; script=bull-bar@4 keeps one version. Runs of inline source have script inline.
status=failed with a script filter is the quick way to see why a script keeps failing: each run's failure says what went wrong.
For an indicator or definition run, results_expire_at says when its results go; past it, Get run results answers 410. Study results do not expire.
To follow one run, call Get a run with wait rather than polling this list.

Query parameters

Name	Type	Required	Default	Description
`source`	string	No	`api`	`api` for runs started through the API, `app` for study runs made in the app, `all` for both
`script`	string	No	None	Keeps runs whose `script` is this ref, or this ref with any version. Ignored with `source=app`
`status`	string	No	None	`queued`, `running`, `succeeded`, `failed` or `cancelled`
`limit`	integer	No	50	Most 200
`cursor`	string	No	None	From the previous page's `next_cursor`

Response

200 with a page whose data is an array of Run, without console.

Status codes

Status	Code	Meaning
`200`	-	A page of your runs
`400`	`invalid_request`	`source` is not `api`, `app` or `all`
`500`	`internal`	Your runs could not be read. Retry

Example request

curl "https://api.chartnaut.com/v1/runs?script=bull-bar&status=failed&limit=1" \
  -H "Authorization: Bearer cn_live_XXXX"

Example response

200 OK

{
  "data": [
    {
      "id": "run_p3n8c5v0r6ydj2fe",
      "kind": "definition",
      "script": "bull-bar@4",
      "instrument": "HYPERLIQUID:ETH",
      "timeframe": "1m",
      "window": {
        "from": "2025-03-22T10:50:00Z",
        "to": "2025-05-01T00:00:00Z"
      },
      "settings": {},
      "status": "failed",
      "progress": { "pct": 100 },
      "failure": {
        "kind": "timeout",
        "message": "context deadline exceeded",
        "retryable": true
      },
      "summary": null,
      "usage": { "bars": 0, "compute_units": 0 },
      "app_url": null,
      "created_at": "2026-09-25T18:40:12.581330Z",
      "started_at": "2026-09-25T18:40:12.702914Z",
      "finished_at": "2026-09-25T18:43:27.918006Z",
      "results_expire_at": "2026-10-02T18:40:12.581330Z"
    }
  ],
  "next_cursor": "1"
}

400 Bad Request

{
  "error": {
    "code": "invalid_request",
    "message": "source must be api, app or all."
  }
}

From the CLI

chartnaut runs --script bull-bar --status failed --limit 1

runs prints one row per run with its id, kind, script, instrument, timeframe, status and time, and --source maps to source. Command reference