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 Project/VC/People

  • URL: https://api.rootdata.com/open/ser_inv
  • Method: POST
  • Description: Search project/VC/people brief information according to keywords, unlimited times.
  • Supported versions: Basic, Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
querystringtrueSearch keywords, which can be project/VC names, tokens, or other related terms.
precise_x_searchbooleanfalseBased on X Handle (@...), accurately search for corresponding entity.
Response field
ParametersTypeDescription
idintUnique Identifier
typeint1 Project; 2 VC; 3 People
namestringName
logostringURL of the logo
introducestringIntroduction
activebooleantrue: Active; false: Inactive
rootdataurlstringCorresponding 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. Get the balance of apikey

  • URL: https://api.rootdata.com/open/quotacredits
  • Method: POST
  • Description: Check the remaining credits of your apikey, free of charge.
  • Supported versions: Basic, Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters

No data

Response field
ParametersTypeDescription
apikeystringapikey
startlongStart Date
endlongEnd Date
levelstringAPI Key Level
total_creditsintTotal Credits
creditsintCurrent Remaining Credits
last_mo_creditsintLast Month's Balance Credits
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json"  https://api.rootdata.com/open/quotacredits
Successful request example
{
  "data": {
    "last_mo_credits": 60000,
    "apikey": "XXX",
    "level": "pro",
    "credits": 59688,
    "total_credits": 60000,
    "start": 1721750400000,
    "end": 1787846399000
  },
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

3. Get the ID list

  • URL: https://api.rootdata.com/open/id_map
  • Method: POST
  • Description: Get the ID list of all projects, people and VCs, 20 Credits/time.
  • Supported versions: Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
typeinttrueType: 1 Project 2 VC 3 People
Response field
ParametersTypeDescription
idlongid
namestringname
token_symbolstringToken Ticker
activebooleantrue: Active; false: Inactive
project_typestringCrypto or Non-Crypto
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json"  -d '{"type": 1 }'  https://api.rootdata.com/open/id_map
Successful request example
{
  "data": {
    "id": 600,
    "name": "XXX"
  },
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

4. Get Projects

  • URL: https://api.rootdata.com/open/get_item
  • Method: POST
  • Description: Obtain project details according to the project ID, 2 Credits/times.
  • Supported versions: Basic, Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe APIKEY you applied for
Request parameters
ParametersTypeRequiredDescription
project_idintfalseOne of project_id or contract_address is required.
contract_addressstringfalseOne of project_id or contract_address is required.
include_teambooleanfalseWhether to include team member information, default is false.
include_investorsbooleanfalseWhether to include investor information, default is false.
Response field
ParametersTypeDescription
project_idintProject ID
project_namestringProject Name
logostringThe URL of the project logo.
token_symbolstringToken Ticker
establishment_datestringEstablishment date
one_linerstringA brief introduction.
descriptionstringDetailed introduction
activebooleantrue: Active; false: Inactive
total_fundingdecimalTotal fundraising amount
countriesarrayWhere the company operates (Country/Region)
rd_scoredecimalRD Growth Index score
rd_rankintRD Growth Index ranking
rd_hot_indexdecimalRD Hot Index
tagsarrayProject tags (array of tag names)
rootdataurlstringThe RootData link corresponding to the project.
transparencystringTransparency score
project_typestringCrypto or Non-Crypto
investorsarrayInvestor Information
social_mediaarraySocial media link
similar_projectarraySimilar projects
ecosystemarrayProject's associated ecosystem (array, ecosystem name, not distinguishing between testnet and mainnet) PRO
on_main_netarrayMainnet launched (array, ecosystem name) PRO
plan_to_launcharrayPlanned ecosystem (array, ecosystem name) PRO
on_test_netarrayTestnet launched (array, ecosystem name) PRO
fully_diluted_market_capstringFully diluted market capitalizationPRO
market_capstringMarket capitalization PRO
pricestringPrice PRO
eventarrayMajor Project Events PRO
reportsarrayNews dynamic data PRO
team_membersarrayTeam Member Information PRO
former_team_membersarrayFormer Team Member Information PRO
token_launch_timestringToken issuance time yyyy-MMPRO
contractsarraySmart Contract AddressPRO
support_exchangesarraySupported exchanges include (exchange name, exchange logo) PRO
heatstringX Hot Index PRO
heat_rankintX Hot Ranking PRO
influencestringX Influence IndexPRO
influence_rankintX Influence Ranking PRO
followersintNumber of followersPRO
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"
}

5. Get VC

  • URL: https://api.rootdata.com/open/get_org
  • Method: POST
  • Description: Obtain VC details according to VC ID, 2 Credits/times.
  • Supported versions: Basic, Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe APIKEY you applied for
Request parameters
ParametersTypeRequiredDescription
org_idinttrueVC ID
include_teambooleanfalseWhether to include team member information, default is false.
include_investmentsbooleanfalseWhether it includes investment project information, default is false.
Response field
ParametersTypeDescription
org_idintVC ID
org_namestringVC Name
logostringURL of the VC logo
establishment_datestringEstablishment time
descriptionstringDetailed introduction
activebooleanttrue: Active; false: Inactive
categorystringInvestor Type
social_mediaarraySocial media links (official website, Twitter, LinkedIn)
investmentsarrayInvestment projects (array, including name, logo)
rootdataurlstringThe RootData link corresponding to the institution.
team_membersarrayTeam member information (array, including name and position) PRO
heatstringX Hot Index PRO
heat_rankintX Hot Ranking PRO
influencestringX Influence IndexPRO
influence_rankintX Influence Ranking PRO
followersintNumber of followers PRO
followingintNumber of followingPRO
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"
}

