Guosen Securities Financial Data Query

Problem

When building investment research workflows, financial models, or data checks, teams often need A-share and HK financial statements, single-quarter metrics, TTM values, R&D expense, and dividend data. Hand-written API calls can fail on security code, market code, reporting period, or field mapping, while free-form prompting may introduce unreliable values. @guosen-securities/guosen-stock-financial wraps Guosen Securities financial data queries into a structured skill so the model can request clearly defined interfaces with explicit parameters.

How It Works

• Coverage: supports A-share and HK balance sheet, income statement, and cash flow statement data, as well as metrics such as operating revenue, net profit, gross margin, ROE, EPS TTM, R&D expense, and dividend yield.
• Interface selection: A-share calls require code and market, with market set to SH or SZ; HK calls use HK. reportType, reportYear, and count constrain reporting periods and record counts.
• Key and execution: the skill expects GS_API_KEY, reads it from ./memory.md, injects it as an environment variable, and then invokes scripts/get_data.py. Returned fields are matched through key values in the info array.
• Query constraints: for multi-entity comparisons, the source notes that more than five entities are truncated to the first five, and the output should mention this limitation.

Boundaries

This skill is suitable for reading financial data through Guosen Securities interfaces and organizing fields. It does not cover unlisted data such as market quotes, disclosures, or fund flows. If a call fails, the workflow should report a data retrieval failure rather than substituting web search. GS_API_KEY is sensitive and must not be hardcoded, logged, or exposed; returned data is for reference only and is not investment advice.