ApocData · A-Share AI Data Skill

Zero-auth, zero-dependency. Use curl to call 45+ A-share data endpoints (quotes / financials / fund flows / factors / announcements / macro). Compatible with Claude, ChatGPT, Qwen, Kimi, DeepSeek and any AI agent that supports tool calling.

The SKILL.md in this repository is a capability card that can be loaded directly into AI agents, letting LLMs query A-share market data and complete research tasks without any SDK.

English | 简体中文

---

Table of Contents

• Overview
• Data Service Platform
• Installation
• Basic Usage
• Endpoint Overview
• Combined Analysis Example
• Editions & Capabilities
• Notes & Compliance

---

Overview

ApocData focuses on AI-native access to China's A-share market, designed for AI agents, quantitative research, investment content, and institutional applications. We provide unified endpoints for quotes, financials, fund flows, dragon-tiger boards, quantitative factors, macro indicators, and more.

---

Data Service Platform

Platform URL: https://data.tianqis.com

The data service platform is the unified entry point for ApocData. It provides:

• Open API (no auth) — This is what the Skill connects to. No registration, no token required. Ideal for quick experiments and lightweight usage.
• OpenAPI documentation & SDKs — Python / TypeScript supported.
• Platform editions (with API key) — Higher quotas, deeper history, lower latency, and richer data fields. See Editions & Capabilities.

The base URL used by this Skill: https://data.tianqis.com/api/blade-dataplatform/open/data

---

Installation

macOS / Linux

mkdir -p ~/.claude/skills/apocdata
curl -o ~/.claude/skills/apocdata/SKILL.md \
  https://raw.githubusercontent.com/ApocData/ApocData-skill/main/SKILL.md

Windows (PowerShell)

New-Item -ItemType Directory -Force -Path ~\.claude\skills\apocdata
Invoke-WebRequest `
  -Uri https://raw.githubusercontent.com/ApocData/ApocData-skill/main/SKILL.md `
  -OutFile ~\.claude\skills\apocdata\SKILL.md

China users (Gitee mirror)

mkdir -p ~/.claude/skills/apocdata
curl -o ~/.claude/skills/apocdata/SKILL.md \
  https://gitee.com/apocdata/ApocData-skill/raw/main/SKILL.md

Restart Claude Code or Claude Desktop after installation. The Skill takes effect automatically.

---

Basic Usage

All endpoints are HTTP GET. Call them directly with curl:

BASE="https://data.tianqis.com/api/blade-dataplatform/open/data"

# Single stock quote
curl -s "$BASE/quote?symbol=000001"

# Stock basic info (incl. PE/PB/market cap)
curl -s "$BASE/stock?symbol=000001"

Full parameters, return fields, and example questions for each endpoint: see SKILL.md.

---

Endpoint Overview

45 endpoints in total, grouped by data dimension:

Real-time Quotes & K-line (7)

Endpoint	Description
quote	Latest change/volume/price for one stock
quotes	Batch quotes, up to 10 stocks
daily	Daily K history, ≤ 30 records
ranking	Market-wide gain/loss rankings
index-daily	Index daily K
hk-daily	Hong Kong daily K
tech-factor	Technical factors (MACD/KDJ/RSI/BOLL/MA)

Fundamentals & Financials (5)

Endpoint	Description
stock	Stock basics (industry / cap / PE / PB)
financial	Financials (ROE / revenue / net profit), ≤ 4 periods
express	Earnings express reports
dividend	Dividend and share allotment plans
cyq-perf	Chip distribution and profit ratio

Shareholders & Governance (6)

Endpoint	Description
holders	Top 10 shareholders / circulating
holder-number	Historical shareholder count
share-float	Lock-up release records
repurchase	Share buyback plans and progress
block-trade	Block trade records
survey	Institutional research visits

Fund Flows (5)

Endpoint	Description
moneyflow	Stock fund flow and main net inflow
hsgt	HSGT (North/South bound) fund flow
sector-flow	Sector / concept / regional fund flow
hk-hold	Stock holdings via HSGT
margin	Margin trading and short selling summary

Dragon-Tiger & Sentiment (6)

