rootdata-crypto-plugin

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Pre-flight Dependencies (auto-injected by Plugin Store CI)

前置依赖项（由插件商店CI自动注入）

Run once per session before first use. These checks ensure required tools are installed.

首次使用前，每个会话运行一次。这些检查确保所需工具已安装。

Version check (auto-injected)

版本检查（自动注入）

AI Agent Instruction: Run this version check before executing any commands from this skill. If an update is applied, re-read this SKILL.md before proceeding — the instructions may have changed.

bash

undefined

AI Agent 指令：执行本技能的任何命令前，请运行此版本检查。如果应用了更新，请在继续前重新阅读本SKILL.md——说明可能已更改。

bash

undefined

Check for skill updates (1-hour cache)

UPDATE_CACHE="$HOME/.plugin-store/update-cache/rootdata-crypto-plugin" CACHE_MAX=3600 LOCAL_VER="1.0.0" DO_CHECK=true

if [ -f "$UPDATE_CACHE" ]; then CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0) NOW=$(date +%s) AGE=$(( NOW - CACHE_MOD )) [ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false fi

if [ "$DO_CHECK" = true ]; then REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/rootdata-crypto-plugin/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}') if [ -n "$REMOTE_VER" ]; then mkdir -p "$HOME/.plugin-store/update-cache" echo "$REMOTE_VER" > "$UPDATE_CACHE" fi fi

REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER") if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then echo "Update available: rootdata-crypto-plugin v$LOCAL_VER -> v$REMOTE_VER. Updating..." npx skills add okx/plugin-store --skill rootdata-crypto-plugin --yes --global 2>/dev/null || true echo "Updated rootdata-crypto-plugin to v$REMOTE_VER. Please re-read this SKILL.md." fi

---

UPDATE_CACHE="$HOME/.plugin-store/update-cache/rootdata-crypto-plugin" CACHE_MAX=3600 LOCAL_VER="1.0.0" DO_CHECK=true

---

RootData Crypto Intelligence (OKX Edition)

RootData 加密货币情报（OKX版）

Overview

概述

RootData is a leading Web3 data platform covering crypto projects, investors, funding data, and personnel movements. This skill is the OKX-dedicated integration, isolated from the standard RootData skill with its own API key namespace and endpoints.

RootData是领先的Web3数据平台，涵盖加密项目、投资者、融资数据以及人员变动信息。本技能是OKX专属集成版本，与标准RootData技能相互独立，拥有独立的API密钥命名空间和端点。

Pre-flight Checks

前置检查

Before using this skill, ensure:

Check if the environment variable
```
OKX_ROOTDATA_SKILL_KEY
```
exists.
If it does NOT exist, call the
```
/init
```
command below to generate a key and save it.

All subsequent requests must include

Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}

and

Content-Type: application/json

使用本技能前，请确保：

检查环境变量
```
OKX_ROOTDATA_SKILL_KEY
```
是否存在。
如果不存在，请调用下方的
```
/init
```
命令生成并保存密钥。

所有后续请求必须包含

Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}

和

Content-Type: application/json

。

Initialize API Key

初始化API密钥

POST https://api.rootdata.com/open/okx/skill/init

When to use: First-time setup, or when

OKX_ROOTDATA_SKILL_KEY

is missing or invalid. Output: Returns

api_key

(prefixed with

okxsk_

). Save it as

OKX_ROOTDATA_SKILL_KEY

. Example:

POST https://api.rootdata.com/open/okx/skill/init
Content-Type: application/json
Body: {}

Response:

json

{
  "result": 200,
  "data": {
    "api_key": "okxsk_xxxxxxxxxxxxxxxx"
  }
}

After saving, confirm to user: "RootData (OKX) access is ready. You can now query crypto data."

POST https://api.rootdata.com/open/okx/skill/init

使用场景：首次设置，或

OKX_ROOTDATA_SKILL_KEY

缺失、无效时。输出：返回前缀为

okxsk_

的

api_key

。请将其保存为

OKX_ROOTDATA_SKILL_KEY

。示例：

