What makes TickDB Real-time Market Data API notable?

2.5K downloads. Trust evidence available

How should TickDB Real-time Market Data API be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

TickDB Real-time Market Data API

TickDB 统一金融数据 API。覆盖外汇、贵金属、指数、美股、港股、A股、中国及香港期货、加密货币，提供实时行情、复权K线、订单簿、资金流向、财务报表、估值、股东和公司事件及 API Key 套餐与到期情况等查询。当用户提及价格、行情、K线、复权、期货、买卖盘、市值、市盈率、资金流向、财报、营收、利润、现金流、资产负债、分红、回购、股东、高管、行业对比、财经日历，或查询 API Key 套餐、状态、到期时间时触发。 Skill: TickDB Real-time Market Data API Owner: tickdb Summary: TickDB 统一金融数据 API。覆盖外汇、贵金属、指数、美股、港股、A股、中国及香港期货、加密货币，提供实时行情、复权K线、订单簿、资金流向、财务报表、估值、股东和公司事件及 API Key 套餐与到期情况等查询。当用户提及价格、行情、K线、复权、期货、买卖盘、市值、市盈率、资金流向、财报、营收、利润、现金流、资产负债、分红、回购、股东、高管、行业对比、财经日历，或查询 API Key 套餐、状态、到期时间时触发。 Tags: api:1.0.7, finance:1.0.7, forex:1.0.7, gold:1.0.4, indices:1.0.7, kline:1.0.4, latest:1.1.1, market-data:1.0.7, realtime:1.0.0, stock:1.0.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.5k

Updated

Oct 9, 2026

Version

1.1.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.5K downloadsadoption · observed Oct 9, 2026
Latest release: 1.1.1release · observed Sep 27, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s177majr951dd6bjydzn5pkhy983g1yg:tickdb-market-data

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tickdb-tickdb-market-data/snapshot"

Documentation

CLAWHUB

144,641 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
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}` 不在试用版支持范围内。试用版共支持 72 个品种：贵金属 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 不保证开通 fu

_meta.json

{
  "ownerId": "kn7dcywvt7kepem7sd31eg42dd83e5qm",
  "slug": "tickdb-market-data",
  "version": "1.1.1",
  "publishedAt": 1790537484248
}

references/apikeys.md

# API Key 套餐与到期查询

依据用户补充的接口截图及生产只读验证。本端点尚未包含在归档的原始 OpenAPI 文档包中；不能据此推断还有其他账户管理接口。

`GET https://api.tickdb.ai/v1/apikeys/subscriptions`

用途：查询当前认证账户下返回的 API Key 列表、套餐、状态及到期情况。使用用户提供的正式 Key，通过必填请求头 `X-API-Key` 认证；无需登录网页。不传查询参数或请求体。

```bash
curl --request GET "https://api.tickdb.ai/v1/apikeys/subscriptions" \
  --header "X-API-Key: YOUR_API_KEY"
```

这是账户查询，不能自动获取公共试用 Key 代替用户的账户凭据。未提供本人账户 Key 时，请用户提供已配置的环境变量名或凭据路径。除非用户要求查询套餐或到期情况，不要为普通行情查询额外调用该端点。

## 响应字段

成功需 HTTP 200 且 `code=0`，主数据为 `response.data`：

| 字段 | 说明 |
|---|---|
| user_id | 当前认证账户标识；无需在普通结果中展示 |
| server_time | 服务端计算时间，RFC3339，解析时保留时区与小数秒 |
| total | 本次返回的 Key 数量 |
| api_keys[] | API Key 记录数组，不是只有本次认证 Key 的单条对象 |
| api_keys[].id | 记录 ID，不是可用于认证的 Key |
| api_keys[].key_prefix | Key 前缀，用于辅助识别；不能拼接、还原或用作认证 Key |
| api_keys[].name | Key 名称 |
| api_keys[].plan | 套餐名称；例如 professional，不将示例当作完整枚举 |
| api_keys[].status | 状态；例如 active，不将示例当作完整枚举 |
| api_keys[].expires_at | 到期时间，RFC3339 |
| api_keys[].remaining_seconds | 以服务端时间计算的剩余秒数 |
| api_keys[].created_at | 创建时间，RFC3339 |

