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)
- Generate an API key in the app's user center (you can also try without a key, rate-limited by IP).
- Add a remote MCP server in Claude, ChatGPT, Codex or Cursor: URL
https://app.chenglanai.com/mcp, Streamable HTTP, headerAuthorization: Bearer YOUR_KEY. - 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(orX-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/metaforgeneratedandasof.
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.