Getting Started with the RootData API
Please ensure that you comply with the relevant terms of use and restrictions when using the API, and provide appropriate attribution and citation where applicable.
1. Search
- URL: https://api.rootdata.com/open/ser_inv
- Method: POST
- Description: Search information by name, token, description, with no limit on the number of queries.
- Supported versions: Basic, Plus, Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
query | string | true | Search keywords, which can be project/VC/people names, tokens, or other related terms. |
Response field
Parameters | Type | Description |
---|---|---|
id | int | Unique Identifier |
type | int | 1 Project; 2 VC; 3 People |
name | string | Name |
logo | string | URL of the logo |
introduce | string | Introduction |
rootdataurl | string | Corresponding RootData link. |
Request example
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
Successful request example
{ "data": [ { "introduce": "Ethereum is the first decentralized...", "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 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
2. Query Project
- URL: https://api.rootdata.com/open/get_item
- Method: POST
- Description: Query project information by project ID, consuming 2 credits per query.
- Supported versions: Basic, Plus, Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The APIKEY you applied for |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
project_id | int | false | The unique identifier for the project. If both `project_id` and `contract_address` are provided, `project_id` takes precedence. |
include_team | bool | false | Whether to include team member information, default is false. |
include_investors | bool | false | Whether to include investor information, default is false. |
contract_address | string | false | Ethereum contract address, optional parameter. If the `project_id` parameter exists at the same time, the `project_id` parameter takes precedence. |
Response field
Parameters | Type | Description |
---|---|---|
project_id | int | Project ID |
project_name | string | Project Name |
logo | string | The URL of the project logo. |
token_symbol | string | Token symbol |
establishment_date | string | Establishment date |
one_liner | string | A brief introduction. |
description | string | Detailed introduction |
active | boolean | true: Operating; false: Inactive |
total_funding | decimal | Total financing amount |
tags | array | Project tags (array of tag names) |
rootdataurl | string | The RootData link corresponding to the project. |
investors | array | Investor Information |
social_media | array | Social media link |
similar_project | array | Similar projects |
ecosystem | array | Project's associated ecosystem (array, ecosystem name, not distinguishing between testnet and mainnet) PRO |
on_main_net | array | Actually, online network (array, ecological name) PRO |
plan_to_launch | array | Plan to launch the network (array, ecological name) PRO |
on_test_net | array | Launch the test network (array, ecosystem name) PRO |
contract_address | string | Token contract address PRO |
fully_diluted_market_cap | string | Fully diluted market capitalizationPRO |
market_cap | string | Market capitalization PRO |
price | string | Price PRO |
event | array | Major Project Events PRO |
reports | array | News dynamic data PRO |
team_members | array | Team Member Information PRO |
token_launch_time | string | Token issuance time yyyy-MMPRO |
support_exchanges | array | Supported exchanges include (exchange name, exchange logo) PRO |
heat | string | X Hotness Value PRO |
heat_rank | int | X Popularity Ranking PRO |
influence | string | X Influence PRO |
influence_rank | int | X Influence Ranking PRO |
followers | int | X number of fans PRO |
following | int | X followers PRO |
Request example
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
Successful request example
{ "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" } ], "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 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
3. Query VC
- URL: https://api.rootdata.com/open/get_org
- Method: POST
- Description: Querying VC information through the VC ID, consuming 2 credits per query.
- Supported versions: Basic, Plus, Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The APIKEY you applied for |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
org_id | int | true | VC ID |
include_team | bool | false | Whether to include team member information, default is false. |
include_investments | bool | false | Whether it includes investment project information, default is false. |
Response field
Parameters | Type | Description |
---|---|---|
org_id | int | VC ID |
org_name | string | VC Name |
logo | string | URL of the VC logo |
establishment_date | string | Establishment time |
description | string | Detailed introduction |
active | boolean | true: Operating; false: Inactive |
category | string | Type |
social_media | array | Social media links (official website, Twitter, LinkedIn) |
investments | array | Portfolio (array, including name, logo) |
rootdataurl | string | The RootData link corresponding to the VC. |
team_members | array | Team member information (array, including name and position) PRO |
heat | string | X hot index PRO |
heat_rank | int | X hot index ranking PRO |
influence | string | X influence index PRO |
influence_rank | int | X influence index ranking PRO |
followers | int | Followers on X PRO |
following | int | Following numbers on XPRO |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"org_id":219,"include_team":true,"include_investments":true }' https://api.rootdata.com/open/get_org
Successful request example
{ "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://public.rootdata.com/uploads/public/b16/1666624791085.jpg" } ], "establishment_date": "2018", "social_media": { "website": "https://www.coinbase.com/ventures", "twitter": "https://twitter.com/cbventures", "linkedin": "" } }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
4. Query People (Pro)
- URL: https://api.rootdata.com/open/get_people
- Method: POST
- Description: Query people information using the people ID, consuming 2 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API KEY you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
people_id | long | true | People ID |
Response field
Parameters | Type | Description |
---|---|---|
people_id | long | ID |
introduce | string | People Introduction |
head_img | string | Avatar |
one_liner | string | Introduction |
X | string | X link |
people_name | string | People name |
string | LinkedIn |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"people_id":12972, "include_team":true,"include_investors":true }' https://api.rootdata.com/open/get_people
Successful request example
{ "data": { "people_id": 12972, "introduce": "Cai Wensheng, also known as Mike Cai, is the founder and chairman of Meitu.", "head_img": "https://public.rootdata.com/images/b30/1687197351918.jpg", "one_liner": "", "X": "", "people_name": "Cai Wensheng", "linkedin": "" }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
5. Query Investors (Plus, Pro)
- URL: https://api.rootdata.com/open/get_invest
- Method: POST
- Description: Query investors' basic information, portfolio, and data statistics, consuming 2 credits per data item.
- Supported versions: Plus, Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
page | int | false | Page number, default 1 |
page_size | int | false | Number of items per page, default is 10, maximum is 100. |
Response field
Parameters | Type | Description |
---|---|---|
area | array | List of regions |
last_fac_date | string | Recent investment time |
last_invest_num | int | Number of investments in the past year |
invest_range | array | Investment scale |
description | string | Investor Introduction |
invest_overview | object | Investment Overview |
type | int | Type: 1 Project 2 VC 3 People |
investments | array | Portfolio |
establishment_date | string | Establishment date |
invest_num | int | Number of investments |
invest_stics | array | Investment Map |
invest_id | int | Investor ID |
team_members | array | Team member information |
logo | string | Investor Logo |
invest_name | string | Investor Name |
Request example
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
Successful request example
{ "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...", "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://public.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://public.rootdata.com/uploads/public/b12/1669630219503.jpg", "name": "Yi He", "X": "https://twitter.com/heyibinance", "position": "Head" } ], "logo": "https://public.rootdata.com/uploads/public/b11/1666594924745.jpg", "invest_name": "Binance Labs" } ], "total": 1 }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
6. Query Fundraising Rounds (Plus, Pro)
- URL: https://api.rootdata.com/open/get_fac
- Method: POST
- Description: Get fundraising rounds in batches (2022 to present), consuming 3 credits per data item.
- Supported versions: Plus, Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
page | int | false | Page number, default 1. |
page_size | int | false | Number of items per page, default is 10, maximum is 200. |
start_time | string | false | Financing announcement date (start) yyyy-MM |
end_time | string | false | Financing announcement date (end) yyyy-MM |
min_amount | int | false | Minimum financing amount (in USD) |
max_amount | int | false | Maximum financing amount (USD) |
project_id | int | false | Project ID |
Response field
Parameters | Type | Description |
---|---|---|
logo | string | The URL of the project logo. |
name | string | Project Name |
rounds | string | Round Name |
published_time | string | Financing announcement date |
amount | long | Funding amount (USD) |
project_id | int | Project ID |
valuation | long | Valuation (USD) |
invests | array | Investors array, including Logo and Name. |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{ }' https://api.rootdata.com/open/get_fac
Successful request example
{ "data": { "total": 2870, "items": [ { "amount": 2500000, "valuation": 30000000, "published_time": "2023-10", "name": "Convergence", "logo": "https://public.rootdata.com/uploads/public/b6/1671983908027.jpg", "rounds": "Pre-Seed", "invests": [ { "name": "C² Ventures", "logo": "https://public.rootdata.com/uploads/public/b17/1666777874118.jpg" } ] } ] }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
7. Sync Update (Pro)
- URL: https://api.rootdata.com/open/ser_change
- Method: POST
- Description: Get the list of projects and VC whose information has been updated within a unit of time. The data is updated every day. Each returned data item consumes 2 credits.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
begin_time | long | true | Start time, timestamp |
end_time | long | false | End time, timestamp |
Response field
Parameters | Type | Description |
---|---|---|
id | int | ID |
type | int | 1: Project; 2: VC |
name | string | Data names corresponding to Type types. |
update_time | long | Update time, timestamp |
Request example
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
Successful request example
{ "data": [ { "update_time": 1693974909261, "name": "Ethereum", "id": 12, "type": 1 } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
8. Top 100 Hot Crypto Projects (Pro)
- URL: https://api.rootdata.com/open/hot_index
- Method: POST
- Description: Top 100 Hot Crypto Projects, consuming 10 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
days | int | true | Only supports querying data for the past 1 day/7 days, 1 or 7. |
Response field
Parameters | Type | Description |
---|---|---|
project_id | long | Project ID |
eval | double | Heat value |
rank | int | Ranking |
logo | string | Project Logo |
one_liner | string | Introduction |
token_symbol | string | Token |
project_name | string | Project Name |
tags | array | Project tags (array of tag names) |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"days":1}' https://api.rootdata.com/open/hot_index
Successful request example
{ "data": [ { "eval": 907.936508, "project_id": 13671, "one_liner": "Hemi Network is a modular Layer...", "logo": "https://public.rootdata.com/images/b6/1721840384466.png", "rank": 1, "token_symbol": "", "project_name": "Hemi Network", "tags": [ "Infra" ] } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
9. X Hot Projects (Pro)
- URL: https://api.rootdata.com/open/hot_project_on_x
- Method: POST
- Description: Query the top X projects, consuming 10 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
heat | boolean | true | X Trending Chart |
influence | boolean | true | X Influence Ranking List |
followers | boolean | true | X Fan Count Rankings |
Response field
Parameters | Type | Description |
---|---|---|
heat | array | Popularity Ranking |
influence | array | Influence Ranking |
followers | array | Followers Ranking |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"heat":false,"influence":true,"followers":false}' https://api.rootdata.com/open/hot_project_on_x
Successful request example
{ "data": { "influence": [ { "score": "5615", "project_id": 3875, "one_liner": "Cryptocurrency exchange", "logo": "https://public.rootdata.com/images/b16/1666878846006.jpg", "project_name": "Coinbase" } ] }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
10. X Hot People (Pro)
- URL: https://api.rootdata.com/open/leading_figures_on_crypto_x
- Method: POST
- Description: Query X Hot People, consuming 10 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
page | int | false | Page number, default 1 |
page_size | int | false | Number of items per page, default 10, maximum 100. |
rank_type | string | true | "Ranking type 'hot index' or 'influence index'" |
Response field
Parameters | Type | Description |
---|---|---|
people_id | long | ID |
score | string | Hot index / Influence index |
head_img | string | Avatar |
one_liner | string | Introduction |
people_name | string | People name |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"page":1, "page_size":100,"rank_type":"heat" }' https://api.rootdata.com/open/leading_figures_on_crypto_x
Successful request example
{ "data": { "total": 1000, "items": [ { "people_id": 13994, "score": "86", "head_img": "https://public.rootdata.com/images/b12/1676887718722.jpg", "one_liner": "", "people_name": "Jieyi Long" }, { "people_id": 13185, "score": "66", "head_img": "https://public.rootdata.com/images/b12/1669175527817.jpg", "one_liner": "", "people_name": "Katie Biber" } ] }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
11. People Job Dynamics (Pro)
- URL: https://api.rootdata.com/open/job_changes
- Method: POST
- Description: People Job Dynamics, consuming 5 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
recent_joinees | boolean | true | Recent joinees. |
recent_resignations | boolean | true | Recent resignations. |
Response field
Parameters | Type | Description |
---|---|---|
recent_joinees | array | Recently joined. |
recent_joinees | array | Recently joined. |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"recent_joinees":true, "recent_resignations":true }' https://api.rootdata.com/open/job_changes
Successful request example
{ "data": { "recent_resignations": [ { "people_id": 17262, "head_img": "https://public.rootdata.com/images/b6/1702801244037.jpg", "company": "Kraken", "people_name": "Curtis Ting", "position": "VP & Head of Global Operations" } ], "recent_joinees": [ { "people_id": 17316, "head_img": "https://public.rootdata.xyz/images/b35/1717668332921.jpg", "company": "HTX", "people_name": "Test", "position": "CTO" } ] }, "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
12. Recently Issued Tokens (Pro)
- URL: https://api.rootdata.com/open/new_tokens
- Method: POST
- Description: Query recently issued tokens in the last three months, consuming 20 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
Không có dữ liệu |
Response field
Parameters | Type | Description |
---|---|---|
project_id | long | Project ID |
project_name | string | Project Name |
logo | string | Project Logo |
one_liner | string | Introduction |
token_symbol | string | Token symbol |
hap_date | string | Date |
market_cap | string | Market capitalization |
fully_diluted_market_cap | string | Fully diluted market capitalization |
exchanges | string | Exchange |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" https://api.rootdata.com/open/new_tokens
Successful request example
{ "data": [ { "fully_diluted_market_cap": "23372320.99", "market_cap": "0", "project_id": 12062, "one_liner": "Decentralized AI Agent Public Chain", "exchanges": "Gate.io,KCEX", "logo": "https://public.rootdata.com/images/b12/1711444046699.jpg", "hap_date": "2024-09-18", "token_symbol": "AGENT", "project_name": "AgentLayer" } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
13. Ecosystem Map (Pro)
- URL: https://api.rootdata.com/open/ecosystem_map
- Method: POST
- Description: Query ecosystem map,consuming 50 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | The required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
Không có dữ liệu |
Response field
Parameters | Type | Description |
---|---|---|
ecosystem_id | long | Ecosystem ID |
ecosystem_name | string | Ecosystem Name |
project_num | int | Number of projects |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" https://api.rootdata.com/open/open/ecosystem_map
Successful request example
{ "data": [ { "ecosystem_name": "Ethereum", "ecosystem_id": 52, "project_num": 2158 } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
14. Tag Map (Pro)
- URL: https://api.rootdata.com/open/tag_map
- Method: POST
- Description: Query tag map, consuming 50 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
Không có dữ liệu |
Response field
Parameters | Type | Description |
---|---|---|
tag_id | long | Tag ID |
tag_name | string | Tag name |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" https://api.rootdata.com/open/open/tag_map
Successful request example
{ "data": [ { "tag_name": "Bug Bounty", "tag_id": 52 } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
15. Obtain Projects through Ecosystem (Pro)
- URL: https://api.rootdata.com/open/projects_by_ecosystems
- Method: POST
- Description: Query projects according to ecosystems, consuming 20 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
ecosystem_ids | string | true | Ecological ID, multiple ecologies separated by commas. |
Response field
Parameters | Type | Description |
---|---|---|
project_id | long | Project ID |
project_name | string | Project Name |
logo | string | Project Logo |
one_liner | string | Introduction |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"ecosystem_ids":"52,54"}' https://api.rootdata.com/open/projects_by_ecosystems
Successful request example
{ "data": [ { "project_id": 2297, "one_liner": "Crypto bug bounty platform", "logo": "https://public.rootdata.com/images/b26/1666654548967.jpg", "project_name": "Immunefi" } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
16. Obtain Projects through Tag (Pro)
- URL: https://api.rootdata.com/open/projects_by_tags
- Method: POST
- Description: Query projects according to tags, consuming 20 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, defaults to 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
tag_ids | string | true | Tag ID, multiple ecosystems separated by commas. |
Response field
Parameters | Type | Description |
---|---|---|
project_id | long | Project ID |
project_name | string | Project Name |
logo | string | Project Logo |
one_liner | string | Introduction |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"tag_ids":"100,101"}' https://api.rootdata.com/open/projects_by_tags
Successful request example
{ "data": [ { "project_id": 2297, "one_liner": "Crypto bug bounty platform", "logo": "https://public.rootdata.com/images/b26/1666654548967.jpg", "project_name": "Immunefi" } ], "result": 200 }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
17. CEX Inflow and Outflow Dynamics (Pro)
- URL: https://api.rootdata.com/open/cex_token_top10
- Method: POST
- Description: Query CEX inflow and outflow dynamics, consuming 10 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
Không có dữ liệu |
Response field
Parameters | Type | Description |
---|---|---|
inflow_1h | array | Incoming in the last hour. |
inflow_24h | array | Inflow in the last 24 hours |
inflow_7d | array | Recent 7-day inflow |
net_inflow_1h | array | Net inflow in the last 1 hour. |
net_inflow_24h | array | Net inflow in the last 24 hours. |
net_inflow_7d | array | Net inflow in the last 7 days |
outflow_1h | array | Close to 1 hour outflow |
outflow_24h | array | Net outflow in the last 24 hours. |
outflow_7d | array | Net outflow in the past 7 days. |
net_outflow_1h | array | Net outflow in the last hour. |
net_outflow_24h | array | Net outflow in the last 24 hours. |
net_outflow_7d | array | Net outflow in the past 7 days. |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" https://api.rootdata.com/open/cex_token_top10
Successful request example
{ "result": 0, "data": { "inflow_1h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "inflow_24h": [ [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ] ], "inflow_7d": [ [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ] ], "net_inflow_1h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "net_inflow_24h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "net_inflow_7d": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "outflow_1h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "outflow_24h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "outflow_7d": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "net_outflow_1h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "net_outflow_24h": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ], "net_outflow_7d": [ { "token_symbol": "string", "logo": "string", "num": 0, "usd": 0 } ] } }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
18. Entity Funds Flow (Pro)
- URL: https://api.rootdata.com/open/get_cex
- Method: POST
- Description: Query entity funds flow ,consuming 10 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
page | int | false | Page number, default is 1 |
page_size | int | false | Items per page, default is 10, maximum is 25. |
action | string | false | inflow: inflow; outflow: outflow |
group | string | false | venture or exchange |
Response field
Parameters | Type | Description |
---|---|---|
block_time | long | Transaction timestamp |
tx | string | Transaction hash |
from_address | string | Transaction sending address |
to_address | string | Transaction receipt address |
chain_name | string | Chain name |
token_address | string | token address |
token_symbol | string | Token |
token_price | string | Token price |
token_amount | string | Number of tokens |
token_usd_value | string | Total value |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"action":"inflow"}' https://api.rootdata.com/open/get_cex
Successful request example
{ "result": 0, "data": { "total": 0, "items": [ { "block_time": 0, "tx": "string", "from_address": "string", "to_address": "string", "chain_name": "string", "token_address": "string", "token_symbol": "string", "token_price": "string", "token_amount": "string", "token_usd_value": "string" } ] } }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
19. On-chain entity positions (Pro)
- URL: https://api.rootdata.com/open/get_group_holde
- Method: POST
- Description: Query on-chain entity positions with an amount exceeding 1 million USD in entities, consuming 20 credits per query.
- Supported versions: Pro
Request header
Parameters | Type | Required | Description |
---|---|---|---|
apikey | string | true | The API key you applied for. |
language | string | false | Required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en') |
Request parameters
Parameters | Type | Required | Description |
---|---|---|---|
Không có dữ liệu |
Response field
Parameters | Type | Description |
---|---|---|
group_name | string | Entity Name |
logo | string | The word "logo" remains the same in English. If you need a translation of a specific type of logo or if it refers to something else, please provide more context! |
total_usd | string | Total position amount |
description | string | Description |
holdings | array | The term "持仓" translates to "position" in English, particularly in the context of finance or trading, referring to the quantity of a security or asset that an investor currently owns or has committed to in the market. |
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" https://api.rootdata.com/open/get_group_holde
Successful request example
{ "result": 0, "data": [ { "group_name": "string", "logo": "string", "total_usd": "string", "description": "string", "holdings": [ { "token_address": "string", "token_price": "string", "token_percent_change_24h": "string", "chain_name": "string", "chain_logo_url": "string", "token_symbol": "string", "logo": "string", "token_amount": "string", "total_usd": "string" } ] } ] }
Example of a failed request
{ "data": {}, "result": 404, "message": "error message" }
Error handling
- 110 Authentication Failed: Authentication failed.
- 400 Bad Request: The request parameters are invalid or missing.
- 403 Forbidden: Access denied, insufficient remaining credits.
- 404 Not Found: No matching information found.
- 410 High visit frequency: Your access frequency is too high, please wait one minute before resetting.
- 500 Internal Server Error: Internal server error
Authentication and Access Restrictions
This API requires an application and cannot be accessed directly. Each API key has a request limit of 30 times per minute.