rootdata

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

RootData

RootData Web3 intelligence API for:

project / investor / person search
project detail lookup
recent funding rounds
trending projects (daily / weekly)
personnel job changes

RootData Web3情报API适用于：

项目/投资者/人物搜索
项目详情查询
近期融资轮次
热门项目（日榜/周榜）
人事变动

Script Usage

脚本使用

This is a script-mode skill. Use from a

bash

block:

bash

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/rootdata")
from exports import rd_search, rd_project_detail, rd_funding_rounds

print(rd_search(query="berachain")[:2])
print(rd_project_detail(project_id=3375, include_investors=True).get("project_name"))
print(rd_funding_rounds(page=1, page_size=5).get("total"))
EOF

Available functions in

exports.py

rd_init_key

rd_search

rd_id_map

rd_project_detail

rd_funding_rounds

rd_hot_index

rd_job_changes

这是一个脚本模式的skill。可在

bash

代码块中使用：

bash

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/rootdata")
from exports import rd_search, rd_project_detail, rd_funding_rounds

print(rd_search(query="berachain")[:2])
print(rd_project_detail(project_id=3375, include_investors=True).get("project_name"))
print(rd_funding_rounds(page=1, page_size=5).get("total"))
EOF

exports.py

中的可用函数：

rd_init_key

rd_search

rd_id_map

rd_project_detail

rd_funding_rounds

rd_hot_index

rd_job_changes

First-Time Setup (auto-init key)

首次设置（自动初始化密钥）

RootData provides an anonymous low-privilege key via init API.

Env var used by this skill:
```
ROOTDATA_SKILL_KEY
```
If the var is missing, call
```
rd_init_key()
```
once and persist it to your environment.

Init endpoint:

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

body:
```
{}
```
returns
```
api_key
```

RootData通过初始化API提供匿名低权限密钥。

本skill使用的环境变量：
```
ROOTDATA_SKILL_KEY
```
如果该变量缺失，调用一次
```
rd_init_key()
```
并将其持久化到你的环境中。

初始化端点：

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

请求体：
```
{}
```
返回
```
api_key
```

Functions

函数说明

rd_init_key()

rd_init_key()

Get a new anonymous API key from RootData init endpoint.

Returns dict:

```
api_key
```
```
message
```

获取来自RootData初始化端点的新匿名API密钥。

返回字典：

```
api_key
```
```
message
```

rd_search(query, precise_x_search=False, language='en')

rd_search(query, precise_x_search=False, language='en')

Search projects / investors / people by keyword.

Endpoint:

POST /open/skill/ser_inv

Body:

```
query
```
: string
```
precise_x_search
```
: bool

Returns list of entities. Common fields:

```
id
```
```
type
```
(1=project, 2=institution, 3=person)
```
name
```
```
one_liner
```
```
introduce
```
```
rootdataurl
```

通过关键词搜索项目/投资者/人物。

端点：

POST /open/skill/ser_inv

请求体：

```
query
```
: 字符串
```
precise_x_search
```
: 布尔值

返回实体列表，通用字段：

```
id
```
```
type
```
（1=项目，2=机构，3=人物）
```
name
```
```
one_liner
```
```
introduce
```
```
rootdataurl
```

rd_id_map(type, language='en')

rd_id_map(type, language='en')

Get all IDs by type.

Endpoint:

POST /open/skill/id_map

Body:

```
type
```
: 1 (project) | 2 (institution) | 3 (person)

Returns list with

id

name

按类型获取所有ID。

端点：

POST /open/skill/id_map

请求体：

```
type
```
: 1（项目）| 2（机构）| 3（人物）

返回包含

id

name

的列表。

rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en')

rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en')

Get project detail by project_id or contract address.

Endpoint:

POST /open/skill/get_item

Body (one of):

```
project_id
```
: int
```
contract_address
```
: string
```
include_investors
```
: bool

Returns project detail (fields vary), often including:

```
project_id
```
,
```
project_name
```
,
```
token_symbol
```
```
one_liner
```
,
```
description
```
,
```
tags
```
```
contracts
```
,
```
social_media
```
```
total_funding
```
```
investors
```
(when requested)

通过project_id或合约地址获取项目详情。

端点：

POST /open/skill/get_item

请求体（二选一）：

```
project_id
```
: 整数
```
contract_address
```
: 字符串
```
include_investors
```
: 布尔值

返回项目详情（字段因项目而异），通常包含：

```
project_id
```
,
```
project_name
```
,
```
token_symbol
```
```
one_liner
```
,
```
description
```
,
```
tags
```
```
contracts
```
,
```
social_media
```
```
total_funding
```
```
investors
```
（当请求时返回）