## 展示和错误处理

- 默认展示名称、必要的脱敏识别、套餐、原始状态、到期时间和剩余时长，不显示 user_id、记录 ID 或完整 Key；不把原始账户响应保存到日志或报告。
- 用 `server_time` 解读 `remaining_seconds`；天数可按 86400 秒换算并注明取整方式。到期时间可以转换为用户时区，须标明时区，不能用本机日期代替服务端计算时间。
- 不按列表顺序、名称或前缀唯一性猜测“当前使用的 Key”；如果无法唯一匹配用户所指记录，应先澄清。
- 不因 status=active 就承诺所有市场、接口或配额均可用；本端点不是完整权限清单。null、未知状态或未说明的长期有效形式按原值说明，不推断为永久有效。
- 空列表说明本次返回零条，不能改称认证失败。HTTP 401/1002 表示缺认证；401/1001（含已知文本业务码）表示无效或已过期；其余按 [HTTP 错误参考](errors.md) 处理，不自动切换试用 Key。
- 本端点仅查询，不支持创建、续费、撤销、修改 Key，也不会自行建立定时提醒。

references/errors.md

# 错误码与处理参考

依据 2026-09-21 文档包中的错误码正文。HTTP 状态与业务 code 同时判断，先 String(code) 再匹配，并应用下述有明确 HTTP 状态约束的兼容规则。不要根据 message 文本写程序分支；message 和 data 可用于解释具体修正方式。

## 生产兼容规则

2026-09-21 生产实测：HTTP 401 的 `code` 字段可能为 `Invalid or expired token`。仅对该状态与该 code 的精确组合归一化为认证失败 `1001`，保留 `raw_code`；提示“API Key 无效或已过期，请检查原 Key 和有效期”。该兼容码不能区分无效与过期，不要声称已确定原因。数字 `1005` 仍按过期处理。不得根据 `message` 内容进行该映射，也不要将其他 HTTP 状态下的同名文本自动映射。

```python
def normalize_error_code(http_status, code):
    raw = str(code)
    if http_status == 401 and raw == "Invalid or expired token":
        return "1001"
    return raw
```

财经日历参数错误应兼容 HTTP 400 / `2001`（入口参数校验）和 HTTP 400 / `40001`（财务参数错误）；这不是成功响应。生产中其他财经日历缺少 `category` 返回 `2001`，请求前仍须检查必填 category。不能推断所有参数错误都会经过同一层；这两种代码均提示修正参数，保留具体原始码。

## 认证与用户提示

- 1001：Key 无效；1005：Key 过期。正式 Key 用户检查原 Key、套餐有效期或联系支持；试用用户可申请正式 Key。
- 1002：先检查 X-API-Key 请求头；只有用户未提供正式 Key、请求符合试用范围时，才按 SKILL.md 的流程获取试用 Key。
- 3001/3005：先等待和降频；3002：等待配额重置或调整套餐。不要通过反复获取试用 Key 绕过限制。
- 3006–3012：准确说明产品、历史范围、接口、市场或批量限制，不笼统称为 Key 失效，也不承诺注册即可解锁。
- 40404/40405：向用户说明资源或当前筛选无数据，不补造结果。只有服务错误才提示稍后重试；重试须有限且有明确依据。
- 5005/5006：可以向用户说明可改用不复权或另一周期，但不得悄悄改变用户要求的复权方式。

## 错误码速查表

### 认证错误（1xxx）

| 错误码 | HTTP／场景 | 含义 | 处理建议 |
| ---: | --- | --- | --- |
| `1001` | 401 | API Key 无效 | 检查 API Key 是否正确 |
| `1002` | 401 | 未提供 API Key | 在请求头中添加 `X-API-Key` |
| `1004` | 403 | 权限不足 | 检查当前套餐权限 |
| `1005` | 401 | API Key 已过期 | 续费或升级套餐后重试 |

### 参数错误（2xxx）

