开始使用RootData API

请确保在使用 API 时遵守相关的使用条款和限制,并在合适的地方提供适当的归属和引用

1. 搜索项目/机构

  • URL: https://api.rootdata.com/open/ser_inv
  • Method: POST
  • 描述: 通过项目/机构名称、代币、简介、介绍搜索项目/机构简要信息,不限次数
  • 支持的版本: Basic, Plus, Pro
请求头
参数
Type
Required
描述
apikeystringtrue 您申请的APIKEY
languagestringfalse 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en')
请求参数
参数
Type
Required
描述
querystringtrue 搜索关键词,可以是项目/机构名称、代币或其他相关词汇
响应字段
参数
Type
描述
id int
唯一标识符
type int
1 项目; 2 机构
name string
名称
logo string
logo 的 URL
introduce string
介绍
rootdataurl string
对应的RootData链接
请求示例
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"query": "ETH" }' https://api.rootdata.com/open/ser_inv
请求成功示例
{
  "data": [
    {
      "introduce": "Ethereum is the first decentralized, open-source blockchain with smart contract functionality, which was initially described in late 2013 in a white paper by Vitalik Buterin and launched in 2015.Ethereum serves as the foundation for an ecosystem of interoperable, decentralized applications (dApps) powered by token economies and automated smart contracts. Assets and applications designed on Ethereum are built with self-executing smart contracts that remove the need for a central authority or intermediary.\nThe network is fueled by its native cryptocurrency ether (ETH), which is used to pay transaction fees on the network. With the characteristics of open-source, programmable, private, and censorship resistant, Ethereum forms the backbone of a decentralized internet.",
      "name": "Ethereum",
      "logo": "https://api.rootdata.com/uploads/public/b15/1666341829033.jpg",
      "rootdataurl": "https://api.rootdata.com/Projects/detail/Ethereum?k=MTI=",
      "id": 12,
      "type": 1
    }
  ],
  "result": 200
}
请求失败示例
{
  "data": {},
  "result": 404,
  "message": "error message"
}

2. 获取项目

  • URL: https://api.rootdata.com/open/get_item
  • Method: POST
  • 描述: 通过项目ID查询项目信息,每天上限1200次,每月30000次
  • 支持的版本: Basic, Plus, Pro
