Stocki — AI Financial Analyst

Professional financial analyst with institutional-grade data. Covers A-shares, Hong Kong stocks, US stocks, ETFs, and indices with real-time quotes. Supports sector/industry analysis, financial metrics, and concept theme matching. Two modes: instant (Q&A) and quant (backtesting, strategy, deep analysis).

Core Principle

For real-time market data and quantitative analysis, use Stocki. General financial knowledge questions (e.g. "what is P/E ratio?") can be answered directly without Stocki. Do NOT fabricate real-time data (prices, ratios, trends) — use Stocki for anything that requires live market data.

Setup

CODEBLOCK0

See INSTALL.md for installation and update methods. {baseDir} is resolved automatically by OpenClaw.

Mode Selection

Default to instant. Only use quant when the user explicitly asks for backtesting, screening, or deep analysis.

Signal	Mode	Command
Any financial question (default)	Instant	INLINECODE1
Backtesting, strategy, screening

Quant | python3 {baseDir}/scripts/stocki.py quant <question> |
| Iterate on existing analysis | Quant | python3 {baseDir}/scripts/stocki.py quant <question> --task-id <id> |
| Scheduled monitoring | Instant | stocki.py instant on cron |

---

Instant Mode

Call and return output immediately. No extra processing, no commentary, no reformatting.

CODEBLOCK1

Server maintains persistent context — follow-up questions work.

---

Quant Mode

For complex analysis (minutes to complete). Tasks are auto-created.

Only one quant analysis can run at a time. If busy, retry later.

Submit:
CODEBLOCK2

Iterate:
CODEBLOCK3

Poll status (every 30s-1min, stay silent until done):
CODEBLOCK4

Get results:
CODEBLOCK5

Present the summary as the main message. Download reports and images as attachments.

---

Scheduled Monitoring

Use stocki.py instant on cron. Do NOT write custom scripts.

CODEBLOCK6

Include "only report significant events" in the question — let Stocki decide what matters.

---

CLI Reference

Always use these commands for Stocki interactions. Do NOT call the Gateway API directly.

Command	Usage	Description
INLINECODE6	INLINECODE7	Quick Q&A (180s)
INLINECODE8

<question> [--task-id ID] [--timezone TZ] | Submit quant (30s) |
| stocki.py list | (no args) | List analyses (30s) |
| stocki.py status | <id> | Analysis status (120s) |
| stocki.py files | <id> | List result files (120s) |
| stocki.py download | <id> <path> [--output] | Download file (300s) |
| stocki.py diagnose | (no args) | Self-diagnostic (180s) |
| stocki.py doctor | (no args) | Check/fix setup (60s) |

Exit: 0=success, 1=auth error, 2=unavailable, 3=rate limited/quota.

Invoke as: python3 {baseDir}/scripts/stocki.py <command> [args]

---

Error Handling

Code	Action
INLINECODE20	Guide: export STOCKI_API_KEY="sk_..." and INLINECODE22
INLINECODE23

Key wrong or expired; contact Stocki team |
| quota_exceeded | Daily quota used up; show invite URL if available |
| stocki_unavailable | Outage; retry in a few minutes |
| task_not_found | Run stocki.py list to find valid analyses |
| run_error | Report error verbatim; offer to resubmit |
| rate_limited | Queue full; wait and retry |

---

Output Rules

• - Instant mode: Present output directly. No attribution, no processing.
• Quant mode: Prefix with "以下分析来自Stocki：". Preserve content, clean up formatting for mobile.
• Language: Respond in user's language.

---

Local Workspace

CODEBLOCK7

Create on first use: INLINECODE30

Preferences (markets, language, timezone) from profile.md can be included in queries. Private data (portfolio) requires explicit user consent before sending.

---

Updates

Version: 0.4.2 — Check for updates daily:

CODEBLOCK8

After updating, re-read this SKILL.md. See INSTALL.md for all methods.