| 错误码 | HTTP／场景 | 含义 | 处理建议 |
| ---: | --- | --- | --- |
| `2001` | 400 | 请求参数错误 | 根据 `message` 检查缺失参数、格式或参数组合 |
| `2002` | 404 | 交易品种不存在或不受支持 | 使用 `/v1/symbols/available` 查询可用代码 |
| `2003` | 400 | 时间范围无效 | 根据 `message` 和 `data` 修正时间 |
| `2004` | 400 | 请求数量超过接口限制 | 根据对应接口说明减少请求数量 |
| `2005` | 400 | 交易产品代码格式不受支持 | 使用数据规范中公开的代码格式 |
| `2006` | 400 | 代码后缀与请求的 `type` 冲突 | 修正代码或 `type`，确保二者一致 |


错误码名称不是所有接口的统一触发保证。历史 K 线中 `start_time` 晚于 `end_time` 当前返回字符串 `"2001"`；`limit` 大于 1000 时按 1000 处理，非正数使用默认值 100，不会因此返回 `2004`。其他接口是否拒绝超限请求，以对应接口说明和实际响应为准。


HTTP 请求中的代码歧义返回字符串 `AMBIGUOUS_SYMBOL`，应根据响应中的 `available_types` 补充 `type`。

### 访问限制与配额错误（3xxx）

| 错误码 | HTTP／场景 | 含义 | 处理建议 |
| ---: | --- | --- | --- |
| `3001` | 429 | 请求频率超限 | 根据 `Retry-After` 等待后重试 |
| `3002` | 403 | 配额已用尽 | 等待配额重置或升级套餐 |
| `3005` | 429 | 该代码短时间内请求过于频繁 | 短暂等待后重试，避免集中重复请求同一代码 |
| `3006` | 403 | 当前套餐不支持该交易产品 | 更换产品或调整套餐 |
| `3007` | 403 | K 线查询范围超过当前套餐限制 | 缩短历史范围或调整套餐 |
| `3008` | 403 | 当前套餐不支持按时间范围查询 K 线 | 改用支持的查询方式或调整套餐 |
| `3009` | 403 | 当前 API Key 无权访问该接口 | 检查 API Key 权限或调整套餐 |
| `3010` | 403 | 当前 API Key 无权访问该市场的财务与基本面数据 | 更换市场或调整套餐 |
| `3011` | 403 | 财务与基本面历史查询深度超过限制 | 缩短历史范围或调整套餐 |
| `3012` | 403 | 财务与基本面批量查询数量超过限制 | 减少单次查询的代码数量 |

### 服务错误（5xxx）

| 错误码 | HTTP／场景 | 含义 | 处理建议 |
| ---: | --- | --- | --- |
| `5000` | 500 | 服务器内部错误 | 稍后重试；持续出现时联系支持 |
| `5001` | 503 | 市场数据暂不可用 | 稍后重试 |
| `5002` | 503 | 服务暂时不可用 | 稍后重试 |
| `5003` | 503 | 当前请求暂无可用的数据服务 | 稍后重试，或更换交易产品／查询条件 |
| `5004` | 503 | 实时行情暂不可用 | 稍后重试响应中标记为可重试的代码 |
|

references/fundamentals.md

# 财务基本面接口参考

所有端点使用 `GET https://api.tickdb.ai` 和 `X-API-Key`。本文件中的路径都是完整端点，查询规则以 2026-09-21 文档包为依据。

## 共同规则

- 单股接口必填 `symbol`，可选 `type=stock`；支持美股、港股、A股。优先使用完整代码，如 `AAPL.US`、`700.HK`、`600519.SH`，试用前按 SKILL.md 的列表精确校验。
- 市场级行业接口传 `market`；分类日历传其筛选条件；新闻详情只传 path ID；市场状态不传查询参数。不要将单股参数套到所有接口。
- 成功主数据位于 `response.data`，不要求存在 `meta` 或 `fetched_at`，不能补造缺失的数据时间。披露日期、事件日期、数据查询时间须区分。
- 数值可能为字符串或 null；计算前确认币种、单位和百分比口径，再显式转换。缺失不是零；带 `%` 或 `<0.01%` 的文本不得直接当普通数值。
- 分红、持股基金、五类日历分页都在顶层 `response.page`。第一页不传 cursor，后续原样传 `page.next_cursor`，保留原筛选条件和 limit；null 表示末页。不要自行解码或递增游标，未翻完页时不能称为完整结果。
- `40404` 为资源不存在，`40405` 为当前筛选无业务数据；日历无事件返回成功空数组。新闻错误映射可能不同，按实际 HTTP 状态和 code 处理。