POST https://api.rootdata.com/open/okx/skill/init
Content-Type: application/json
Body: {}

响应：

json

{
  "result": 200,
  "data": {
    "api_key": "okxsk_xxxxxxxxxxxxxxxx"
  }
}

保存完成后，向用户确认："RootData (OKX) 访问已就绪，您现在可以查询加密货币数据。"

Commands

命令

All requests must include:

Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}
Content-Type: application/json

所有请求必须包含：

Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}
Content-Type: application/json

Search

搜索

POST https://api.rootdata.com/open/okx/skill/ser_inv

When to use: User wants to search for a crypto project, investor institution, or person by name keyword. Use this as the first step when an entity ID is not yet known. Output: A list of matching entities with their IDs, types, names, and descriptions. Example:

json

{
  "query": "Uniswap",
  "precise_x_search": false
}

Key response fields:

```
id
```
- entity ID (use for follow-up queries)
```
type
```
-
```
1
```
=Project,
```
2
```
=VC/Institution,
```
3
```
=Person
```
name
```
- display name
```
one_liner
```
- brief description
```
introduce
```
- full description
```
rootdataurl
```
- link to full detail page on RootData

POST https://api.rootdata.com/open/okx/skill/ser_inv

使用场景：用户希望通过名称关键词搜索加密项目、投资机构或个人。当尚未知晓实体ID时，将此作为第一步操作。输出：匹配实体的列表，包含ID、类型、名称和描述。示例：

json

{
  "query": "Uniswap",
  "precise_x_search": false
}

关键响应字段：

```
id
```
- 实体ID（用于后续查询）
```
type
```
-
```
1
```
=项目，
```
2
```
=风投/机构，
```
3
```
=个人
```
name
```
- 显示名称
```
one_liner
```
- 简短描述
```
introduce
```
- 完整描述
```
rootdataurl
```
- RootData平台上的完整详情页链接

Get All IDs by Type

按类型获取所有ID

POST https://api.rootdata.com/open/okx/skill/id_map

When to use: User asks for a complete list of all project IDs, institution IDs, or person IDs for bulk lookup or enumeration. Output: Array of

{ id, name }

entries for all entities of the specified type. Example:

json

{
  "type": 1
}

type

values:

=Project,

=VC/Institution,

=Person

Key response fields:

```
id
```
- entity ID
```
name
```
- entity name

POST https://api.rootdata.com/open/okx/skill/id_map

使用场景：用户需要获取所有项目ID、机构ID或个人ID的完整列表，用于批量查询或枚举。输出：指定类型所有实体的

{ id, name }

条目数组。示例：

json

{
  "type": 1
}

type

取值：

=项目，

=风投/机构，

=个人

关键响应字段：

```
id
```
- 实体ID
```
name
```
- 实体名称

Project Detail

项目详情

POST https://api.rootdata.com/open/okx/skill/get_item

When to use: User asks for detailed information about a specific crypto project, including its description, funding total, investors, tags, and social links. Output: Full project profile including funding summary, contracts, social media, and investor list. Example (by project ID):

json

{
  "project_id": 12345,
  "include_investors": true
}

Or by contract address:

json

{
  "contract_address": "0xabc123...",
  "include_investors": true
}

Key response fields:

```
project_id
```
,
```
project_name
```
,
```
logo
```
,
```
token_symbol
```
```
one_liner
```
,
```
description
```
```
active
```
- whether the project is still active
```
establishment_date
```
- founding date
```
tags
```
- category tags (e.g. DeFi, Layer2, NFT)
```
contracts
```
- on-chain contract addresses
```
total_funding
```
- total funding raised (USD)
```
social_media
```
- website, X(Twitter), GitHub, CoinMarketCap, CoinGecko, etc.
```
investors
```
- list of investors (only when
```
include_investors=true
```
)
```
similar_project
```
- similar projects in same category
```
rootdataurl
```
- RootData detail page link

POST https://api.rootdata.com/open/okx/skill/get_item

使用场景：用户查询特定加密项目的详细信息，包括项目描述、总融资额、投资者、标签和社交链接。输出：完整的项目档案，包含融资摘要、合约地址、社交媒体和投资者列表。示例（通过项目ID）：

