文档

MarketDiving API 是为开发者打造的金融数据基础设施。基于模块化设计，按需加载所需数据能力，部署在全球 Edge 节点，提供低延迟的数据服务。

快速开始

1. 获取 API Key

注册账号后，在控制台创建 API Key。免费套餐无需信用卡，每月 1,000 次调用。

2. 发起第一个请求

# 获取三安光电基本信息 curl -X POST https://api.marketdiving.com/v1/execute \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "skill": "stock-basic", "tool": "get_stock_info", "params": { "symbol": "600703" } }'

3. 返回示例

{ "success": true, "data": { "symbol": "600703", "name": "三安光电", "current_price": 15.91, "change_percent": -4.41, "total_market_cap": 79375287946.57, "pe_ratio": 45.2, "pb_ratio": 3.8 }, "meta": { "request_id": "xxx", "timestamp": "2026-02-20T10:00:00.000Z", "source": "eastmoney", "cached": false, "latency": 45 } }

认证

MarketDiving API 使用 API Key 进行认证。你可以在 控制台 创建和管理 API Key。

获取 API Key

注册账号后，在控制台创建 API Key。免费套餐无需信用卡，每月 1,000 次调用。

使用 API Key

在请求头中添加 Authorization：

Authorization: Bearer YOUR_API_KEY

演示 API Key

以下演示 Key 可以直接使用：

API Key 套餐 限制
md-demo-free-001 Free 30次/分钟，1,000次/月
md-basic-001 Basic 60次/分钟，10,000次/月
md-pro-001 Pro 120次/分钟，100,000次/月

查询 API Key 信息

curl -H "Authorization: Bearer md-demo-free-001" \ https://api.marketdiving.com/v1/auth/info

端点列表

端点 方法 描述
/ GET 健康检查
/v1/execute POST 执行 Skills 工具
/v1/test/:symbol GET 测试端点（获取股票信息）
/v1/endpoints GET 列出所有可用端点

股票基础 (stock-basic)

get_stock_info

获取股票基本信息，包括名称、股本、市值、估值指标等。

"params": { "symbol": "600703" // 股票代码 }

get_stock_price

获取股票历史行情数据，支持日线，可指定复权方式。

"params": { "symbol": "600703", "start_date": "2024-01-01", // 可选，默认 2024-01-01 "end_date": "2024-12-31", // 可选，默认 2024-12-31 "adjust": "qfq" // 可选：none, qfq(前复权), hfq(后复权) }

search_stocks

根据名称或代码搜索股票。

"params": { "keyword": "三安光电" // 搜索关键词 }

get_all_stocks

获取全市场股票列表，包含基本信息。数据缓存 24 小时。

财务报表 (financial-report)

get_income_statement

获取利润表（损益表），包含营业收入、成本、利润等数据。

"params": { "symbol": "600703", "periods": 8 // 可选，获取最近几期，默认 8 }

get_balance_sheet

获取资产负债表，包含资产、负债、所有者权益等数据。

get_cashflow_statement

获取现金流量表，包含经营活动、投资活动、筹资活动现金流。

get_all_financials

同时获取三大财务报表。

财务分析 (financial-analysis)

v1.1 新增

analyze_financial_report

智能分析财务报表，生成投资视角的财务健康报告。包含盈利能力、成长性、偿债能力等多维度评估。

"skill": "financial-analysis", "tool": "analyze_financial_report", "params": { "symbol": "600703", "depth": "standard" // 可选：standard | detailed }

返回示例：

{ "score": { "total": 72, "interpretation": "良好", "breakdown": { "profitability": 18, "growth": 15, "efficiency": 12, "safety": 15, "cashflow": 12 } }, "key_metrics": { "roe": { "value": "12.5", "vs_industry": "+8.2%" }, "revenue_growth": { "value": "23.5", "unit": "%" } }, "analysis": "该公司财务健康度良好...", "risk_level": "medium" }

compare_with_industry

与同行业进行估值和财务指标对比，了解公司在行业中的相对位置。

"skill": "financial-analysis", "tool": "compare_with_industry", "params": { "symbol": "600703" }

calculate_valuation

基于行业基准和财务数据，计算股票估值参考范围。

"skill": "financial-analysis", "tool": "calculate_valuation", "params": { "symbol": "600703", "method": "pe" // pe | pb | dcf }

公告数据 (announcement)

get_announcements

获取上市公司公告列表，可指定日期范围和公告类型。

"params": { "symbol": "600703", "start_date": "2024-01-01", // 可选 "end_date": "2024-12-31", // 可选 "page_size": 30, // 可选，最大 30 "page_num": 1 // 可选，默认 1 }

get_announcement_pdf

下载公告 PDF 文件。

"params": { "pdf_url": "http://static.cninfo.com.cn/...", "extract_text": true // 可选，是否提取文本 }

路线图

v1.0 - 当前版本
已完成
• Core Skills 框架
• 股票基础数据（行情、基本信息）
• 财务报表（三表）
• 公告数据（巨潮资讯）
• Cloudflare Workers 部署
v1.1 - 基本面分析（当前）
进行中
• ✅ 财报智能解读
• ✅ 行业对比分析
• ✅ 估值计算工具
• 更多行业基准数据
• 历史财务趋势分析
v1.2 - 深度研报
规划中
• 自动化研究报告生成
• 同业竞争格局分析
• 产业链上下游分析
• 风险因子识别
v2.0 - 数据增强
规划中
• 宏观经济数据
• 行业景气度指标
• 资金流向分析
• 机构持仓数据
v2.1 - 实时行情
延后
• WebSocket 实时推送
• 分时数据
• Level-2 行情
• 技术指标计算

更新日志

v1.1.0 (2026-02-20)

v1.0.0 (2026-02-20)