## 公司与财务报表

| 端点 | 参数（除特别注明外 symbol 必填、type=stock 可选） | data 主要字段 |
|---|---|---|
| `/v1/fundamentals/profile` | symbol、type | symbol、market、region、company_name、name、profile、address、office_address、phone、email、website、founded、listing_date、year_end、employees、chairman、manager、secretary、legal_repr、accounting_firm、legal_counsel、category |
| `/v1/fundamentals/executives` | symbol、type | symbol、total、members[]：name、title、biography |
| `/v1/fundamentals/financials/latest` | 必填 kind=IS/BS/CF；可选 n=1..20、period_type | symbol、kind、rows[] |
| `/v1/fundamentals/financials/annual` | 必填 kind=IS/BS/CF；可选 n=1..20 | symbol、kind、rows[] |
| `/v1/fundamentals/financials/ttm` | 必填 kind=IS/CF | symbol、kind、rows[] |

`n` 是报告期数或年度数，不是行数。`rows[]` 是字段级记录：`kind`、`field_name`、`field_display`、`indicator_title`、`value`（字符串）、`currency`、`is_percent`、`fiscal_year`、`fiscal_period`、`period_type`、`period_end`（YYYY-MM-DD）、`yoy`、`ratio`。

`latest.period_type` 可为 q1/q2/q3/q4/saf/af 及其逗号组合；默认 q1,q2,q3,q4。`qf` 是营收构成报告周期，不是此参数的合法值。年度通常为 af，也可能以 q4 表示年末报告。TTM 由最近四个有效单季汇总，period_type=ttm；BS 是时点数据，不可用于 TTM。

### 财务字段与口径

当前公开文档提供静态字段字典，不提供字段查询 API 或 `fields` 过滤参数。根据返回的 `field_name` 在客户端筛选；指标名称以 `indicator_title`、`field_display` 和字典共同解释，不猜测未知代码。

| 报表 | 金额/每股金额字段 | 比率或百分比字段 | TTM 可汇总字段 |
|---|---|---|---|
| IS | EPS（每股收益）、NetProfit（净利润）、OperatingIncome（营业利润）、OperatingRevenue（营业收入） | GrossMgn（毛利率）、NetProfitMargin/NetProfitMarginDf（净利率）、ProfitQuality（利润含金量）、ROE/ROEDf | EPS、NetProfit、OperatingIncome、OperatingRevenue |
| BS | BPS、CashSTInvest、Inventory、LTInvest、NPPE、NetDebt、TotalAssets、TotalLiability、TotalReceiv | AssetTurn/AssetTurnDf、Leverage 为倍数 | 不适用 |
| CF | CapEx、NetFinanceCashFlow、NetFreeCashFlow、NetInvestCashFlow、NetOperateCashFlow、TotalDebtIssued、TotalDebtRepaid | OCFCoverage 为百分比 | CapEx、NetFinanceCashFlow、NetFreeCashFlow、NetInvestCashFlow、NetOperateCashFlow、TotalDebtRepaid |

币种由每条记录的 `currency` 决定，百分比看 `is_percent`，其他倍数不能当百分比。字典标记适用也不保证当前公司具有可汇总数据。

```bash
# 先查询最近四期利润表，再从 rows 中筛选 OperatingRevenue 和 NetProfit。
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.tickdb.ai/v1/fundamentals/financials/latest?symbol=AAPL.US&type=stock&kind=IS&n=4"
```

## 营收构成、PE 与行业

| 端点 | 参数 | data 主要字段 |
|---|---|---|
| `/v1/fundamentals/segments/latest` | 必填 symbol；可选 type=stock、category=business/reg

Github ReposUpdated 4h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.