Endpoint	Description
dragon-tiger	Dragon-tiger list / stock history
limit-list	Limit up / down / broken pools
limit-step	Consecutive limit-up ladder
hot-rank	EastMoney popularity ranking
hot-money	Famous hot-money directory
hot-money-detail	Hot-money trade details

Sectors & Concepts (4)

Endpoint	Description
concepts	EastMoney concept directory
concept-stocks	Concept constituent stocks
ths-boards	THS industry / concept boards
ths-board-stocks	THS board constituents

News & Announcements (2)

Endpoint	Description
news	Recent news (title / link / sentiment)
announcements	Company announcements (AI summary + markdown)

Macro Economics (3)

Endpoint	Description
macro	Macro indicator history (GDP/CPI/PPI/PMI)
macro/latest	Latest macro indicator values
macro/definition	Macro indicator definitions

Search & Utilities (5)

Endpoint	Description
stocks	Search stocks by name / code
indexes	Search indexes by name / code
calendar	A-share trading calendar
st	ST / delisting risk status
factors	Quant factor registry (sanitized)

Convertible Bonds (2)

Endpoint	Description
convertible-bonds	Convertible bond basic info
cb-price-chg	Conversion price change records

---

Combined Analysis Example

When asked "Analyze the valuation of 688017", the agent will call in sequence:

BASE="https://data.tianqis.com/api/blade-dataplatform/open/data"
curl -s "$BASE/stock?symbol=688017"          # PE/PB/market cap
curl -s "$BASE/quote?symbol=688017"          # current price
curl -s "$BASE/financial?symbol=688017"      # ROE/net profit
curl -s "$BASE/daily?symbol=688017&limit=30" # recent trend

---

Editions & Capabilities

ApocData is organized into four editions to match different use cases. All editions share the same API contract; capabilities are filtered by edition whitelist. This Skill defaults to the no-auth open endpoints. Upgrade to a platform edition with API key for higher quotas and deeper data.

Edition Lineup

SKU	Edition	Target Users
FREE	Free	Individuals / AI agent demos
PRO	Professional	Investment research / content creators
QUANT	Quant	Quantitative research teams
ENT	Enterprise	Institutional embedding / private deployment

Capability Comparison (selected)

Capability	Free	Pro	Quant	Enterprise
Daily calls	2,000	50,000	300,000	Custom
QPS limit	2	10	30	Custom
Snapshot latency	15 min	1 min	≤ 30s	Custom (≤ 10s)
Daily K depth	30 days	5 yrs + adj.	Full	Full
Quant factors	—	20	Full	Full + custom
MCP Tools	8	14	18	18+ custom
Availability SLO	best-effort	99.0%	99.5%	99.9% (contract)
Support	Community	Email 48h	Email 24h	Dedicated channel + phone

All editions include OpenAPI docs, SDKs, status page, and usage dashboard. Full capability matrix and pricing details available upon request.

Add-ons (stackable on existing editions)

Add-on	Name	Description
ADD-HIST-10Y	History extension	Daily K from 30 days to 10 years
ADD-FACTOR-50	Factor extension	Pro factors: 20 → 70
ADD-MCP-PRO	Agent pack	Unlock all 18 MCP tools
ADD-BULK	Usage-based	Overflow billing, no upgrade needed
ADD-ENT-SLA	Enterprise SLA	99.9% · dedicated bandwidth
ADD-WHITELABEL	White-label	Custom domain + docs

Pricing, upgrades, and business inquiries: drawsea@163.com

---

Notes & Compliance

Usage conventions

• All endpoints are read-only and authentication-free. No registration or token required.
• symbol uses a 6-digit numeric code (e.g., 688017), no exchange suffix.
• Recommended request timeout: 10 seconds.
• Data source: ApocData, synchronized with A-share data ingestion cycles.

Compliance

• Quote data is delayed (not exchange-licensed real-time data).
• Derived data is cleaned and structured; redistribution is prohibited.
• News contains only titles and links; full content copyright belongs to the original publishers.
• Factors and signals are for research purposes only and do not constitute any investment advice.

---

Contact: drawsea@163.com