SuperAPI AI 工具集

rootdata

数据与分析

查看项目

更新于 10-15 09:22

技能介绍

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 以避免频繁初始化。