RootData 是一个 Web3 项目情报 API 技能,主要供需要研究加密项目、投资方、融资动态和行业人员流动的使用者在脚本环境中调用。
主要能力
该技能覆盖以下数据能力:
- 项目、投资机构、人物的关键词搜索;
- 按项目 ID 或合约地址查询项目详情,可选择是否包含投资方信息;
- 查询融资轮次列表,支持按项目 ID、时间范围、融资金额区间过滤;
- 获取热门项目排行(今日或本周);
- 查询近期人员变动,包括新入职和离职人员。
使用方式
该技能为脚本模式,需在 bash 块中通过 Python 调用。首先将技能目录加入模块搜索路径,然后从 exports 导入所需函数。可用函数包括:rd_init_key、rd_search、rd_id_map、rd_project_detail、rd_funding_rounds、rd_hot_index、rd_job_changes。
首次使用时会自动初始化密钥:若环境变量 ROOTDATA_SKILL_KEY 缺失,调用一次 rd_init_key()。该函数向 POST https://api.rootdata.com/open/skill/init 发送空对象请求体,返回 api_key 和 message,密钥应持久化到环境中。
各函数的接口约定如下:
rd_search(query, precise_x_search=False, language='en'):调用POST /open/skill/ser_inv,按关键词搜索,返回实体列表,常见字段有id、type(1=项目,2=机构,3=人物)、name、one_liner、introduce、rootdataurl。rd_id_map(type, language='en'):调用POST /open/skill/id_map,按类型(1/2/3)获取全部 ID 与名称列表。rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en'):调用POST /open/skill/get_item,通过项目 ID 或合约地址获取详情,常见字段包括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'):调用POST /open/skill/get_fac,返回total和items。rd_hot_index(days=1, language='en'):调用POST /open/skill/hot_index,days为 1(今日)或 7(本周),返回排行列表,常见字段有rank、project_id、project_name、token_symbol、one_liner、tags、X、rootdataurl。rd_job_changes(recent_joinees=True, recent_resignations=True, language='en'):调用POST /open/skill/job_changes,返回recent_joinees(最多 20 条)和recent_resignations(最多 20 条)。
语言通过 language 头控制,支持 en(默认)和 cn。
适用场景
适合加密项目调研、交易流分析(例如查询某项目的投资方、最新融资动态)、追踪行业人员流动,以及查看近期热门项目排行。研究类任务推荐先调用 rd_search 找到实体 ID,再用 rd_project_detail 或 rd_funding_rounds 做深入分析。
限制与注意事项
- 融资轮次接口仅覆盖过去 365 天的数据。
- 每轮融资最多返回 3 个投资方。
valuation字段已从上游移除。- 速率限制为每密钥每分钟 200 次请求,遇到 429 时应读取
Retry-After头后再重试。 - HTTP 状态码含义:200 成功、400 参数错误、401 密钥无效、404 未找到、429 限流、500 内部错误。
- 首次初始化获取的是匿名低权限密钥,建议缓存
ROOTDATA_SKILL_KEY以避免频繁初始化。