china-ifind_skill

Overview

This skill provides access to iFinD (51ifind.com) financial data APIs for Chinese markets. It exposes 18 endpoints covering real-time quotes, historical time series, financial statements, macroeconomics, fund valuation, portfolio tools, and more across A-shares, funds, bonds, futures, and indices. The skill automates authentication, quota checks, and returns structured API responses for programmatic use.

How this skill works

Before any call the skill ensures a valid IFIND_REFRESH_TOKEN is configured; if missing it prompts the user to supply a refresh token and stores it silently. Calls are proxied through platform scripts that handle user_id generation, payment/usage validation, token exchange, and the actual iFinD HTTP requests. Results include API data plus billing or trial status when applicable.

When to use it

• Retrieve live market quotes and intraday snapshots for A-shares, funds, futures, and indices.
• Fetch historical K-line series, minute-level data, or high-frequency sequences for backtesting.
• Query company fundamentals, financial indicators and downloadable corporate announcements.
• Access macroeconomic series (GDP, CPI, etc.) or curated topic reports like REITs and top trades.
• Obtain fund minute or daily valuation data and fund-related metrics.
• Manage or monitor simulated portfolios and perform smart stock screening.

Best practices

• Ensure IFIND_REFRESH_TOKEN is configured before requesting data to avoid interruptions.
• Prefer paginated or time-windowed queries for large historical ranges to reduce latency and cost.
• Check returned payment_url immediately if a call indicates insufficient balance and inform users to top up.
• Respect trial notices in responses: include remaining trial days when reporting results to users.
• Use code conversion endpoint to normalize security symbols to iFinD codes before data calls.

Example use cases

• Get the latest quote and volume for a Shanghai-listed stock to show a live price card.
• Download daily K-line for the past year for backtesting a momentum strategy.
• Pull quarterly financial indicators to compute valuation ratios for a screening pipeline.
• Fetch CPI and GDP time series for macro overlays when building an economic dashboard.
• Run fund minute valuation to display intraday NAV estimates for mutual fund monitoring.