Get a Forward Insight

GET/insights/{insight_id}

Returns one of your Forward Insights: the definition, study run, instrument and timeframe it comes from, and the dimensions its card is broken down by.

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

Guidance

Ids look like ins_842. List Forward Insights and Create a Forward Insight return them.
An insight you removed, or one replaced by a newer insight with the same name, answers 404 not_found.
app_url opens the study run the numbers come from. The card itself shows on the chart when you click one of the definition's events.

Path parameters

Name	Type	Description
`insight_id`	string	The insight's id, such as `ins_842`

Response

200 with a Forward Insight.

Status codes

Status	Code	Meaning
`200`	-	The insight
`404`	`not_found`	No active insight with that id on your account, or the id is not shaped like `ins_123`

Example request

curl https://api.chartnaut.com/v1/insights/ins_842 \
  -H "Authorization: Bearer cn_live_XXXX"

Example response

200 OK

{
  "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"
}

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "No Forward Insight ins_841."
  }
}

From the CLI

chartnaut insights show ins_61

--json prints this response. Command reference