json

{
  "project_id": 12345,
  "include_investors": true
}

或通过合约地址：

json

{
  "contract_address": "0xabc123...",
  "include_investors": true
}

关键响应字段：

```
project_id
```
,
```
project_name
```
,
```
logo
```
,
```
token_symbol
```
```
one_liner
```
,
```
description
```
```
active
```
- 项目是否仍在运营
```
establishment_date
```
- 成立日期
```
tags
```
- 分类标签（如DeFi、Layer2、NFT）
```
contracts
```
- 链上合约地址
```
total_funding
```
- 总融资额（美元）
```
social_media
```
- 官网、X(Twitter)、GitHub、CoinMarketCap、CoinGecko等
```
investors
```
- 投资者列表（仅当
```
include_investors=true
```
时返回）
```
similar_project
```
- 同类别相似项目
```
rootdataurl
```
- RootData详情页链接

Funding Rounds

融资轮次

POST https://api.rootdata.com/open/okx/skill/get_fac

When to use: User asks about funding history, investment rounds, "how much did XX raise", "who invested in XX", or requests a list of recent fundraises.

Data range: Covers funding rounds from the past 365 days only. Requests for older data will automatically return only the most recent 365 days.

Investor limit: Each funding round returns a maximum of 3 investors (lead investors prioritized).

Output: Paginated list of funding rounds with project info and investor details. Example:

json

{
  "page": 1,
  "page_size": 20,
  "project_id": 12345,
  "start_time": "2025-01-01",
  "end_time": "2026-03-30",
  "min_amount": 1000000,
  "max_amount": 50000000
}

All fields except

page

and

page_size

are optional. Omit any field not specified by the user.

Key response fields:

```
total
```
- total matching records
```
items
```
- list of funding rounds, each containing:
- ```
name
```
  - project name
- ```
logo
```
  - project logo
- ```
rounds
```
  - round type (Seed / Series A / Series B / etc.)
- ```
published_time
```
  - announcement date
- ```
amount
```
  - funding amount (USD)
- ```
project_id
```
  - project ID
- ```
data_status
```
  - data verification status
- ```
source_url
```
  - original news source link
- ```
X
```
  - project's X (Twitter) URL
- ```
one_liner
```
  - project brief description
- ```
invests
```
  - up to 3 investors, each with:
  - ```
  name
```
  ,
```
  logo
```
- ```
lead_investor
```
    -
```
1
```
    =lead investor,
```
0
```
    =participating
  - ```
  type
```
  -
```
  1
```
  =Project,
```
  2
```
  =VC/Institution,
```
  3
```
  =Person
- ```
invest_id
```
    - investor ID
  - ```
  rootdataurl
```
  - investor detail page

POST https://api.rootdata.com/open/okx/skill/get_fac

使用场景：用户查询融资历史、投资轮次、“XX项目融资了多少”、“谁投资了XX”，或请求近期融资列表。

数据范围：仅涵盖过去365天的融资轮次。查询更早数据时，将自动返回最近365天的内容。

投资者限制：每个融资轮次最多返回3个投资者（优先显示领投方）。

输出：带分页的融资轮次列表，包含项目信息和投资者详情。示例：

json

{
  "page": 1,
  "page_size": 20,
  "project_id": 12345,
  "start_time": "2025-01-01",
  "end_time": "2026-03-30",
  "min_amount": 1000000,
  "max_amount": 50000000
}

除

page

和

page_size

外，所有字段均为可选。省略用户未指定的字段即可。

关键响应字段：

```
total
```
- 匹配记录总数
```
items
```
- 融资轮次列表，每个条目包含：
- ```
name
```
  - 项目名称
- ```
logo
```
  - 项目Logo
- ```
rounds
```
  - 轮次类型（种子轮/A轮/B轮等）
- ```
published_time
```
  - 公告日期
- ```
amount
```
  - 融资金额（美元）
- ```
project_id
```
  - 项目ID
- ```
data_status
```
  - 数据验证状态
- ```
source_url
```
  - 原始新闻来源链接
