List Forward Insights

GET/insights

Lists your Forward Insights that are on your charts, the most recently changed first. Call it to find an insight's id before you rename or remove it, or to see which studies are on which charts.

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

Guidance

Only active insights come back. One you removed, or one a newer insight with the same name replaced, is archived and never listed.
The filters combine. definition=orb-breakout&timeframe=1h lists what shows on your 1-hour charts of that definition.
instrument takes a canonical or short symbol, such as HYPERLIQUID:BTC or BTC. One that matches no instrument answers 404 unknown_instrument.
timeframe must match exactly, in lower case, such as 1h.
Page with limit and cursor as on every list.

Query parameters

Name	Type	Required	Default	Description
`definition`	string	No	Any	Only insights on this definition slug
`study`	string	No	Any	Only insights made from this study slug
`instrument`	string	No	Any	Only insights on this instrument
`timeframe`	string	No	Any	Only insights on this timeframe
`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 Forward Insight.

Status codes

Status	Code	Meaning
`200`	-	A page of insights, possibly empty
`404`	`unknown_instrument`	`instrument` matches no instrument
`500`	`internal`	The insights could not be read. Retry

Example request

curl "https://api.chartnaut.com/v1/insights?definition=orb-breakout&limit=2" \
  -H "Authorization: Bearer cn_live_XXXX"

Example response

200 OK

{
  "data": [
    {
      "id": "ins_842",
      "name": "Breakout follow-through by direction",
      "description": "How often a BTC opening range break reached 1R before the stop, long and short.",
      "definition": "orb-breakout",
      "study": "orb-follow-through",
      "study_version": 4,
      "instrument": "BTC",
      "timeframe": "1h",
      "profile": null,
      "window": {
        "from": "2024-09-27T00:00:00Z",
        "to": "2026-09-26T23:00:00Z"
      },
      "scope_dimensions": ["direction"],
      "app_url": "https://terminal.chartnaut.com/morpheus/studies/311/runs/5120",
      "created_at": "2026-09-27T10:14:52.381207Z",
      "updated_at": "2026-09-27T10:14:52.381207Z"
    }
  ],
  "next_cursor": null
}

404 Not Found

{
  "error": {
    "code": "unknown_instrument",
    "message": "Unknown instrument BTCX."
  }
}

From the CLI

chartnaut insights --definition gamma-pressure-divergence --tf 1h

--study, --on, --limit and --cursor set the other filters; --json prints this response. Command reference