请求头
参数
Type
Required
描述
apikeystringtrue 您申请的APIKEY
请求参数
参数
Type
Required
描述
project_idintfalse 项目的唯一标识符。如果同时提供了`project_id`和`contract_address`,则`project_id`优先。
include_teamboolfalse 是否包含团队成员信息,默认为 false
include_investorsboolfalse 是否包含投资方信息,默认为 false
contract_addressstringfalse Ethereum链合约地址,可选参数。如与`project_id`参数同时存在,则以`project_id`参数为准
响应字段
参数
Type
描述
project_id int
项目ID
project_name string
项目名称
logo string
项目 logo 的 URL
token_symbol string
代币符号
establishment_date string
成立时间
one_liner string
一句话介绍
description string
详细介绍
tags array
项目标签 (标签名数组)
social_media array
社交媒体链接
ecosystem array
项目所属生态(数组,生态名称,不区分测试网和主网)
investors array
投资方信息
total_funding decimal
融资总额
rootdataurl string
项目对应的RootData链接
contract_address string
代币合约地址
fully_diluted_market_cap string
完全稀释市值
market_cap string
流通市值
price string
价格
event array
项目重大事件 PRO
similar_project array
同类项目
reports array
新闻动态数据 PRO
team_members array
团队成员信息PRO
token_launch_time string
代币发行时间 yyyy-MM
support_exchanges array
支持的交易所 包含(交易所名称,交易所logo)
请求示例
curl -X POST -H "apikey: Your APIKEY" -H " language: en" -H "Content-Type: application/json" -d '{"project_id":8719, "include_team":true,"include_investors":true }' https://api.rootdata.com/open/get_item
请求成功示例
{
  "data": {
    "ecosystem": [],
    "one_liner": "Building hardware for cryptography",
    "description": "Fabric Cryptography is a start-up company focusing on developing advanced crypto algorithm hardware, especially building special computer chips for Zero-knowledge proof technology.",
    "rootdataurl": "https://api.rootdata.com/Projects/detail/Fabric Cryptography?k=ODcxOQ==",
    "total_funding": 87033106304,
    "project_name": "Fabric Cryptography",
    "investors": [
      {
        "name": "Inflection",
        "logo": "https://api.rootdata.com/uploads/public/b17/1666870085112.jpg"
      },
      {
        "name": "Metaplanet",
        "logo": "https://api.rootdata.com/uploads/public/b17/1666872688748.jpg"
      },
      {
        "name": "=nil; ",
        "logo": "https://api.rootdata.com/uploads/public/b6/1674140377901.jpg"
      },
      {
        "name": "Jasper Lau"
      },
      {
        "name": "Novawulf"
      }
    ],
    "establishment_date": "2022",
    "tags": [
      "Infra",
      "zk"
    ],
    "project_id": 8719,
    "team_members": [
      {
        "medium": "",
        "website": "https://www.fabriccryptography.com/",
        "twitter": "",
        "discord": "",
        "linkedin": "https://www.linkedin.com/company/fabriccryptography/"
      }
    ],
    "logo": "https://api.rootdata.com/uploads/public/b6/1690306559722.jpg",
    "social_media": {
      "medium": "",
      "website": "https://llama.xyz/",
      "twitter": "https://twitter.com/llama",
      "discord": "",
      "linkedin": ""
    },
    "contract_address": "0x00aU9GoIGOKahBostrD",
    "fully_diluted_market_cap": "1000000",
    "market_cap": "1000000",
    "price": "1000000",
    "reports": []
  },
  "result": 200
}
请求失败示例
{
  "data": {},
  "result": 404,
  "message": "error message"
}

3. 获取机构

  • URL: https://api.rootdata.com/open/get_org
  • Method: POST
  • 描述: 通过机构ID查询机构信息,每天上限1200次,每月30000次
  • 支持的版本: Basic, Plus, Pro
请求头
参数
Type
Required
描述
apikeystringtrue 您申请的APIKEY
请求参数
参数
Type
Required
描述
org_idinttrue 机构ID
include_teamboolfalse 是否包含团队成员信息,默认为 false
include_investmentsboolfalse 是否包含投资项目信息,默认为 false
响应字段
参数
Type
描述
org_id int
机构ID
org_name string
机构名称
logo string
机构 logo 的 URL
establishment_date string
成立时间
description string
详细介绍
category string
类型
social_media array
社交媒体链接(官网、推特、LinkedIn)
team_members array
团队成员信息(数组,包括姓名、职位)
investments array
投资项目(数组,包括名称、logo)
rootdataurl string
机构对应的RootData链接
请求示例
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"org_id":219,"include_team":true,"include_investors":true }' https://api.rootdata.com/open/get_org
请求成功示例
{
  "data": {
    "org_id": 219,
    "team_members": [
      {
        "name": "Shan Aggarwal",
        "position": "Head"
      },
      {
        "name": "Jonathan King",
        "position": "Principal"
      }
    ],
    "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666777683240.jpg",
    "description": "Coinbase Ventures is an investment arm of Coinbase that aims to invest in early-stage cryptocurrency and blockchain startups.",
    "rootdataurl": "https://api.rootdata.com/Investors/detail/Coinbase Ventures?k=MjE5",
    "org_name": "Coinbase Ventures",
    "category": [
      "Seed Plus"
    ],
    "investments": [
      {
        "name": "zkSync / Matter Labs",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666624791085.jpg"
      },
      {
        "name": "Uniswap",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666537174028.jpg"
      },
      {
        "name": "Animoca Brands",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666877617742.jpg"
      },
      {
        "name": "Lido",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666492251590.jpg"
      },
      {
        "name": "Ribbon Finance",
        "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666496560763.jpg"
      },
      {
        "name": "Optimism",
        "logo": "https://rdbk.rootdata.com/uploads/public/b18/1666579569788.jpg"
      },
      {
        "name": "Opensea",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666583901564.jpg"
      },
      {
        "name": "Arbitrum / Offchain Labs",
        "logo": "https://rdbk.rootdata.com/uploads/public/b23/1676000536788.jpg"
      },
      {
        "name": "Paxos",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666773577185.jpg"
      },
      {
        "name": "Connext",
        "logo": "https://rdbk.rootdata.com/uploads/public/b19/1666613592357.jpg"
      },
      {
        "name": "Worldcoin",
        "logo": "https://rdbk.rootdata.com/uploads/public/b22/1690189915541.jpg"
      },
      {
        "name": "Sei Network",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666625883825.jpg"
      },
      {
        "name": "LayerZero",
        "logo": "https://rdbk.rootdata.com/uploads/public/b19/1666613304265.jpg"
      },
      {
        "name": "EigenLayer",
        "logo": "https://rdbk.rootdata.com/uploads/public/b12/1689577875078.jpg"
      },
      {
        "name": "Synthetix",
        "logo": "https://rdbk.rootdata.com/uploads/public/b15/1666361809056.jpg"
      }
    ],
    "establishment_date": "2018",
    "social_media": {
      "website": "https://www.coinbase.com/ventures",
      "twitter": "https://twitter.com/cbventures",
      "linkedin": ""
    }
  },
  "result": 200
}
请求失败示例
{
  "data": {},
  "result": 404,
  "message": "error message"
}