6. Get People (Pro)

  • URL: https://api.rootdata.com/open/get_people
  • Method: POST
  • Description: Obtain the people details according to the people ID, 2 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API KEY you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
people_idlongtruePeople ID
Response field
ParametersTypeDescription
people_idlongID
introducestringDetailed Introduction
head_imgstringLogo
one_linerstringOne sentence introduction
XstringX link
people_namestringPeople name
linkedinstringLinkedIn Link
heatstringX Hot Index
heat_rankintX Hot Ranking
influencestringX Influence Index
influence_rankintX Influence Ranking
followersintNumber of followers
followingintNumber of following
education_experiencearrayEducation experience list
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"people_id":12972 }' 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"
}

7. Get Calendar Events (Pro)

  • URL: https://api.rootdata.com/open/get_event
  • Method: POST
  • Description: Get project calendar event data in batches. Supports filtering by project ID, time range, and event type. 1 credit/record.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
pageintfalsePage number, default 1
page_sizeintfalseNumber of items per page, default is 10, maximum is 100.
m_idlongfalseProject ID. If not provided, returns events for all projects.
begin_timestringfalseEvent start date (yyyy-MM-dd), filters on hap_date field.
end_timestringfalseEvent end date (yyyy-MM-dd), filters on hap_date field.
typeintfalseEvent type: 1 Mainnet Launch, 2 Testnet Launch, 3 Security Incident, 4 Token Issuance (includes latest and planned), 5 Death Events, 7 Product Progress, 9 Others, 13 Unlock, 16 Conference & Event, 21 Incentive Events, 22 Public Sale Events. If not provided, returns all supported types.
Response field
ParametersTypeDescription
idlongEvent ID
project_idlongProject ID
namestringProject name
logostringProject logo URL
typeintEvent type: 1 Mainnet Launch, 2 Testnet Launch, 3 Security Incident, 4 Token Issuance, 5 Death Events, 7 Product Progress, 9 Others, 13 Unlock, 16 Conference & Event, 21 Incentive Events, 22 Public Sale Events
type_namestringEvent type name (e.g. Mainnet Launch, Token Issuance, Security Incident, etc.)
hap_datestringEvent occurrence date (yyyy-MM-dd)
o_namestringEvent title/description (multilingual JSON with cn_value and en_value)
site_urlstringEvent related URL
start_datestringEvent start date (yyyy-MM-dd, used for conference & event types)
end_datestringEvent end date (yyyy-MM-dd, used for conference & event types)
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"page":1,"page_size":10,"m_id":12,"begin_time":"2024-01-01","end_time":"2024-12-31","type":4}' https://api.rootdata.com/open/get_event
Successful request example
{
  "data": {
    "total": 2,
    "items": [
      {
        "id": 10001,
        "project_id": 12,
        "name": "Ethereum",
        "logo": "https://public.rootdata.com/uploads/public/b15/1666341829033.jpg",
        "type": 4,
        "type_name": "Token Issuance",
        "hap_date": "2024-03-15",
        "description": "Ethereum token launch event",
        "site_url": "https://ethereum.org",
        "start_date": null,
        "end_date": null
      },
      {
        "id": 10002,
        "project_id": 8719,
        "name": "Fabric Cryptography",
        "logo": "https://public.rootdata.com/uploads/public/b6/1690306559722.jpg",
        "type": 22,
        "type_name": "Public Sale Events",
        "hap_date": "2024-06-01",
        "description": "Public sale event",
        "site_url": "https://fabriccryptography.com",
        "start_date": null,
        "end_date": null
      }
    ]
  },
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

8. Get Invetsor info in batches (Plus, Pro)

  • URL: https://api.rootdata.com/open/get_invest
  • Method: POST
  • Description: Get detailed VC information (portfolio, data analysis, etc.) in batches, each piece of data consumes 2 credits.
  • Supported versions: Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
pageintfalsePage number, default 1
page_sizeintfalseNumber of items per page, default is 10, maximum is 100.
Response field
ParametersTypeDescription
invest_namestringInvestor Name
typeintType: 1 Project 2 VC 3 People
invest_idintInvestor ID
logostringInvestor Logo
areaarrayList of regions
last_fac_datestringRecent investment time
last_invest_numintNumber of investments in the past year
invest_rangearrayInvestment scale
descriptionstringInvestor Introduction
invest_overviewobjectInvestment Overview
investmentsarrayForeign investment projects
establishment_datestringEstablishment date
invest_numintNumber of investments
invest_sticsarrayInvestment Landscape
team_membersarrayTeam member information
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"
}

