Firebase MCP
Gives AI development tools Firebase-specific capabilities and expertise.
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
TickDB: AI-native real time stock API and market data API for US/HK/CN stocks, forex, futures, crypto, indices and commodities. Skill, CLI, MCP, REST API and WebSocket. AI 原生实时股票 API 与金融行情数据 API,覆盖美股、港股、A股、外汇、期货、指数、大宗商品、加密货币。ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/skills/tickdb-tickdb-unified-realtime-marketdata-api)MCP ที่ต่อ AI เข้ากับบริการในงานเดียวกัน
Gives AI development tools Firebase-specific capabilities and expertise.
หมวดงานเดียวกัน เรียงแบบเดียวกับหน้ารายการ Skill
| ตัวนี้ tickdb-unified-realtime-marketdata-api | timesfm | Shadowbroker | google-maps-scraper | tradingview-mcp | |
|---|---|---|---|---|---|
| ผู้ทำ | TickDB | google-research | BigBodyCobain | gosom | atilaahmettaner |
| จำนวน Skill | 1 | 1 | 1 | 1 | 1 |
| ดาว GitHub | 932 | 35,620 | 11,590 | 8,176 | 5,304 |
| แก้โค้ดล่าสุด | 6 พ.ย. 2569 | 13 พ.ย. 2569 | 17 พ.ย. 2569 | 15 พ.ย. 2569 | 15 พ.ย. 2569 |
| สัญญาอนุญาต | MIT | Apache-2.0 | AGPL-3.0 | MIT | MIT |
ชุดคำสั่ง (Skill) 1 ชุดจาก TickDB ให้ AI อ่านแล้วทำงานตามวิธีนี้ · ไม่ใช่ MCP server
MCP = มือ
ต่อ AI เข้ากับบริการหรือข้อมูลข้างนอก เช่น อ่าน Notion หรือสร้างใบแจ้งหนี้ ต้องมีโปรแกรมหรือ server ทำงานอยู่
Skill = คู่มือ
ไฟล์ข้อความที่สอน AI ว่างานนี้ทำยังไง ไม่ต่อบริการใด
บางตัวคล้ายกัน: Skill บางตัวมีสคริปต์เรียกเครื่องมือ และ MCP บางตัวส่งแค่ความรู้ ให้ดูที่งานที่อยากทำเป็นหลัก
Claude (เว็บ/แอป)
ตามที่ README ของผู้ทำเขียนไว้ และโฟลเดอร์ที่มีใน repo
บัญชี GitHub TickDB (บุคคล) เพิ่งเปิดมา 10 เดือน ระวังเป็นพิเศษ
★ 932 ดาว · แก้โค้ดล่าสุด 6 พ.ย. 2569
มีสคริปต์ 1 ไฟล์ที่รันบนเครื่องได้: SKILL.md
สคริปต์ที่เรียกอินเทอร์เน็ต: SKILL.md
ไม่พบ hook หรือการเขียนค่าตั้งของเครื่อง
ตรวจอัตโนมัติจากไฟล์ใน repo ที่ commit b09e9ef (อ่านไฟล์อย่างเดียว ไม่ได้รัน) ไม่ใช่การรับรองความปลอดภัย อ่านแล้วตัดสินใจเอง
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่ใช้ แล้วหน้านี้จะแสดงเฉพาะวิธีติดตั้งของแอปนั้น
อัปโหลดใน claude.ai ไม่ผ่าน เพราะคำอธิบายยาวเกิน 200 ตัวอักษร (212 ตัวอักษร) ใช้ทาง "ให้ AI ติดตั้งให้" แทน
คัดลอกประโยคนี้ไปวางในแชตของ Claude Code
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
เปิด Claude Code ใหม่ แล้วพิมพ์ /SKILL หรือสั่งงานที่ตรงเรื่อง Claude จะเลือกใช้เอง
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
git clone --depth 1 https://github.com/tickdb/tickdb-unified-realtime-marketdata-api.git /tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef/SKILL' ~/.claude/skills/SKILLSkill ที่ติดตั้งเองใช้ได้ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยาย Codex ใน IDE · ChatGPT บนเว็บและมือถือใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
แอป ChatGPT บนคอมมี Codex อยู่ในตัว Codex อ่าน Skill จากโฟลเดอร์ ~/.agents/skills
เปิด Codex ในแอป ChatGPT บนคอม แล้ววางประโยคนี้ในแชต
AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
วางโฟลเดอร์ tickdb-market-data ไว้ที่ ~/.agents/skills/tickdb-market-data
~ คือโฟลเดอร์บ้านของคุณ ($HOME)
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
git clone --depth 1 https://github.com/tickdb/tickdb-unified-realtime-marketdata-api.git /tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef/SKILL' ~/.agents/skills/SKILLตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
ใช้ Skill ที่ติดตั้งเองไม่ได้ ใช้ได้เฉพาะ Skill ที่มากับปลั๊กอินในไดเรกทอรี
อยากใช้ Skill นี้กับ ChatGPT ให้ใช้แอป ChatGPT บนคอมตามวิธีด้านบน
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
คัดลอกประโยคนี้ไปวางในแชตของ Codex · ใช้ได้ทั้ง Codex ในแอป ChatGPT บนคอม, Codex CLI และส่วนขยายใน IDE
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
Codex เห็น Skill ที่ติดตั้งใหม่เอง ถ้ายังไม่ขึ้นให้ปิดแล้วเปิด Codex ใหม่ · เรียกใช้: ใน ChatGPT พิมพ์ @ แล้วเลือก Skill · ใน Codex CLI หรือส่วนขยายใน IDE พิมพ์ /skills หรือพิมพ์ $ แล้วตามด้วยชื่อ Skill
ตรวจกับเอกสารทางการล่าสุด 15 พ.ย. 2569 · แหล่ง: learn.chatgpt.com
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
git clone --depth 1 https://github.com/tickdb/tickdb-unified-realtime-marketdata-api.git /tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef/SKILL' ~/.agents/skills/SKILLคัดลอกประโยคนี้ไปวางในแชตของ Cursor
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ใน Agent chat ของ Cursor พิมพ์ / แล้วเลือก SKILL
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: cursor.com
Skill คือคำสั่งที่ AI จะทำตาม อ่านไฟล์ก่อนติดตั้ง และติดตั้งเฉพาะจากผู้ทำที่เชื่อถือได้
Mac: กด Command+Space พิมพ์ Terminal · Windows: คำสั่งด้านล่างใช้ใน PowerShell ไม่ได้ ให้ใช้ทาง “ให้ AI ติดตั้งให้” ด้านบนแทน
คำสั่งนี้ดาวน์โหลด repo ไว้ชั่วคราว แล้วคัดลอกเฉพาะโฟลเดอร์ที่มี SKILL.md
git clone --depth 1 https://github.com/tickdb/tickdb-unified-realtime-marketdata-api.git /tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-tickdb-tickdb-unified-realtime-marketdata-api-b09e9ef/SKILL' ~/.cursor/skills/SKILLสำหรับแอปอื่นที่อ่าน Skill ได้ ประโยคนี้มี path ของ Claude Code, Codex และ Cursor ให้ AI เลือกตามแอปที่ใช้ · คัดลอกประโยคนี้ไปวางในแชตของแอป
เลือกเฉพาะโปรเจกต์ ให้วางในแชตที่เปิดอยู่ในโฟลเดอร์ของโปรเจกต์นั้น · AI จะบอก path ให้ดูก่อนติดตั้งเสมอ
AI จะบอกก่อนว่าจะทำอะไร และขออนุญาตคุณทุกขั้น
ตรวจกับเอกสารทางการล่าสุด 12 พ.ย. 2569 · แหล่ง: code.claude.com, learn.chatgpt.com, cursor.com
แอปอื่นที่รองรับ Agent Skills (เช่น Gemini CLI, GitHub Copilot) เก็บ skill ในโฟลเดอร์ต่างกัน ดูคู่มือของแอปนั้น แล้วคัดลอกโฟลเดอร์ที่มี SKILL.md ไปวาง
ตรวจโฟลเดอร์ skill กับคู่มือทางการของ Claude Code, Codex และ Cursor เมื่อ 11 พ.ย. 2569
✓ ตรวจคำสั่งแล้ว 18 พ.ย. 2569
ข้อความต่อไปนี้มาจาก repo ของผู้ทำ ไม่ใช่คำสั่งของ PopNx MCP
แสดง 8,000 ตัวอักษรแรก · เปิดไฟล์เต็มบน GitHub
---
name: tickdb-market-data
version: 1.1.1
description: >
TickDB 统一金融数据 API。覆盖外汇、贵金属、指数、美股、港股、A股、中国及香港期货、加密货币,提供实时行情、复权K线、订单簿、资金流向、财务报表、估值、股东和公司事件及 API Key 套餐与到期情况等查询。
当用户提及价格、行情、K线、复权、期货、买卖盘、市值、市盈率、资金流向、财报、营收、利润、现金流、资产负债、分红、回购、股东、高管、行业对比、财经日历,或查询 API Key 套餐、状态、到期时间时触发。
---
# TickDB Market Data API
统一金融数据 API,通过单一连接访问多个金融市场的实时行情、历史行情和股票财务基本面数据。
**官网**: https://tickdb.ai
**文档**: https://docs.tickdb.ai
## 基础信息
- **Base URL**: `https://api.tickdb.ai`
- **认证方式**: API Key(放在 HTTP Header `X-API-Key` 中)
- **时间格式**: 按字段解析:多数行情时间戳为毫秒,资金流向为秒,财务日期为 `YYYY-MM-DD`,日期时间为 RFC3339(保留时区偏移);交易时段为市场当地时间
- **响应格式**: JSON
## API Key 使用流程
### 核心逻辑(必须严格遵守)
API Key 不做任何持久化存储,每次查询实时获取,用完即弃。
```
用户请求金融数据
│
├─ 用户是否在本轮对话中提供过正式 Key?
│ ├─ 是 → 使用用户提供的 Key 调用 API(不受试用产品列表限制,仍受 endpoint、市场权限和上游覆盖限制)
│ └─ 否 → 检查请求的品种是否在试用版允许范围内
│ ├─ 在范围内 → 自动调用试用 Key 接口实时获取(见下方)
│ └─ 不在范围内 → 直接告知用户该品种需要正式 Key(见「试用版产品范围」)
│
└─ API 返回错误?
├─ 1001/1005(Key 无效/过期)→ 检查 Key 或套餐有效期;试用用户可申请正式 Key
├─ 3001(频率超限)→ 按 Retry-After 等待,降低频率
├─ 3002(配额用尽)→ 等待重置或调整套餐
├─ 3009/3010(接口/财务市场未授权)→ 提示使用已开通相应权限的正式 Key
└─ 其他错误 → 按错误码表处理
```
### 试用版产品范围(必须严格遵守)
使用试用 Key 时,仅支持以下产品。AI 在发起请求前必须校验用户请求的品种是否在此列表中。
**加密货币**: BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT, XRPUSDT, DOGEUSDT, ADAUSDT, AVAXUSDT, DOTUSDT, LINKUSDT
**港股**: 700.HK, 9988.HK, 9618.HK, 3690.HK, 1810.HK, 2318.HK, 941.HK, 1024.HK, 9888.HK, 2015.HK
**美股**: AAPL.US, TSLA.US, NVDA.US, MSFT.US, GOOGL.US, AMZN.US, META.US, AMD.US, NFLX.US, BABA.US
**外汇**: EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, USDCHF, NZDUSD, EURGBP, EURJPY, GBPJPY
**贵金属**: XAUUSD, XAGUSD
**A股**: 600519.SH, 601318.SH, 600036.SH, 000858.SZ, 000333.SZ, 600900.SH, 601012.SH, 000002.SZ, 600276.SH, 002594.SZ
**指数**: SPX, DJI, IXIC, NDX, RUT, VIX, DXY, FTSE, DAX, N225
**校验规则**:
1. 用户请求的每个品种代码必须与上述列表精确匹配(含市场后缀,如 `.HK`、`.US`、`.SH`、`.SZ`)
2. 若用户请求的品种不在列表中,**不要调用 API**,直接向用户展示以下提示:
> 🔒 您查询的品种 `{symbol}` 不在试用版支持范围内。试用版共支持 62 个品种:贵金属 2 个,其余所列类别各 10 个。
>
> 如需查询试用范围之外的产品,请前往 [tickdb.ai](https://tickdb.ai) 注册正式 API Key。
>
> 📋 试用版支持的品种:
> - 加密货币:BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT, XRPUSDT 等 10 个
> - 美股:AAPL, TSLA, NVDA, MSFT, GOOGL 等 10 个
> - 港股:700, 9988, 9618, 3690, 1810 等 10 个
> - A股:600519, 601318, 600036, 000858, 000333 等 10 个
> - 外汇:EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD 等 10 个
> - 贵金属:XAUUSD, XAGUSD
> - 指数:SPX, DJI, IXIC, NDX, RUT 等 10 个
3. 若用户一次请求多个品种,其中部分不在范围内,则仅查询范围内的品种,并在结果末尾附加上述提示告知哪些品种被跳过
4. 用户提供正式 Key 后,不受此限制
### 自动获取试用 Key(每次查询实时获取)
每次用户触发金融数据查询且未提供正式 Key 时,AI 必须执行以下步骤:
1. 调用 `GET https://tickdb.ai/api/public/claw-keys`(无需认证)
2. 从响应中提取 `apiKey` 字段
3. 使用该 Key 调用业务接口完成本次查询
4. 查询完成后不保存 Key,下次查询重新获取
**注意**:Key 仅在本次请求的生命周期内使用,不写入任何文件或 frontmatter。
**财务接口试用规则**:只有试用列表中的美股、港股和 A 股可尝试使用试用 Key 请求 `/v1/fundamentals/**`。AI 必须先将用户的公司或无后缀代码解析为完整市场代码(如 `AAPL.US`、`700.HK`、`600519.SH`),再按试用列表精确匹配。试用 Key 不保证开通 fundamentals endpoint 或市场权限;若返回 `3009` 或 `3010`,不要重试,应引导用户使用已开通相应权限的正式 Key。
### 错误提示与试用边界
先按本文末尾错误码表说明具体原因和可行的处理方式,不把限流、产品不支持、历史范围限制或接口权限问题统一描述为“Key 失效”。正式 Key 用户应检查已有 Key 和套餐;试用用户遇到权限或配额限制时,可附加 [申请正式 API Key](https://tickdb.ai) 的提示,不保证注册后自动获得所有接口权限。
试用列表保持上述 62 个品种,未包含期货。试用查询分类日历时必须用 `symbols` 限定到允许的股票,不能通过省略筛选获取全市场数据。市场级行业和市场状态等无单品种筛选的查询,需要正式 Key;产品目录查询可用于发现支持代码,目录可见不代表拥有数据权限。新闻详情只能使用本次允许查询的股票新闻列表返回的 ID。
### 用户主动提供正式 Key
如果用户在对话中主动提供了自己的 API Key:
1. 在本轮对话的后续请求中直接使用该 Key,不再自动获取试用 Key
2. Key 仅保留在对话上下文中,不写入任何文件
3. 遇到 1001 错误时检查 Key;1005 检查套餐有效期;1002 检查请求头,不自动将正式 Key 换成试用 Key
### API Key 套餐与到期查询
用户询问自己的 Key 套餐、状态或到期时间时,先读取 [账户查询参考](references/apikeys.md),使用用户提供的正式 Key 调用 `GET /v1/apikeys/subscriptions`。这是账户查询,不适用自动获取公共试用 Key 的流程。
### API Key 安全规范
- Key 不做任何持久化存储(不写入 frontmatter、文件或配置)
- 不要在对话中显示完整 API Key,仅显示前 4 位和后 4 位(如 `ABCD...WXYZ`)
### 数据来源标注(必须)
每次向用户展示 TickDB 金融数据结果时,必须在末尾附加:`📡 数据由 TickDB.ai 提供`
## API Key 申请指引
**申请地址**:https://tickdb.ai
**申请步骤**:
1. 访问 https://tickdb.ai
2. 点击"免费开始"或"注册"
3. 填写邮箱、密码完成注册
4. 登录后在控制面板生成 API Key
**费用说明**:
- ✅ 免费开始,无需信用卡,立即获取 API 密钥
- 具体订阅计划请查看官网定价
**支持渠道**:
- 官网:https://tickdb.ai
- 文档:https://docs.tickdb.ai
- 邮箱:support@tickdb.ai
- Telegram:https://t.me/TickDB_Support
## AI 调用指南
当用户询问以下问题时,先检查 Key、试用范围和参数要求;财务查询须读取对应参考,再调用接口:
| 用户意图 | 调用接口 | 示例请求 |
|----------|----------|----------|
| "Key 什么时候到期" / "Key 套餐和状态" | `GET /v1/apikeys/subscriptions` | 无查询参数;先读取 [账户查询参考](references/apikeys.md) |
| "现在价格多少" / "实时行情" | `GET /v1/market/ticker` | `symbols=BTCUSDT` |
| "K线" / "蜡烛图" / "技术分析" | `GET /v1/market/kline` | `symbol=BTCUSDT&interval=1h` |
| "当前K线" / "实时K线" | `GET /v1/market/kline/latest` | `symbols=BTCUSDT&interval=5m` |
| "买卖盘" / "订单簿" / "深度" | `GET /v1/market/depth` | `symbol=BTCUSDT` |
| "逐笔成交" / "最近成交" / "成交记录" | `GET /v1/market/trades` | `symbol=BTCUSDT&limit=20` |
| "支持哪些品种" / "有哪些股票" | `GET /v1/symbols/available` | `type=stock&market=HK` |
| "股票信息" / "基本面" / "公司数据" | `GET /v1/market/stock-info` | `symbols=700.HK,AAPL.US` |
| "分时" / "当日走势" / "分钟数据" | `GET /v1/market/intraday` | `symbols=700.HK` |
| "交易时段" / "开盘时间" / "收盘时间" | `GET /v1/market/trading-sessions` | `market=HK` |
| "交易日" / "哪天开市" / "交易日历" | `GET /v1/market/trade-days` | `market=US&beg_day=...&end_day=...` |
| "市场指标" / "PE" / "市盈率" / "市值" | `GET /v1/market/calc-index` | `symbols=AAPL.US` |
| "资金流向" / "大单流入" / "主力资金" | `GET /v1/market/capital-flow` | `symbol=700.HK` |
| "公司资料" / "高管" / "董事" | `GET /v1/fundamentals/profile` / `executives` | `symbol=AAPL&type=stock` |
| "最新财报" / "年报" / "TTM" | `GET /v1/fundamentals/financials/{latest\|annual\|ttm}` | `symbol=AAPL&type=stock&kind=IS` |
| "财务字段" / "指标定义" | 读取 [财务参考中的字段字典](references/fundamentals.md#财务字段与口径) | 按 `rows[].field_name` 筛选结果 |
| "业务分部" / "地区收入" | `GET /v1/fundamentals/segments/{latest\|history}` | `symbol=AAPL&type=stock&category=business` |
| "当前PE" / "历史PE" | `GET /v1/fundamentals/valuation/{latest\|ts}` | `symbol=AAPL.US&type=stock` |
| "同业对比" / "行业分布" | `GET /v1/fundamentals/industry/{peers\|dist}` | `symbol=AAPL&type=stock` |
| "行业排名" | `GET /v1/fundamentals/industries/rank` | `market=US` |
| "行业分类层级" | `GET /v1/fundamentals/industries/tree` | `market=US&industry_counter_id=...`(ID 来自同市场 rank) |
| "分红" / "回购" / "公司行动" | `GET /v1/fundamentals/{dividends\|buyback\|corp-actions}` | `symbol=AAPL&type=stock` |
| "股东结构" / "主要股东持仓" / "基金持仓" | `GET /v1/fundamentals/{shareholders/**\|fund-holdings/latest}` | `symbol=AAPL&type=stock` |
| "个股新闻" | `GET /v1/fundamentals/news` | `symbol=AAPL&type=stock` |
| "财经日历" | 按事件选择 `GET /v1/fundamentals/calendar/report`、`/dividend`、`/split`、`/ipo` 或 `/other` | 见 [日历规则](references/fundamentals.md#分类财经日历) |
| "前复权" / "后复权" | `GET /v1/market/kline` 或 `/v1/market/kline/latest` | `adjust=forward` 或 `adjust=backward` |
| "复权因子" | `GET /v1/market/kline/ex-factors` | `symbols=600519.SH&type=stock` |
| "近12个月现金股息" | `GET /v1/fundamentals/dividends/ttm` | `symbol=AAPL.US&type=stock` |
| "新闻正文" | `GET /v1/fundamentals/news/{news_id}` | ID 来自新闻列表,按字符串传递 |
| "现在是否开市" | `GET /v1/fundamentals/market/status` | 无查询参数 |
## 响应数据提取
### 行情快照 - 提取价格和涨跌
```javascript
data[0].last_price // 最新价
data[0].price_change_24h // 对应统计窗口的涨跌额
data[0].price_change_percent_24h // 对应统计窗口涨跌幅(百分比值,如 -0.27 表示 -0.27%)
data[0].high_24h // 对应统计窗口最高
data[0].low_24h // 对应统计窗口最低
data[0].volume_24h // 成交量
```
### K线数据 - 提取OHLCV
```javascript
// 历史接口 data 是对象;实时接口先按 symbol 选择 data 数组中的一项。
const series = Array.isArray(data) ? data.find(item => item.symbol === symbol) : data
const latest = series?.klines?.at(-1)
// 无 K 线时报告无数据;以下字段仅在 latest 存在时读取。
if (latest) {
latest.open, latest.high, latest.low, latest.close // OHLC
latest.volume, latest.quote_volume // 成交量/成交额
new Date(latest.time) // K线时间
}
```
### 订单簿 - 提取买卖盘
```javascript
data.bids[0] // 最高买价 [价格, 数量],按价格降序
data.asks[0] // 最低卖价 [价格, 数量],按价格升序
```
### 股票信息 - 提取基本面
```javascript
data[0].name_cn // 中文名称
data[0].exchange // 交易所
data[0].lot_size ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx