List scripts

GET/scripts

Returns your indicators, definitions and studies, most recently changed first, without their source. Call it to find a script's slug and latest version.

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

Guidance

Only your own scripts come back. Search the library finds built-ins and other people's scripts, with the ref to run them by.
Each item is the list form of a Script: no interface, dependencies or files. Call Get a script for those.
latest_version is the number to send as base_version when you save. A 0 means the script has no version yet.
q is a plain substring match on slug, name and description, in any letter case. It is not ranked.
An unknown kind returns an empty page, not an error, so check the spelling when a filtered list comes back empty.

Query parameters

Name	Type	Required	Default	Description
`kind`	string	No	All kinds	`indicator`, `definition` or `study`. Any other value returns an empty page
`q`	string	No	None	Keeps scripts whose slug, name or description contains this text, in any letter case
`limit`	integer	No	50	Most 500
`cursor`	string	No	None	From the previous page's `next_cursor`

Response

200 with a page whose data is an array of Script in its list form.

Status codes

Status	Code	Meaning
`200`	-	A page of your scripts
`500`	`internal`	Your scripts could not be read. Retry

Example request

curl "https://api.chartnaut.com/v1/scripts?kind=indicator&limit=2" \
  -H "Authorization: Bearer cn_live_XXXX"

Example response

200 OK

{
  "data": [
    {
      "slug": "my-ema",
      "kind": "indicator",
      "name": "My EMA",
      "description": "20-period EMA on the price chart.",
      "visibility": "private",
      "latest_version": 3,
      "updated_at": "2026-09-25T14:02:11.482913Z",
      "app_url": "https://terminal.chartnaut.com/morpheus/indicator-builder/412"
    },
    {
      "slug": "session-range",
      "kind": "indicator",
      "name": "Session range",
      "description": "",
      "visibility": "public",
      "latest_version": 7,
      "updated_at": "2026-09-21T08:40:57.103288Z",
      "app_url": "https://terminal.chartnaut.com/morpheus/indicator-builder/398"
    }
  ],
  "next_cursor": "2"
}

500 Internal Server Error

{
  "error": {
    "code": "internal",
    "message": "Internal error. Retry; if it persists contact [email protected]."
  }
}

From the CLI

chartnaut ls --kind indicator --limit 2

ls prints one row per script with its slug, kind, latest version, visibility and name, and -q maps to q. Command reference