9. Get X data rounds in batches (Plus, Pro)

  • URL: https://api.rootdata.com/open/twitter_map
  • Method: POST
  • Description: Batch export of all X data, including links, number of followers, X influence index, etc., 50 Credits/time.
  • Supported versions: Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
typeinttrueType: 1 Project 2 VC 3 People
Response field
ParametersTypeDescription
idlongid
namestringname
XstringX
followersintNumber of followers
followingintNumber of following
heatstringX Hot Index
influencestringX Influence Index
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json"  -d '{"type": 1 }'  https://api.rootdata.com/open/twitter_map
Successful request example
{
  "data": {
    "id": 600,
    "name": "XXX",
    "X": "XXX"
  },
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

10. Get Fundraising rounds in batches (Plus, Pro)

  • URL: https://api.rootdata.com/open/get_fac
  • Method: POST
  • Description: Get fundraising rounds (only supports 2018 to present) in batches, each piece of data consumes 2 credits.
  • Supported versions: Plus, Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
pageintfalsePage number, default 1.
page_sizeintfalseNumber of items per page, default is 10, maximum is 200.
start_timestringfalseAnnouncement date (start) yyyy-MM
end_timestringfalseAnnouncement date (end) yyyy-MM
min_amountintfalseMinimum fundraising amount (in USD)
max_amountintfalseMaximum fundraising amount (USD)
project_idintfalseProject ID
idlongfalseFinancing record ID for precise single record query, can be combined with other filter conditions.
Response field
ParametersTypeDescription
idlongFinancing record ID
logostringThe URL of the project logo.
namestringProject Name
roundsstringRound Name
published_timestringAnnouncement date
amountlongFundraising amount (USD)
project_idintProject ID
valuationlongValuation (USD)
investsarrayInvestor information array, including Logo and Name.
data_statusintWhether this financing is credible
source_urlstringThe link to the source of this financing information
XstringX link
one_linerstringA brief introduction.
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"
}

11. Synchronous Update (Pro)

  • URL: https://api.rootdata.com/open/ser_change
  • Method: POST
  • Description: Obtain a list of projects updated with data within a unit time, 2 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
begin_timelongtrueStart time, timestamp
end_timelongfalseEnd time, timestamp
typeintfalseEntity type filter: 1 Project, 2 VC, 3 People, 6 Financing. If not provided, returns all types.
Response field
ParametersTypeDescription
idintID
typeintEntity type filter:1 Project,2 VC, 3 People, 6 Financing. lf not provided, returns all types.
namestringName
update_timelongUpdate 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"
}

12. Top 100 Ranking by RD Hot Index (Pro)

  • URL: https://api.rootdata.com/open/hot_index
  • Method: POST
  • Description: Get the list of Top100 hot projects and their basic information, 20 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
daysinttrueOnly supports querying data for the past 1 day/7 days, 1 or 7.
Response field
ParametersTypeDescription
project_idlongProject ID
rd_hot_indexdoubleHot Index
rankintRanking
logostringProject Logo
one_linerstringOne sentence introduction
token_symbolstringToken
project_namestringProject Name
tagsarrayProject 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": [
    {
      "rd_hot_index": 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"
}

13. Top 300 Ranking by RD Growth Index (Pro)

  • URL: https://api.rootdata.com/open/get_rd_top300
  • Method: POST
  • Description: Get today's RD Growth Index Top 300 project ranking list, including project ID, name, logo, score and rank. 20 credits/time.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters

No data

Response field
ParametersTypeDescription
project_idlongProject ID
project_namestringProject Name
logostringProject Logo URL
rd_scoredecimalRD Growth Index score
rd_rankintRD Growth Index ranking (1~300)
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{}' https://api.rootdata.com/open/get_rd_top300
Successful request example
{
  "data": [
    {
      "project_id": 12,
      "project_name": "Ethereum",
      "logo": "https://public.rootdata.com/uploads/public/b15/1666341829033.jpg",
      "rd_score": 985.32,
      "rd_rank": 1
    },
    {
      "project_id": 8719,
      "project_name": "Fabric Cryptography",
      "logo": "https://public.rootdata.com/uploads/public/b6/1690306559722.jpg",
      "rd_score": 901.1,
      "rd_rank": 2
    }
  ],
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

14. Stock Contract Exchange Ranking (Pro)

  • URL: https://api.rootdata.com/open/stock_leaderboard
  • Method: POST
  • Description: Get the exchange stock perpetual contract ranking leaderboard (always reads the latest full batch of leaderboard data) 20 credits/time.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters

No data

Response field
ParametersTypeDescription
rankintRank
exchangestringExchange identifier
scoredecimalOverall score (0-100)
contract_countintNumber of valid stock contracts
open_interest_change_pctstring24h open interest change rate (percentage, e.g. "3.10%"; null when no comparable historical data)
turnover_24h_change_pctstring24h turnover change rate (percentage; null when no comparable historical data)
weighted_depth_2pct_usddecimalWeighted ±2% depth (USD)
spread_pctstringTurnover-weighted average spread (percentage)
funding_rate_pctstring24h funding rate (percentage)
maker_fee_ratestringMaker fee rate (single value or range, e.g. "0.0200%" or "0.0200% - 0.0400%")
taker_fee_ratestringTaker fee rate (single value or range)
marginstringMargin settlement currency (e.g. USDT; multiple currencies separated by /)
max_leverageintMaximum leverage multiplier
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" https://api.rootdata.com/open/stock_leaderboard
Successful request example
{
  "data": [
    {
      "rank": 1,
      "exchange": "okx",
      "score": 92.5,
      "contract_count": 48,
      "open_interest_change_pct": "3.10%",
      "turnover_24h_change_pct": "-5.20%",
      "weighted_depth_2pct_usd": 1520000.5,
      "spread_pct": "0.0500%",
      "funding_rate_pct": "0.0100%",
      "maker_fee_rate": "0.0200%",
      "taker_fee_rate": "0.0500%",
      "margin": "USDT",
      "max_leverage": 20
    },
    {
      "rank": 2,
      "exchange": "bybit",
      "score": 89.1,
      "contract_count": 41,
      "open_interest_change_pct": null,
      "turnover_24h_change_pct": "-2.40%",
      "weighted_depth_2pct_usd": 980000,
      "spread_pct": "0.0600%",
      "funding_rate_pct": "0.0080%",
      "maker_fee_rate": "0.0200% - 0.0400%",
      "taker_fee_rate": "0.0500% - 0.0700%",
      "margin": "USDT",
      "max_leverage": 10
    }
  ],
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

15. X Hot Projects (Pro)

  • URL: https://api.rootdata.com/open/hot_project_on_x
  • Method: POST
  • Description: Get the current list of X hot projects, 10 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
heatbooleantrueX Hot Projects Ranking List
influencebooleantrueX Influence Ranking List
followersbooleantrueX Followers Ranking
Response field
ParametersTypeDescription
heatarrayHot Ranking
influencearrayInfluence Ranking
followersarrayFollowers 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"
}

16. X Popular Figures (Pro)

  • URL: https://api.rootdata.com/open/leading_figures_on_crypto_x
  • Method: POST
  • Description: Get the current list of hot people in X, 10 credits/time.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
pageintfalsePage number, default 1
page_sizeintfalseNumber of items per page, default 10, maximum 100.
rank_typestringtrue"Ranking type 'heat' or 'influence'"
Response field
ParametersTypeDescription
people_idlongID
scorestringHot Index / Influence Index
head_imgstringLogo
one_linerstringOne sentence introduction
people_namestringPeople 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"
}

17. X Follow Relationship Detail (Pro)

  • URL: https://api.rootdata.com/open/twitter_follow_detail
  • Method: POST
  • Description: Query the follow/unfollow activity in the past 14 days and top followers list by X (Twitter) account handle. 1 credit/time.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