- ```
X
```
  - 项目的X（Twitter）URL
- ```
one_liner
```
  - 项目简短描述
- ```
invests
```
  - 最多3个投资者，每个包含：
  - ```
  name
```
  ,
```
  logo
```
- ```
lead_investor
```
    -
```
1
```
    =领投方，
```
0
```
    =参与方
  - ```
  type
```
  -
```
  1
```
  =项目，
```
  2
```
  =风投/机构，
```
  3
```
  =个人
- ```
invest_id
```
    - 投资者ID
  - ```
  rootdataurl
```
  - 投资者详情页

Trending Projects

Personnel Job Changes

人员职位变动

POST https://api.rootdata.com/open/okx/skill/job_changes

When to use: User asks about recent job changes in crypto, "who joined which project", "who left which company", personnel movements, or executive changes in the Web3 industry.

Data limit: Returns a maximum of 20 recent entries for each category.

Output: Two arrays - recent hires and recent departures - each with up to 20 entries. Example:

json

{
  "recent_joinees": true,
  "recent_resignations": true
}

Parameters:

```
recent_joinees
```
-
```
true
```
to get recent hires/joiners
```
recent_resignations
```
-
```
true
```
to get recent departures
Both can be
```
true
```
simultaneously
If both are
```
false
```
or omitted, returns empty data

Key response fields:

```
recent_joinees
```
- array of recent hires (max 20), each containing:
- ```
people_id
```
  - person ID
- ```
people_name
```
  - person's name
- ```
head_img
```
  - profile photo
- ```
company_type
```
  -
```
1
```
  =Project,
```
2
```
  =VC/Institution,
```
3
```
  =Person
- ```
company_id
```
  - company/project ID
- ```
company
```
  - company/project name
- ```
position
```
  - job title
```
recent_resignations
```
- array of recent departures (max 20), same structure

POST https://api.rootdata.com/open/okx/skill/job_changes

使用场景：用户查询加密行业近期职位变动、“谁加入了哪个项目”、“谁离开了哪家公司”、人员流动或Web3行业高管变动。

数据限制：每个类别最多返回20条最新记录。

输出：两个数组——近期入职和近期离职，每个数组最多包含20条记录。示例：

json

{
  "recent_joinees": true,
  "recent_resignations": true
}

参数说明：

```
recent_joinees
```
- 设置为
```
true
```
获取近期入职人员
```
recent_resignations
```
- 设置为
```
true
```
获取近期离职人员
两者可同时设为
```
true
```
若两者均为
```
false
```
或省略，将返回空数据

关键响应字段：

```
recent_joinees
```
- 近期入职人员数组（最多20条），每个条目包含：
- ```
people_id
```
  - 人员ID
- ```
people_name
```
  - 人员姓名
- ```
head_img
```
  - 头像
- ```
company_type
```
  -
```
1
```
  =项目，
```
2
```
  =风投/机构，
```
3
```
  =个人
- ```
company_id
```
  - 公司/项目ID
- ```
company
```
  - 公司/项目名称
- ```
position
```
  - 职位
```
recent_resignations
```
- 近期离职人员数组（最多20条），结构同上

Multi-Language Support

多语言支持

Add header

language: cn

for Chinese responses, or

language: en

for English (default).

All name fields, descriptions, and position titles will be returned in the requested language.

添加请求头

language: cn

获取中文响应，或

language: en

获取英文响应（默认）。

所有名称字段、描述和职位头衔将以请求的语言返回。

Error Handling

错误处理

Error	Cause	Resolution
`401 Unauthorized`	Missing or invalid `OKX_ROOTDATA_SKILL_KEY`	Re-run `/init` to generate a new key and update the env variable
`429 Too Many Requests`	Rate limit exceeded (200 req/min)	Wait for the number of seconds in the `Retry-After` response header, then retry
`400 Bad Request`	Invalid or missing required parameters	Check request body; verify `type` , `days` , or `page` values are correct
`404 Not Found`	Entity ID does not exist	Confirm the ID via `/ser_inv` search before calling detail endpoints
`500 Internal Server Error`	Upstream server error	Retry after a short delay; if persistent, report to RootData support
`result` field != `200`	Application-level error	Read the `message` field in the response for details

