프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

What it does

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股、外汇、期货、指数、大宗商品、加密货币。

  • Connects Instruction files the AI reads, with steps that call an outside service
  • Account or key Some steps need a key for TICKDB_API_KEY, MCP_ACCESS_TOKEN (per the README)
  • Category 데이터와 리서치
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/tickdb-tickdb-unified-realtime-marketdata-api.svg)](https://mcp.popnx.com/en/skills/tickdb-tickdb-unified-realtime-marketdata-api)

함께 쓰기

같은 작업에서 AI를 서비스에 연결하는 MCP

Firebase MCP

Gives AI development tools Firebase-specific capabilities and expertise.

제작자: firebase널리 사용됨↓ 490.6만/주★ 4.5천 저장소 전체의 별12개월 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

Supabase

MCP server for interacting with the Supabase platform

제작자: supabase널리 사용됨↓ 24.6만/주★ 3천 저장소 전체의 별오늘 업데이트

MCP · 서비스 연결컴퓨터 또는 클라우드✓ 서비스 회사 · supabase.com

Dbx

Query databases from AI agents using connections configured in DBX.

제작자: t8y2널리 사용됨↓ 9.4천/주★ 3.1만7개월 전 업데이트

MCP · 서비스 연결내 컴퓨터에서 실행

비슷한 Skill

같은 종류의 작업, Skill 목록과 같은 순서

비슷한 항목과 비교
이 항목
tickdb-unified-realtime-marketdata-api
timesfmShadowbrokergoogle-maps-scrapertradingview-mcp
제작자TickDBgoogle-researchBigBodyCobaingosomatilaahmettaner
Skill 수11111
GitHub 별93335,62911,6028,2095,307
마지막 코드 변경2026년 11월 6일2026년 11월 13일2026년 11월 17일2026년 11월 15일2026년 11월 15일
라이선스MITApache-2.0AGPL-3.0MITMIT

TickDB의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요

Skill과 MCP의 차이

MCP = 손

AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.

Skill = 안내서

작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.

겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.

쓸 수 있는 앱

Claude (เว็บ/แอป)

제작자 README와 repo 폴더 기준

설치

Is it safe?

  • Who made it

    GitHub account TickDB (person) is only 10 months old: take extra care

  • Use and upkeep

    ★ 933 stars · code last changed 2026년 11월 6일

  • Any scripts?

    1 scripts that can run on a computer: SKILL.md

  • Uses the internet?

    Scripts that go online: SKILL.md

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit b09e9ef (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

먼저: 어떤 AI를 쓰시나요

쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (212). Use "Let the AI install it" instead

Option 1Claude Code에게 설치 맡기기

이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요

Where to install
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) for all my projects, at ~/.claude/skills/tickdb-market-data. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) into the project this chat is open in (at .claude/skills/tickdb-market-data). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Claude Code를 다시 열고 /SKILL를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

Checked against official docs 2026년 11월 12일 · Source: code.claude.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.claude/skills에 복사

    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/SKILL
  3. Claude Code를 다시 열고 /SKILL를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요

직접 설치한 Skill은 ChatGPT 데스크톱 앱, Codex CLI, IDE의 Codex 확장 프로그램에서 쓸 수 있습니다 · 웹과 모바일의 ChatGPT에서는 직접 설치한 Skill을 쓸 수 없고 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

ChatGPT 데스크톱 앱

ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다

Option 1ChatGPT에게 설치 맡기기

ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요

Where to install
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) for all my projects, at ~/.agents/skills/tickdb-market-data. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) into the project this chat is open in (at .agents/skills/tickdb-market-data). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2폴더를 직접 넣기

tickdb-market-data 폴더를 ~/.agents/skills/tickdb-market-data에 넣으세요

~는 홈 폴더($HOME)입니다

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    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

설치한 뒤

  • ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
  • 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
  • Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

웹과 모바일의 ChatGPT

직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다

이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

Option 1Codex에게 설치 맡기기

이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다

Where to install
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) for all my projects, at ~/.agents/skills/tickdb-market-data. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) into the project this chat is open in (at .agents/skills/tickdb-market-data). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요

Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.agents/skills에 복사

    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
  3. Codex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요

Option 1Cursor에게 설치 맡기기

이 문장을 복사해 Cursor 채팅에 붙여 넣으세요

Where to install
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) for all my projects, at ~/.cursor/skills/tickdb-market-data. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) into the project this chat is open in (at .cursor/skills/tickdb-market-data). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Cursor Agent 채팅에서 /를 입력하고 SKILL 선택

Checked against official docs 2026년 11월 12일 · Source: cursor.com

For Terminal users

Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.

  1. 터미널 열기

    Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요

  2. skill 폴더를 ~/.cursor/skills에 복사

    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
  3. Cursor Agent 채팅에서 /를 입력하고 SKILL 선택

Option 1Let the AI install it

Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat

Where to install
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) for all my projects, at ~/.claude/skills/tickdb-market-data (in Codex use ~/.agents/skills/tickdb-market-data, in Cursor ~/.cursor/skills/tickdb-market-data). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill tickdb-market-data from https://github.com/tickdb/tickdb-unified-realtime-marketdata-api folder SKILL (commit b09e9ef) into the project this chat is open in (at .claude/skills/tickdb-market-data; in Codex use .agents/skills/tickdb-market-data, in Cursor .cursor/skills/tickdb-market-data). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.

GitHub에서 보기 ↗

2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인

✓ 명령 확인 2026년 11월 18일

원본 SKILL.md 보기

아래 글은 제작자 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 팀의 글이 아니에요.

로그인하고 글쓰기

GitHub 정보

GitHub 스타
933
제작자
TickDB
라이선스
MIT
최근 코드 수정
2026년 11월 6일
repo 안 SKILL.md(번역본과 템플릿 포함)
1
토픽
ai-agents, cli-tool, commodities, financial-analysis, financial-data, forex, futures, indices, market-data, mcp, order-book, real-time