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 for projects/institutions/people.
- URL: https://api.rootdata.com/open/ser_inv
- Method: POST
- Description: Search for brief information about projects/institutions/individuals using project/institution/individual names, tokens, summaries, and introductions, 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/institution names, tokens, or other related terms. |
Response field
Parameters | Type | Description |
---|---|---|
id | int | Unique Identifier |
type | int | 1 Project; 2 Organization; 3 Person |
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. Acquire the 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 chain 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: Stopped operating |
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. Acquire institution
- URL: https://api.rootdata.com/open/get_org
- Method: POST
- Description: Querying organization information through the organization ID consumes 2 credits per request.
- 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 | Institution 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 | Organization ID |
org_name | string | Organization Name |
logo | string | URL of the organization logo |
establishment_date | string | Establishment time |
description | string | Detailed introduction |
active | boolean | true: Operating; false: Stopped operating |
category | string | Type |
social_media | array | Social media links (official website, Twitter, LinkedIn) |
investments | array | Investment projects (array, including name, logo) |
rootdataurl | string | The RootData link corresponding to the institution. |
team_members | array | Team member information (array, including name and position) PRO |
heat | string | X Heat 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 followersPRO |
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. Get Character (Pro)
- URL: https://api.rootdata.com/open/get_people
- Method: POST
- Description: Query project information using the character ID, costing 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 | Character ID |
Response field
Parameters | Type | Description |
---|---|---|
people_id | long | ID |
introduce | string | Character Introduction |
head_img | string | Avatar |
one_liner | string | Introduction |
X | string | X link |
people_name | string | Character 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. Bulk acquisition of investor information (Plus, Pro)
- URL: https://api.rootdata.com/open/get_invest
- Method: POST
- Description: Query basic information about investors, investment portfolios, and investment data analysis, 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 Organization 3 Person |
investments | array | Foreign investment projects |
establishment_date | string | Establishment date |
invest_num | int | Number of investments |
invest_stics | array | Investment Landscape |
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. Batch obtain investment round information (Plus, Pro)
- URL: https://api.rootdata.com/open/get_fac
- Method: POST
- Description: Batch acquisition of investment round information (default from 2022 to present), each data entry consumes 3 credits.
- 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 | Investment entity information 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. Synchronous Update (Pro)
- URL: https://api.rootdata.com/open/ser_change
- Method: POST
- Description: Obtain updated data within a specific time period. The data is updated daily, and each returned data entry 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: Institution |
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 Popular Projects (Pro)
- URL: https://api.rootdata.com/open/hot_index
- Method: POST
- Description: Popular projects Top 100, consuming 10 credits per access.
- 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: Querying the top X projects consumes 10 credits per time.
- 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 | Fan 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 Popular Figures (Pro)
- URL: https://api.rootdata.com/open/leading_figures_on_crypto_x
- Method: POST
- Description: Query X popular figures, cost 10 credits per time.
- 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 'heat' or 'influence'" |
Response field
Parameters | Type | Description |
---|---|---|
people_id | long | ID |
score | string | Popularity value / Influence index |
head_img | string | Avatar |
one_liner | string | Introduction |
people_name | string | Character 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. Personnel Position Dynamics (Pro)
- URL: https://api.rootdata.com/open/job_changes
- Method: POST
- Description: Recent job changes, consuming 5 credits per instance.
- 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 | Recently joined the company. |
recent_resignations | boolean | true | Recent resignation. |
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. Recent Token Issuance Projects (Pro)
- URL: https://api.rootdata.com/open/new_tokens
- Method: POST
- Description: Projects that issue tokens in the last three months consume 20 credits per time.
- 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 |
---|---|---|---|
No Data |
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 | Time of the incident |
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. Ecological Map (Pro)
- URL: https://api.rootdata.com/open/ecosystem_map
- Method: POST
- Description: Ecological map, consumes 50 credits per use.
- 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 |
---|---|---|---|
No Data |
Response field
Parameters | Type | Description |
---|---|---|
ecosystem_id | long | Ecological ID |
ecosystem_name | string | Ecological 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. Label Map (Pro)
- URL: https://api.rootdata.com/open/tag_map
- Method: POST
- Description: Label map, costs 50 credits per use.
- 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 |
---|---|---|---|
No Data |
Response field
Parameters | Type | Description |
---|---|---|
tag_id | long | Tag ID |
tag_name | string | Label 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. According to the Ecological Acquisition Project (Pro)
- URL: https://api.rootdata.com/open/projects_by_ecosystems
- Method: POST
- Description: According to the ecological acquisition project, it costs 20 credits per use.
- 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. Search for projects by tag (Pro)
- URL: https://api.rootdata.com/open/projects_by_tags
- Method: POST
- Description: Check the project by label, consuming 20 credits per use.
- 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" }
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.