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

1. 搜索项目/机构
- URL: https://api.rootdata.com/open/ser_inv
- Method: POST
- 描述: 通过项目/机构名称、代币、简介、介绍搜索项目/机构简要信息,不限次数
- 支持的版本: Basic, Plus, Pro
请求头
参数 | Type | Required | 描述 |
---|---|---|---|
apikey | string | true | 您申请的APIKEY |
language | string | false | 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en') |
请求参数
参数 | Type | Required | 描述 |
---|---|---|---|
query | string | true | 搜索关键词,可以是项目/机构名称、代币或其他相关词汇 |
响应字段
参数 | 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 | 描述 |
---|---|---|---|
apikey | string | true | 您申请的APIKEY |
请求参数
参数 | Type | Required | 描述 |
---|---|---|---|
project_id | int | false | 项目的唯一标识符。如果同时提供了`project_id`和`contract_address`,则`project_id`优先。 |
include_team | bool | false | 是否包含团队成员信息,默认为 false |
include_investors | bool | false | 是否包含投资方信息,默认为 false |
contract_address | string | false | 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 | 描述 |
---|---|---|---|
apikey | string | true | 您申请的APIKEY |
请求参数
参数 | Type | Required | 描述 |
---|---|---|---|
org_id | int | true | 机构ID |
include_team | bool | false | 是否包含团队成员信息,默认为 false |
include_investors | bool | false | 是否包含投资项目信息,默认为 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 | 描述 |
---|---|---|---|
apikey | string | true | 您申请的APIKEY |
language | string | false | 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en') |
请求参数
参数 | Type | Required | 描述 |
---|---|---|---|
page | int | false | 页码,默认1 |
page_size | int | false | 每页条数,默认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 | 描述 |
---|---|---|---|
apikey | string | true | 您申请的APIKEY |
language | string | false | 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en') |
请求参数
参数 | Type | Required | 描述 |
---|---|---|---|
page | int | false | 页码,默认1 |
page_size | int | false | 每页条数,默认10,最大200 |
start_time | string | false | 融资公布日期(起) yyyy-MM |
end_time | string | false | 融资公布日期(止) yyyy-MM |
min_amount | int | false | 融资金额最小范围(美元) |
max_amount | int | false | 融资金额最大范围(美元) |
project_id | int | false | 项目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 | 描述 |
---|---|---|---|
apikey | string | true | 您申请的APIKEY |
language | string | false | 所需的语言版本(例如:'en'表示英文,'cn'表示中文,默认为'en') |
请求参数
参数 | Type | Required | 描述 |
---|---|---|---|
begin_time | long | true | 开始时间,时间戳 |
end_time | long | true | 结束时间,时间戳 |
响应字段
参数 | 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 次。