If you receive HTTP

, check the

Retry-After

header and wait before retrying. Monitor

X-RateLimit-Remaining

to track remaining quota.

错误	原因	解决方法
`401 Unauthorized`	`OKX_ROOTDATA_SKILL_KEY` 缺失或无效	重新运行 `/init` 生成新密钥并更新环境变量
`429 Too Many Requests`	超过速率限制（200次请求/分钟）	等待响应头 `Retry-After` 中指定的秒数后重试
`400 Bad Request`	参数无效或缺失	检查请求体；验证 `type` 、 `days` 或 `page` 取值是否正确
`404 Not Found`	实体ID不存在	调用 `/ser_inv` 搜索确认ID后，再调用详情接口
`500 Internal Server Error`	上游服务器错误	短时间后重试；若问题持续，联系RootData支持团队
`result` 字段 != `200`	应用级错误	阅读响应中的 `message` 字段获取详细信息

如果收到HTTP

错误，请检查

Retry-After

头并等待后重试。通过

X-RateLimit-Remaining

跟踪剩余配额。

Security Notices

安全须知

This skill is read-only and does not perform any write, trade, or transaction operations.
The
```
okxsk_
```
prefixed API key is an anonymous, low-privilege key used solely to call RootData's public data endpoints. It has no access to any personal account or wallet data.
The key is stored as a local environment variable (
```
OKX_ROOTDATA_SKILL_KEY
```
) and is never sent to any service other than
```
api.rootdata.com
```
.
You can revoke the key at any time by contacting RootData support.
Rate limit: 200 requests per minute per API key.

本技能为只读，不执行任何写入、交易或转账操作。
前缀为
```
okxsk_
```
的API密钥是匿名低权限密钥，仅用于调用RootData的公开数据端点，无法访问任何个人账户或钱包数据。
密钥存储为本地环境变量(
```
OKX_ROOTDATA_SKILL_KEY
```
)，绝不会发送至
```
api.rootdata.com
```
以外的任何服务。
您可随时联系RootData支持团队撤销密钥。
速率限制：每个API密钥每分钟200次请求。

Version History

版本历史

v1.0.0 (2026-04-27)

v1.0.0（2026-04-27）

Initial OKX edition release
Isolated endpoint namespace:
```
/open/okx/skill/
```
Isolated API key namespace:
```
okxsk_
```
prefix, env var
```
OKX_ROOTDATA_SKILL_KEY
```
6 skills: Search, ID Map, Project Detail, Funding Rounds, Trending Projects, Personnel Job Changes
Funding data limited to past 365 days; max 3 investors per round
Job changes: max 20 entries per category

OKX版初始发布
独立端点命名空间：
```
/open/okx/skill/
```
独立API密钥命名空间：
```
okxsk_
```
前缀，环境变量
```
OKX_ROOTDATA_SKILL_KEY
```
6项技能：搜索、ID映射、项目详情、融资轮次、热门项目、人员职位变动
融资数据限制为过去365天；每轮最多显示3个投资者
职位变动：每个类别最多20条记录

rootdata-crypto-plugin

Original

Translation

Pre-flight Dependencies (auto-injected by Plugin Store CI)

前置依赖项（由插件商店CI自动注入）

Version check (auto-injected)

版本检查（自动注入）

Check for skill updates (1-hour cache)

Check for skill updates (1-hour cache)

RootData Crypto Intelligence (OKX Edition)

RootData 加密货币情报（OKX版）

Overview

概述

Pre-flight Checks

前置检查

Initialize API Key

初始化API密钥

Commands

命令

Search

搜索

Get All IDs by Type

按类型获取所有ID

Project Detail

项目详情

Funding Rounds

融资轮次

Trending Projects

热门项目

Personnel Job Changes

人员职位变动

Multi-Language Support

多语言支持

Error Handling

错误处理

Security Notices

安全须知

Version History

版本历史

v1.0.0 (2026-04-27)

v1.0.0（2026-04-27）