4. 批量获取投资者信息(Plus, Pro)

  • URL: https://api.rootdata.com/open/get_invest
  • Method: POST
  • 描述: 查询投资者基本信息、投资组合、投资数据分析
  • 支持的版本: Plus, Pro
请求头
参数
Type
Required
描述
apikeystringtrue 您申请的APIKEY
languagestringfalse 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en')
请求参数
参数
Type
Required
描述
pageintfalse 页码,默认1
page_sizeintfalse 每页条数,默认10,最大200
响应字段
参数
Type
描述
area array
地区列表
last_fac_date string
最近投资时间
last_invest_num int
近一年投资次数
invest_range array
参投规模
description string
投资者介绍
invest_overview object
投资概览
type int
类型: 1项目 2机构 3人物
investments array
对外投资项目
establishment_date string
成立时间
invest_num int
投资次数
invest_stics array
投资版图
invest_id int
投资者ID
team_members array
团队成员信息
logo string
投资者Logo
invest_name string
投资者名称
请求示例
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"page":1,"page_size":10}' https://api.rootdata.com/open/get_invest
请求成功示例
{
  "data": {
    "items": [
      {
        "area": [
          "Singapore",
          "United Arab Emirates"
        ],
        "last_fac_date": "2023-10-12 00:00:00",
        "last_invest_num": 25,
        "description": "Binance Labs is the venture capital and incubation arm of Binance. It identifies, invests, and empowers viable blockchain entrepreneurs, startups, and communities, providing fundraising to industry projects that help grow the wider blockchain ecosystem.",
        "invest_overview": {
          "lead_invest_num": 38,
          "last_invest_round": 25,
          "his_invest_round": 141,
          "invest_num": 171
        },
        "type": 2,
        "investments": [
          {
            "name": "zkSync / Matter Labs",
            "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666624791085.jpg"
          }
        ],
        "establishment_date": "2017",
        "invest_num": 171,
        "invest_stics": [
          {
            "track": "Infrastructure",
            "invest_num": 69
          }
        ],
        "invest_id": 229,
        "invest_range": [
          {
            "lead_invest_num": 11,
            "amount_range": "1-3M",
            "lead_not_invest_num": 17,
            "invest_num": 28
          }
        ],
        "team_members": [
          {
            "head_img": "https://rdbk.rootdata.com/uploads/public/b12/1669630219503.jpg",
            "name": "Yi He",
            "X": "https://twitter.com/heyibinance",
            "position": "Head"
          }
        ],
        "logo": "https://rdbk.rootdata.com/uploads/public/b11/1666594924745.jpg",
        "invest_name": "Binance Labs"
      }
    ],
    "total": 1
  },
  "result": 200
}
请求失败示例
{
  "data": {},
  "result": 404,
  "message": "error message"
}