rd_funding_rounds(page=1, page_size=20, project_id=None, start_time=None, end_time=None, min_amount=None, max_amount=None, language='en')

rd_funding_rounds(page=1, page_size=20, project_id=None, start_time=None, end_time=None, min_amount=None, max_amount=None, language='en')

Get funding round list with filters.

Endpoint:

POST /open/skill/get_fac

Notes:

data covers past 365 days
max 3 investors per round
```
valuation
```
field removed upstream

Returns dict:

```
total
```
```
items
```
(list)

通过筛选条件获取融资轮次列表。

端点：

POST /open/skill/get_fac

注意：

数据覆盖过去365天
每轮最多显示3个投资者
上游已移除
```
valuation
```
字段

返回字典：

```
total
```
```
items
```
（列表）

rd_hot_index(days=1, language='en')

rd_hot_index(days=1, language='en')

Get trending project ranking.

Endpoint:

POST /open/skill/hot_index

Body:

```
days
```
: 1 (today) | 7 (this week)

Returns list, common fields:

rank

project_id

project_name

token_symbol

one_liner

tags

rootdataurl

获取热门项目排名。

端点：

POST /open/skill/hot_index

请求体：

```
days
```
: 1（今日）| 7（本周）

返回列表，通用字段：

rank

project_id

project_name

token_symbol

one_liner

tags

rootdataurl

rd_job_changes(recent_joinees=True, recent_resignations=True, language='en')

rd_job_changes(recent_joinees=True, recent_resignations=True, language='en')

Get recent personnel moves.

Endpoint:

POST /open/skill/job_changes

Body:

```
recent_joinees
```
: bool
```
recent_resignations
```
: bool

Returns dict with:

```
recent_joinees
```
(max 20)
```
recent_resignations
```
(max 20)

获取近期人事变动。

端点：

POST /open/skill/job_changes

请求体：

```
recent_joinees
```
: 布尔值
```
recent_resignations
```
: 布尔值

返回包含以下内容的字典：

```
recent_joinees
```
（最多20条）
```
recent_resignations
```
（最多20条）

Language Header

语言请求头

Pass

language

header:

```
en
```
(default)
```
cn
```

传递

language

请求头：

```
en
```
（默认）
```
cn
```

Error Handling

错误处理

HTTP codes:

200 success
400 bad params
401 invalid key
404 not found
429 rate limit
500 internal error

Rate limit:

200 requests / minute / key
on 429, use
```
Retry-After
```
header before retry

HTTP状态码：

200 成功
400 参数错误
401 密钥无效
404 未找到
429 请求超限
500 内部错误

请求限制：

每个密钥每分钟200次请求
遇到429状态码时，需等待
```
Retry-After
```
头指定的时间后再重试

Usage Notes

使用注意事项

Keep a cached
```
ROOTDATA_SKILL_KEY
```
to avoid frequent init calls.
For research tasks, preferred flow:
1. ```
rd_search
```
  → find entity ID
2. ```
rd_project_detail
```
  /
```
rd_funding_rounds
```
  for deeper analysis
Funding rounds endpoint is recent-window only (365 days), mention this explicitly in outputs.

缓存
```
ROOTDATA_SKILL_KEY
```
以避免频繁调用初始化接口。
研究任务推荐流程：
1. ```
rd_search
```
  → 查找实体ID
2. ```
rd_project_detail
```
  /
```
rd_funding_rounds
```
  进行深度分析
融资轮次接口仅包含最近365天的数据，输出时需明确提及这一点。

rootdata

Original

Translation

RootData

RootData

Script Usage

脚本使用

First-Time Setup (auto-init key)

首次设置（自动初始化密钥）

Functions

函数说明

`rd_init_key()`

`rd_init_key()`

`rd_search(query, precise_x_search=False, language='en')`

`rd_search(query, precise_x_search=False, language='en')`

`rd_id_map(type, language='en')`

`rd_id_map(type, language='en')`

`rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en')`

`rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en')`

`rd_funding_rounds(page=1, page_size=20, project_id=None, start_time=None, end_time=None, min_amount=None, max_amount=None, language='en')`

`rd_funding_rounds(page=1, page_size=20, project_id=None, start_time=None, end_time=None, min_amount=None, max_amount=None, language='en')`

`rd_hot_index(days=1, language='en')`

`rd_hot_index(days=1, language='en')`

`rd_job_changes(recent_joinees=True, recent_resignations=True, language='en')`

`rd_job_changes(recent_joinees=True, recent_resignations=True, language='en')`

Language Header

语言请求头

Error Handling

错误处理

Usage Notes

使用注意事项