EasyQuote MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@EasyQuote MCP Serverget real-time quote for 600519.SH"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EasyQuotes — 多市场行情、ETF 与基金持仓分析 SDK + MCP
📚 查看完整 API 文档 / Explore the API Documentation — 在线浏览全部 REST API、请求参数、响应结构和可用能力。
Stock market data API, Python SDK and MCP server for A-shares, Hong Kong stocks, US stocks, ETF holdings intelligence and institutional fund portfolios.
EasyQuotes 不只是行情 SDK:除 A 股、港股、美股实时行情、分时与历史 K 线外,还提供 ETF 持仓穿透、基金与机构持仓分析、ETF 增量追踪,以及融合 ETF 共识、主题强度、价格趋势、资金和龙虎榜的潜在龙头发现能力。全量功能可通过 REST API 与 MCP 直接调用,适用于量化研究、投研工具和 AI Agent。
🎁 GitHub 开发者专属体验
使用 GitHub 账号连接 EasyQuotes,即可免费领取 7 天 Pro API 访问权限和一个独立的 eq_... API Key。本期开放 1,000 个名额,每个 GitHub 账号限领一次。
体验权益包含实时行情、历史 K 线、分时、ETF 与基金数据、资金分析以及远程 MCP 接入,可直接配合本 SDK、REST API、Claude Desktop 和 Cursor 使用。
Star 完全自愿,不影响领取资格。如果 EasyQuotes 对你的项目有帮助,欢迎为仓库点亮 Star。
Related MCP server: Stock SDK MCP Server
实时市场大屏 Demo
这是基于 EasyQuotes API 构建的完整 Demo,展示如何将实时行情、行业资金异动、市场罗盘、ETF 持仓方向、机构持仓和策略研究能力组合成可交互的市场观测产品。
使用方式
输入你的 EasyQuotes API Key;没有 Key 时可先前往官网注册获取。
通过顶部标签查看行业异动、稳定资金、市场罗盘、今日候选、T+0 ETF、ETF 持仓方向、机构持仓和策略实验室。
点击行业、ETF 或股票,可继续查看资金轨迹、相关 ETF、成分股及行情详情。
Demo 不包含预置 API Key,也不会把 Key 写入页面源码或 URL。Key 仅保存在当前浏览器会话中,并通过 x-api-key 请求头调用 EasyQuotes API;关闭浏览器会话后会被清除。
大屏用于展示 EasyQuotes SDK/API 的组合能力。行情数据仅供参考,不构成投资建议。
核心特色
能力 | 可以做什么 |
多市场统一行情 | 使用统一标的格式查询 A 股、港股、美股的报价、分时、K 线、逐笔和盘口 |
ETF 实时与持仓穿透 | ETF/T+0 ETF 排行、ETF 成分股、股票被哪些 ETF 持有、区间新增 ETF 持仓 |
基金与机构持仓分析 | 基金新进/退出/增仓/减仓排行,股票反查持仓机构,查询单只基金的股票组合 |
ETF 驱动的潜龙发现 | 综合 ETF 增量与共识、主题热度、趋势、资金和龙虎榜,生成解释、快照与回测 |
AI Agent 原生接入 | Cursor、Claude Desktop 等客户端无需安装 SDK,直接通过远程 MCP 调用全部工具 |
多种集成方式 | Python SDK、REST API、Streamable HTTP MCP、SSE MCP 与 WebSocket |
安装
pip install easyquotes可选扩展:
pip install "easyquotes[stream]" # WebSocket 同步推送
pip install "easyquotes[stream-async]" # WebSocket 异步推送Python 版本要求:>= 3.10
快速开始
通过环境变量配置 API Key:
export EASYQUOTE_API_KEY="eq_your_key_here"SDK 默认连接 https://122.51.7.196。如果需要覆盖服务端点,可以同时设置:
export EASYQUOTE_BASE_URL="https://quotes.example.com"from easyquote import EasyQuoteClient
client = EasyQuoteClient() # 自动读取 EASYQUOTE_API_KEY
quote = client.get_quote("600519.SH")
print(f"{quote.name}: {quote.price} ({quote.change_pct:+.2f}%)")也可以直接传入 api_key:
client = EasyQuoteClient(api_key="eq_your_key_here")A股策略研究与模拟盘
opportunities = client.get_strategy_opportunities(limit=20)
signals = client.get_strategy_signals(state="triggered")
report = client.run_strategy_backtest(
"2026-07-20",
"2026-07-21",
initial_cash=1_000_000,
)
# 模拟账户需要主动创建;不会连接券商或开启实盘交易
paper = client.create_paper_account("研究账户", initial_cash=1_000_000)
detail = client.get_paper_account(paper["id"])MCP 直接接入
无需安装 Python SDK,支持 MCP 的客户端可以直接连接 EasyQuote 服务:
协议 | 端点 | 适用客户端 |
Streamable HTTP |
| Cursor、现代 MCP 客户端 |
SSE |
| Claude Desktop、旧版 MCP 客户端 |
鉴权统一使用 HTTP Header:x-api-key: <your-api-key>。
Cursor / Streamable HTTP
{
"mcpServers": {
"easyquote": {
"url": "https://122.51.7.196/mcp",
"headers": {
"x-api-key": "eq_your_key_here"
}
}
}
}Claude Desktop / SSE
{
"mcpServers": {
"easyquote": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://122.51.7.196/sse",
"--header",
"x-api-key: eq_your_key_here"
]
}
}
}MCP 会将行情、K 线、ETF 持仓、基金与机构持仓、潜龙发现、资金流向、财务数据、技术分析、龙虎榜和问财自然语言选股等能力暴露为可直接调用的工具。详细配置可前往 MCP 集成页面。
接入后可以直接向 AI Agent 提问:
“查询贵州茅台被哪些 ETF 持有,并按权重排序”
“最近一个季度基金新进了哪些股票?”
“查询 510300 的主要持仓股票”
“结合 ETF 增量和主题强度寻找当前潜在龙头,并解释风险”
ETF 与基金特色 API
这些能力均已包含在 REST API 与远程 MCP 中:
端点 | 能力 |
| ETF 实时涨跌排行,支持 T+0 ETF |
| 全市场 ETF 与 T+0 ETF 列表 |
| 查询 ETF 实时申赎或季报持仓明细 |
| 查询哪些 ETF 持有某只股票 |
| 查询区间内新增持有某只股票的 ETF |
| 基金/QFII/社保等机构的新进、退出、增减仓排行 |
| 查询持有某只股票的基金和机构 |
| 查询单只基金的持仓股票组合 |
| ETF、行业、概念和热点的全市场方向地图 |
| ETF 驱动的潜在龙头专业猎手 |
| 解释单只股票的潜龙状态与风险 |
REST 示例:
curl -H "x-api-key: eq_your_key_here" \
"https://122.51.7.196/api/v1/etf/stock-holders-db?code=600519"
curl -G -H "x-api-key: eq_your_key_here" \
--data-urlencode "change=新进" \
--data-urlencode "hold_type=基金" \
"https://122.51.7.196/api/v1/fund/new-positions"标的代码格式
市场 | 格式示例 | 说明 |
A 股上交 |
| 沪市,后缀 |
A 股深交 |
| 深市,后缀 |
A 股北交 |
| 北交所,后缀 |
港股 |
| 五位数代码,后缀 |
美股 |
| 股票代码,后缀 |
指数 |
| 上证指数等 |
API 参考
行情 (Quotes)
方法 | 说明 |
| 单只标的实时行情,返回 |
| 批量实时行情,返回 |
| 批量行情快照(mac 协议), |
| 批量五档盘口(mac 协议) |
K 线 (K-Lines)
方法 | 说明 |
| A 股/港股/美股历史 K 线,返回 |
| 指数 K 线 |
| 境外行情 K 线, |
period 可选值:"1m" / "5m" / "15m" / "30m" / "60m" / "daily" / "weekly" / "monthly"
分时 (Intraday)
方法 | 说明 |
| A 股/港股/美股当日分时,返回 |
| 历史某日分时数据, |
逐笔 (Transactions)
方法 | 说明 |
| 今日逐笔成交明细 |
| 历史逐笔成交, |
资金流向 (Fund Flow)
方法 | 说明 |
| 当日主力资金流向,返回 |
| 历史资金流向列表 |
基本面 A 股 (A-share Fundamentals)
方法 | 说明 |
| A 股财务指标(PE/PB/EPS 等) |
| 除权除息记录 |
| 公司公告列表, |
基本面 全球 (Global Fundamentals)
方法 | 说明 |
| 公司概况,返回 |
| 高管信息,返回 |
| 财务报告, |
板块 (Sectors)
方法 | 说明 |
| 板块数据, |
| 板块涨跌排行, |
| 板块成员列表 |
市场 (Market)
方法 | 说明 |
| 市场统计(涨跌家数、成交额等) |
| 证券列表, |
| 证券总数,返回 |
境外行情 (Global Quotes)
方法 | 说明 |
| 境外单只行情, |
| 境外 K 线 |
实时推送 (Streaming)
方法 | 说明 |
| 同步 WebSocket 推送,需安装 |
| 异步 WebSocket 推送,需安装 |
使用示例
批量获取行情
quotes = client.get_quotes(["600519.SH", "000001.SZ", "TSLA.US", "00700.HK"])
for q in quotes:
print(f"{q.symbol} {q.price:>10.2f} {q.change_pct:+.2f}%")K 线数据
klines = client.get_klines("600519.SH", period="daily", count=120)
for k in klines[-5:]:
print(f"{k.datetime} O:{k.open} H:{k.high} L:{k.low} C:{k.close} V:{k.volume}")历史分时
bars = client.get_minute_history("600519.SH", date="20260617")
for b in bars[:10]:
print(b.time, b.price, b.volume)资金流向
ff = client.get_fund_flow("600519.SH")
print(f"主力净流入: {ff.net_main / 1e8:.2f} 亿")板块排行
ranking = client.get_board_ranking(board_type="industry", top_n=10, sort_by="change_pct")
for b in ranking:
print(b["name"], b["change_pct"])同步 WebSocket 推送
with client.stream() as ws:
ws.subscribe(["600519.SH", "000001.SZ", "TSLA.US"])
for event in ws:
if event["op"] == "quotes":
for q in event["data"]:
print(q["symbol"], q["last_price"])异步 WebSocket 推送
import asyncio
async def main():
async with client.stream_async() as ws:
await ws.subscribe(["600519.SH", "TSLA.US"])
async for event in ws:
print(event)
asyncio.run(main())逐笔成交
ticks = client.get_transactions("600519.SH", start=0, count=50)
for t in ticks:
print(t["time"], t["price"], t["volume"], t["direction"])境外行情
# 获取纳斯达克个股 K 线
klines = client.get_global_klines("US", "TSLA", period="daily", count=60)
# 获取港股行情
quote = client.get_global_quote("HK", "00700")错误处理
from easyquote import EasyQuoteClient
from easyquote import AuthError, RateLimitError, APIError, NotFoundError
client = EasyQuoteClient(api_key="eq_your_key")
try:
quote = client.get_quote("600519.SH")
except AuthError:
print("API Key 无效或未设置")
except RateLimitError:
print("请求频率超限,请稍后重试")
except NotFoundError:
print("标的不存在")
except APIError as e:
print(f"API 错误 {e.code}: {e.message}")自托管部署
如果使用自托管的 EasyQuote 后端(基于 easy-tdx 的 FastAPI 服务),推荐通过环境变量指定服务地址:
export EASYQUOTE_BASE_URL="https://quotes.example.com"客户端会自动读取该配置:
client = EasyQuoteClient(api_key="eq_your_key")也可以通过 base_url 参数为单个客户端显式指定,参数优先于环境变量:
client = EasyQuoteClient(
api_key="eq_your_key",
base_url="https://quotes.example.com",
)HTTP 和 WebSocket 均会自动切换到指定地址(wss:// 对应 HTTPS,ws:// 对应 HTTP)。
生产环境应使用 HTTPS。通过 HTTP 访问时,API Key 会以明文在网络中传输。
许可证
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
China A-share market data for research, backtesting and AI agents via MCP.
MCP server giving AI agents one-connection access to China A-share market intelligence: financials,
Read-only China A-share data for AI agents: market, limit-up, capital flow and disclosures.
Access real-time and historical market data for China A-shares and Hong Kong stocks, along with ne…
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides professional financial data access for LLMs via MCP, supporting providers like Tushare, Wind, and DataYes.1458Apache 2.0
- AlicenseAqualityFmaintenanceProvides comprehensive stock market data (A-shares, Hong Kong, US) including real-time quotes, K-lines, technical indicators, sectors, futures, and options, with built-in AI Skills and MCP Prompts for financial analysis.69126 npm102ISC
- AlicenseAqualityDmaintenanceProvides access to Chinese A-share market financial data, including historical K-line, real-time quotes, financial statements, shareholder information, and technical indicators, via MCP protocol.128 npm3MIT
- FlicenseNot gradedqualityBmaintenanceProvides stock market data (search, quotes, real-time, charts) for A-share, Hong Kong, and US stocks via MCP tools.-