5. 批量获取融资轮次信息(Plus, Pro)

  • URL: https://api.rootdata.com/open/get_fac
  • Method: POST
  • 描述: 查询项目的融资信息(默认2022年至今)
  • 支持的版本: Plus, Pro
请求头
参数
Type
Required
描述
apikeystringtrue 您申请的APIKEY
languagestringfalse 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en')
请求参数
参数
Type
Required
描述
pageintfalse 页码,默认1
page_sizeintfalse 每页条数,默认10,最大200
start_timestringfalse 融资公布日期(起) yyyy-MM
end_timestringfalse 融资公布日期(止) yyyy-MM
min_amountintfalse 融资金额最小范围(美元)
max_amountintfalse 融资金额最大范围(美元)
project_idintfalse 项目Id
响应字段
参数
Type
描述
logo string
项目 logo 的 URL
name string
项目名称
rounds string
轮次名称
published_time string
融资公布日期
amount long
融资金额(美元)
project_id int
项目ID
valuation long
估值(美元)
invests array
投资方信息数组,包含Logo、名称
请求示例
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{ }' https://api.rootdata.com/open/get_fac
请求成功示例
{
  "data": {
    "total": 2870,
    "items": [
      {
        "amount": 2500000,
        "valuation": 30000000,
        "published_time": "2023-10",
        "name": "Convergence",
        "logo": "https://rdbk.rootdata.com/uploads/public/b6/1671983908027.jpg",
        "rounds": "Pre-Seed",
        "invests": [
          {
            "name": "C² Ventures",
            "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666777874118.jpg"
          },
          {
            "name": "Big Brain Holdings",
            "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666778919102.jpg"
          },
          {
            "name": "Israeli Blockchain Association",
            "logo": "https://rdbk.rootdata.com/uploads/public/b26/1668496875036.jpg"
          }
        ]
      }
    ]
  },
  "result": 200
}
请求失败示例
{
  "data": {},
  "result": 404,
  "message": "error message"
}

6. 同步更新(Pro)

  • URL: https://api.rootdata.com/open/ser_change
  • Method: POST
  • 描述: 获取单位时间段内更新的数据,数据每天更新,每天上限1次
  • 支持的版本: Pro
请求头
参数
Type
Required
描述
apikeystringtrue 您申请的APIKEY
languagestringfalse 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en')
请求参数
参数
Type
Required
描述
begin_timelongtrue 开始时间,时间戳
end_timelongtrue 结束时间,时间戳
响应字段
参数
Type
描述
id int
ID
type int
1:项目; 2:机构
name string
Type类型对应的数据名称
update_time long
更新时间,时间戳
请求示例
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"begin_time":1693974909261,"end_time":1694476800000,}' https://api.rootdata.com/open/ser_change
请求成功示例
{
  "data": [
    {
      "update_time": 1693974909261,
      "name": "Ethereum",
      "id": 12,
      "type": 1
    }
  ],
  "result": 200
}
请求失败示例
{
  "data": {},
  "result": 404,
  "message": "error message"
}

错误处理

  • 110 Authentication Failed: 鉴权失败
  • 400 Bad Request: 请求参数无效或缺失
  • 403 Forbidden: 访问被拒绝,访问次数已达上限
  • 404 Not Found: 未找到匹配的信息
  • 410 High visit frequency: 您的访问频次过高,请等待一分钟后重置
  • 500 Internal Server Error: 服务器内部错误

认证与访问限制

此 API 需要申请,不可以直接访问。每个 API Key 每分钟的请求限制为 30 次。