twitter_accountstringtrueX (Twitter) account handle, with or without the @ prefix (e.g. "@rootdata_xyz" or "rootdata_xyz")
Response field
ParametersTypeDescription
follow_updatesarrayFollow activity list for the past 14 days, sorted by date descending. Each entry corresponds to one batch date.
top_followersarrayList of high-influence entities following this account (up to 50), sorted by X influence index descending.
Request example
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"twitter_account":"@ethereum"}' https://api.rootdata.com/open/twitter_follow_detail
Successful request example
{
  "data": {
    "follow_updates": [
      {
        "date": "20240415",
        "follows": [
          {
            "type": "1",
            "id": "12",
            "name": "Ethereum",
            "one_liner": "Decentralized blockchain platform",
            "twitter_name": "Ethereum",
            "twitter_logo": "https://public.rootdata.com/uploads/b15/logo.jpg",
            "twitter_url": "https://twitter.com/ethereum",
            "twitter_handle": "ethereum"
          }
        ],
        "unfollows": [],
        "followers": [],
        "unfollowers": []
      }
    ],
    "top_followers": [
      {
        "type": "2",
        "id": "229",
        "name": "Coinbase Ventures",
        "one_liner": "Investment arm of Coinbase",
        "twitter_name": "Coinbase Ventures",
        "twitter_logo": "https://public.rootdata.com/uploads/b17/logo.jpg",
        "twitter_url": "https://twitter.com/cbventures",
        "twitter_handle": "cbventures"
      }
    ]
  },
  "result": 200
}
Example of a failed request
{
  "data": {},
  "result": 404,
  "message": "error message"
}

18. People Position Dynamics (Pro)

  • URL: https://api.rootdata.com/open/job_changes
  • Method: POST
  • Description: Get dynamic data on prople positions, 10 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
recent_joineesbooleantrueRecent employment.
recent_resignationsbooleantrueRecent resignation.
Response field
ParametersTypeDescription
recent_joineesarrayRecent employment.
recent_resignationsarrayRecent resignation.
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"
}

19. Ecosystem Map (Pro)

  • URL: https://api.rootdata.com/open/ecosystem_map
  • Method: POST
  • Description: Get ecosystem map list, 50 credits/time.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseThe required language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters

No data

Response field
ParametersTypeDescription
ecosystem_idlongEcosystem ID
ecosystem_namestringEcosystem Name
project_numintNumber 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"
}

20. Tag Map (Pro)

  • URL: https://api.rootdata.com/open/tag_map
  • Method: POST
  • Description: Get tags map list, 50 credits/time.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters

No data

Response field
ParametersTypeDescription
tag_idlongTag ID
tag_namestringTag 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"
}

21. Get Projects based on Ecosystem (Pro)

  • URL: https://api.rootdata.com/open/projects_by_ecosystems
  • Method: POST
  • Description: Obtain project information in bulk based on ecosystem, 20 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, default is 'en')
Request parameters
ParametersTypeRequiredDescription
ecosystem_idsstringtrueEcosystem ID, multiple ecologies separated by commas.
Response field
ParametersTypeDescription
project_idlongProject ID
project_namestringProject Name
logostringProject Logo
one_linerstringOne sentence 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"
}

22. Get Projects based on Tag (Pro)

  • URL: https://api.rootdata.com/open/projects_by_tags
  • Method: POST
  • Description: Obtain project information in bulk based on tag, 20 credits/times.
  • Supported versions: Pro
Request header
ParametersTypeRequiredDescription
apikeystringtrueThe API key you applied for.
languagestringfalseRequired language version (for example: 'en' for English, 'cn' for Chinese, defaults to 'en')
Request parameters
ParametersTypeRequiredDescription
tag_idsstringtrueTag ID, multiple ecosystems separated by commas.
Response field
ParametersTypeDescription
project_idlongProject ID
project_namestringProject Name
logostringProject Logo
one_linerstringOne sentence 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 100 times per minute.

  • 1. Search for Project/VC/People
  • 2. Get the balance of apikey
  • 3. Get the ID list
  • 4. Get Projects
  • 5. Get VC
  • 6. Get People (Pro)
  • 7. Get Calendar Events (Pro)
  • 8. Get Invetsor info in batches (Plus, Pro)
  • 9. Get X data rounds in batches (Plus, Pro)
  • 10. Get Fundraising rounds in batches (Plus, Pro)
  • 11. Synchronous Update (Pro)
  • 12. Top 100 Ranking by RD Hot Index (Pro)
  • 13. Top 300 Ranking by RD Growth Index (Pro)
  • 14. Stock Contract Exchange Ranking (Pro)
  • 15. X Hot Projects (Pro)
  • 16. X Popular Figures (Pro)
  • 17. X Follow Relationship Detail (Pro)
  • 18. People Position Dynamics (Pro)
  • 19. Ecosystem Map (Pro)
  • 20. Tag Map (Pro)
  • 21. Get Projects based on Ecosystem (Pro)
  • 22. Get Projects based on Tag (Pro)