SuperAPI AI Directory

mx-finance-data

Data & analytics

View repository

Updated 10-16 10:45

About this skill

Financial Data Query

Scope of Functions

1. Supported Query Object Scope

  • Stocks (A-shares, Hong Kong stocks, US stocks)
  • Sectors, indices, shareholders
  • Corporate issuers, bonds, unlisted companies
  • Stock market, fund market, bond market

2. Supported Data Types for Query

The following types of structured data are supported for query:

  • Real-time quotes(current price, price change percentage, order book data, etc.)
  • Quantitative data(technical indicators, capital flows, etc.)
  • Statement data(revenue, net profit, financial ratios, etc.)

3. Supported Query Methods andStrict Limits

Supports combined queries across multiple entities, multiple indicators, and multiple time ranges.Due to backend interface limitations, a single query must comply with the following quotas:

  • Entity limit: A single query supports at most 5 stocks/financial entities.
  • Processing logic: If a user request exceeds the above limit, the Skill will prioritize the first 5 entities and indicate this in the result description file.

Example: "Query the revenue of six stocks A, B, C, D, E, and F" -> only the first five are returned.

4. Output Results

After execution, the Skill outputs the following files:

  • One query result xlsx file, used to carry structured query results
  • One result description txt file, used to describe the query content, meaning of results, and necessary notes

Query Examples

Basic Indicator Query

  • East Money's fundamentals
  • Kweichow Moutai's operating revenue and net profit for the most recent year
  • Performance of semiconductor ETFs

Real-time Quotes and Order Book Query

  • Current real-time buy orders for 300059
  • NVIDIA's current latest price and price change percentage
  • Current CSI 300 level and turnover

Multi-entity, Multi-indicator, Multi-time Query (note quotas)

  • Compliant example: Compare the gains since the Spring Festival of the ChiNext Index, CSI 300, and CSI 500 (3 entities) (1 indicator).
  • Compliant example: East Money, Pinduoduo (2 entities) revenue, gross profit, and net profit for the most recent year (3 indicators).
  • Over-limit notice: If querying "the PE of the top ten weighted stocks in Shanghai and Shenzhen," the system will take the first 5 for the query.

Additional Notes

  • This Skill is intended for querying structured financial data and relational data, and does not focus on subjective analysis, investment advice, or news interpretation.
  • The statement must contain explicit financial entity names.
  • When a user initiates a query in natural language, the Skill can identify the query object, indicators, and time range based on the question content, and output structured result files.
  • For query requests within the supported scope, prioritize outputting structured query results and generate a result description file at the same time for subsequent use.

3. Install dependencies

pip3 install httpx pandas openpyxl --user

Quick Start

Execute in the working directory

python3 {baseDir}/scripts/get_data.py --query "贵州茅台近期走势如何"

Output Example

xlsx: /path/to/miaoxiang/mx_finance_data/mx_finance_data_9535fe18.xlsx
描述: /path/to/miaoxiang/mx_finance_data/mx_finance_data_9535fe18_description.txt
行数: 42

Output File Description

File Description
mx_finance_data_<查询id>.xlsx Structured data table containing the requested entities and metrics
mx_finance_data_<查询id>_description.txt Contains the query logic description, field meanings, andquota truncation notice