ChenglanAI

ChenglanAI Data API

A read-only JSON API for everything public in the app: price-cycle states, key levels, daily state changes, US option structure, macro dashboard and series, news, SEC insider data and short-sale volume. Generate a key in the app's user center; OpenAPI 3.0 docs are available.

Endpoints (GET)

  • /api/v1/list — filter and sort symbols by market, trend, stage, regime
  • /api/v1/symbol/{sym} — state, key levels, last change, macro sensitivity
  • /api/v1/daily?lang=en, /api/v1/weekly?lang=en — daily and weekly market-cycle reports by market (key state changes, same-day events, levels), Markdown available
  • /api/v1/changes — state changes after each close
  • /api/v1/chart/{sym} — daily bars, weekly levels, trend/stage series and all marks
  • /api/v1/ext/{sym} — earnings, option walls and option structure
  • /api/v1/macro/dashboard, /api/v1/macro/series/{key}, /api/v1/calendar
  • /api/v1/news/{sym}, /api/v1/sec/{sym}, /api/v1/short/{sym}

Full reference: API docs (Markdown and OpenAPI 3.0 JSON downloads). Field keys are short ASCII codes; text values such as symbol names and state labels are in Chinese.

Use it from AI assistants (MCP / Skill)

  1. Generate an API key in the app's user center (you can also try without a key, rate-limited by IP).
  2. Add a remote MCP server in Claude, ChatGPT, Codex or Cursor: URL https://app.chenglanai.com/mcp, Streamable HTTP, header Authorization: Bearer YOUR_KEY.
  3. Optional: install SKILL.md into ~/.claude/skills/chenglanai/ so the assistant knows which tool answers which question.
claude mcp add --transport http chenglanai https://app.chenglanai.com/mcp --header "Authorization: Bearer $CHENGLAN_API_KEY"

All client configs and the tool list: API docs · AI access. Results describe price-cycle states only and are not investment advice.

Auth and quota

  • Header Authorization: Bearer cl_live_xxx (or X-API-Key).
  • Default 5,000 calls per key per day, reset at 00:00 Beijing time; see X-RateLimit-Remaining.
  • Published after each market close; check /api/v1/meta for generated and asof.
curl -H "Authorization: Bearer cl_live_xxx" \
  "https://app.chenglanai.com/api/v1/list?mkt=US&bt=1&sort=chg20&limit=50"

See where your watchlist stands in its cycle

Free during public beta. The app interface is in Chinese; tickers, charts and levels are universal.