Get started with RootData API

Please ensure that you comply with the relevant terms of use and restrictions when using the API, and provide appropriate attribution and references where appropriate

1. Search

  • URL: https://api.rootdata.com/open/ser_inv
  • Method: POST
  • Description: Search for project/institution brief information by project/institution name, token, introduction, unlimited number of times
  • Supported plan: Basic, Plus, Pro
Request Headers
Parameter
Type
Required
Description
apikeystringtrue The API key you applied for.
languagestringfalse Desired language version (e.g. 'en' for English, 'cn' for Chinese, 'en' is the default)
Request Parameters
Parameter
Type
Required
Description
querystringtrue Search for keywords, which can be project/institution names, tokens, or other related terms
Response Content
Parameter
Type
Description
id int
Unique identifier
type int
1: project; 2: organization
name string
name
logo string
URL of the logo
introduce string
introduce
rootdataurl string
The corresponding RootData link
Request Sample
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 Response Sample
{
  "data": [
    {
      "introduce": "Ethereum is the first decentralized, open-source blockchain with smart contract functionality, which was initially described in late 2013 in a white paper by Vitalik Buterin and launched in 2015.Ethereum serves as the foundation for an ecosystem of interoperable, decentralized applications (dApps) powered by token economies and automated smart contracts. Assets and applications designed on Ethereum are built with self-executing smart contracts that remove the need for a central authority or intermediary.\nThe network is fueled by its native cryptocurrency ether (ETH), which is used to pay transaction fees on the network. With the characteristics of open-source, programmable, private, and censorship resistant, Ethereum forms the backbone of a decentralized internet.",
      "name": "Ethereum",
      "logo": "https://api.rootdata.com/uploads/public/b15/1666341829033.jpg",
      "rootdataurl": "https://api.rootdata.com/Projects/detail/Ethereum?k=MTI=",
      "id": 12,
      "type": 1
    }
  ],
  "result": 200
}
Failed Response Sample
{
  "data": {},
  "result": 404,
  "message": "error message"
}

2. Project Query

  • URL: https://api.rootdata.com/open/get_item
  • Method: POST
  • Description: Queries for project information by project ID are limited to 1200 times per day and 30,000 times per month
  • Supported plan: Basic, Plus, Pro
Request Headers
Parameter
Type
Required
Description
apikeystringtrue The API key you applied for.
Request Parameters
Parameter
Type
Required
Description
project_idintfalse The unique identifier of the project. If both `project_id` and `contract_address` are provided, `project_id` will take precedence.
include_teamboolfalse Whether to include team member information; defaults to false
include_investorsboolfalse Whether to include investor information. Defaults to false
contract_addressstringfalse The Ethereum contract address. This parameter is optional, and will be used only if the `project_id` is not provided or applicable. Please note that if both `project_id` and `contract_address` are present, `project_id` has priority.
Response Content
Parameter
Type
Description
project_id int
Project ID
project_name string
Project name
logo string
URL of the Project logo
token_symbol string
Token symbol
establishment_date string
Date of establishment
one_liner string
One sentence introduction
description string
Project description
tags array
Project tags (Array of tag names)
social_media array
Social media links
ecosystem array
Ecosystem to which the project belongs (array, ecosystem name, no distinction between testnet and mainnet)
investors array
Investors' information
total_funding decimal
Total funding
rootdataurl string
RootData link for the project
contract_address string
Token contract address
fully_diluted_market_cap string
Fully diluted market capitalization
market_cap string
Market value in circulation
price string
Price
event array
Major project events PRO
similar_project array
Similar projects
reports array
Project news PRO
team_members array
Team members informationPRO
token_launch_time string
Token launch time, yyyy-MM
support_exchanges array
Supported exchanges include (exchange name, exchange logo)
Request Sample
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 Response Sample
{
  "data": {
    "ecosystem": [],
    "one_liner": "Building hardware for cryptography",
    "description": "Fabric Cryptography is a start-up company focusing on developing advanced crypto algorithm hardware, especially building special computer chips for Zero-knowledge proof technology.",
    "rootdataurl": "https://api.rootdata.com/Projects/detail/Fabric Cryptography?k=ODcxOQ==",
    "total_funding": 87033106304,
    "project_name": "Fabric Cryptography",
    "investors": [
      {
        "name": "Inflection",
        "logo": "https://api.rootdata.com/uploads/public/b17/1666870085112.jpg"
      },
      {
        "name": "Metaplanet",
        "logo": "https://api.rootdata.com/uploads/public/b17/1666872688748.jpg"
      },
      {
        "name": "=nil; ",
        "logo": "https://api.rootdata.com/uploads/public/b6/1674140377901.jpg"
      },
      {
        "name": "Jasper Lau"
      },
      {
        "name": "Novawulf"
      }
    ],
    "establishment_date": "2022",
    "tags": [
      "Infra",
      "zk"
    ],
    "project_id": 8719,
    "team_members": [
      {
        "medium": "",
        "website": "https://www.fabriccryptography.com/",
        "twitter": "",
        "discord": "",
        "linkedin": "https://www.linkedin.com/company/fabriccryptography/"
      }
    ],
    "logo": "https://api.rootdata.com/uploads/public/b6/1690306559722.jpg",
    "social_media": {
      "medium": "",
      "website": "https://llama.xyz/",
      "twitter": "https://twitter.com/llama",
      "discord": "",
      "linkedin": ""
    },
    "contract_address": "0x00aU9GoIGOKahBostrD",
    "fully_diluted_market_cap": "1000000",
    "market_cap": "1000000",
    "price": "1000000",
    "reports": []
  },
  "result": 200
}
Failed Response Sample
{
  "data": {},
  "result": 404,
  "message": "error message"
}

3. Organization Query

  • URL: https://api.rootdata.com/open/get_org
  • Method: POST
  • Description: Queries for organization information by organization ID are limited to 1200 times per day and 30,000 times per month
  • Supported plan: Basic, Plus, Pro
Request Headers
Parameter
Type
Required
Description
apikeystringtrue The API key you applied for.
Request Parameters
Parameter
Type
Required
Description
org_idinttrue Organization ID
include_teamboolfalse Whether to include team members' information, default is false
include_investmentsboolfalse Whether to include investment projects information, default is false
Response Content
Parameter
Type
Description
org_id int
Organization ID
org_name string
Organization Name
logo string
Organization logo URL
establishment_date string
Establishment date
description string
Description
category string
Category
social_media array
Social media links (official website, Twitter, LinkedIn)
team_members array
Team members information (array, including name, position)
investments array
Investment projects (array, including name, logo)
rootdataurl string
RootData link for the organization
Request Sample
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{"org_id":219,"include_team":true,"include_investors":true }' https://api.rootdata.com/open/get_org
Successful Response Sample
{
  "data": {
    "org_id": 219,
    "team_members": [
      {
        "name": "Shan Aggarwal",
        "position": "Head"
      },
      {
        "name": "Jonathan King",
        "position": "Principal"
      }
    ],
    "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666777683240.jpg",
    "description": "Coinbase Ventures is an investment arm of Coinbase that aims to invest in early-stage cryptocurrency and blockchain startups.",
    "rootdataurl": "https://api.rootdata.com/Investors/detail/Coinbase Ventures?k=MjE5",
    "org_name": "Coinbase Ventures",
    "category": [
      "Seed Plus"
    ],
    "investments": [
      {
        "name": "zkSync / Matter Labs",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666624791085.jpg"
      },
      {
        "name": "Uniswap",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666537174028.jpg"
      },
      {
        "name": "Animoca Brands",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666877617742.jpg"
      },
      {
        "name": "Lido",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666492251590.jpg"
      },
      {
        "name": "Ribbon Finance",
        "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666496560763.jpg"
      },
      {
        "name": "Optimism",
        "logo": "https://rdbk.rootdata.com/uploads/public/b18/1666579569788.jpg"
      },
      {
        "name": "Opensea",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666583901564.jpg"
      },
      {
        "name": "Arbitrum / Offchain Labs",
        "logo": "https://rdbk.rootdata.com/uploads/public/b23/1676000536788.jpg"
      },
      {
        "name": "Paxos",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666773577185.jpg"
      },
      {
        "name": "Connext",
        "logo": "https://rdbk.rootdata.com/uploads/public/b19/1666613592357.jpg"
      },
      {
        "name": "Worldcoin",
        "logo": "https://rdbk.rootdata.com/uploads/public/b22/1690189915541.jpg"
      },
      {
        "name": "Sei Network",
        "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666625883825.jpg"
      },
      {
        "name": "LayerZero",
        "logo": "https://rdbk.rootdata.com/uploads/public/b19/1666613304265.jpg"
      },
      {
        "name": "EigenLayer",
        "logo": "https://rdbk.rootdata.com/uploads/public/b12/1689577875078.jpg"
      },
      {
        "name": "Synthetix",
        "logo": "https://rdbk.rootdata.com/uploads/public/b15/1666361809056.jpg"
      }
    ],
    "establishment_date": "2018",
    "social_media": {
      "website": "https://www.coinbase.com/ventures",
      "twitter": "https://twitter.com/cbventures",
      "linkedin": ""
    }
  },
  "result": 200
}
Failed Response Sample
{
  "data": {},
  "result": 404,
  "message": "error message"
}

4. Query Investors (Plus, Pro)

  • URL: https://api.rootdata.com/open/get_invest
  • Method: POST
  • Description: Query basic investor information, investment portfolio, investment data analysis
  • Supported plan: Plus, Pro
Request Headers
Parameter
Type
Required
Description
apikeystringtrue The API key you applied for.
languagestringfalse Desired language version (e.g. 'en' for English, 'cn' for Chinese, 'en' is the default)
Request Parameters
Parameter
Type
Required
Description
pageintfalse Page number, '1' is the default
page_sizeintfalse The number of items per page is set to a default of 10, with a maximum limit of 200.
Response Content
Parameter
Type
Description
area array
List of regions
last_fac_date string
Date of last investment
last_invest_num int
The number of investments in the past year
invest_range array
Scale of participation
description string
Investor introduction
invest_overview object
Investment overview
type int
Type: 1 Project 2 Org 3 Member
investments array
Investment projects
establishment_date string
Date of establishment
invest_num int
Number of investments
invest_stics array
Investment map
invest_id int
Investor ID
team_members array
Team members information
logo string
Investor logo
invest_name string
Investor name
Request Sample
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 Response Sample
{
  "data": {
    "items": [
      {
        "area": [
          "Singapore",
          "United Arab Emirates"
        ],
        "last_fac_date": "2023-10-12 00:00:00",
        "last_invest_num": 25,
        "description": "Binance Labs is the venture capital and incubation arm of Binance. It identifies, invests, and empowers viable blockchain entrepreneurs, startups, and communities, providing fundraising to industry projects that help grow the wider blockchain ecosystem.",
        "invest_overview": {
          "lead_invest_num": 38,
          "last_invest_round": 25,
          "his_invest_round": 141,
          "invest_num": 171
        },
        "type": 2,
        "investments": [
          {
            "name": "zkSync / Matter Labs",
            "logo": "https://rdbk.rootdata.com/uploads/public/b16/1666624791085.jpg"
          }
        ],
        "establishment_date": "2017",
        "invest_num": 171,
        "invest_stics": [
          {
            "track": "Infrastructure",
            "invest_num": 69
          }
        ],
        "invest_id": 229,
        "invest_range": [
          {
            "lead_invest_num": 11,
            "amount_range": "1-3M",
            "lead_not_invest_num": 17,
            "invest_num": 28
          }
        ],
        "team_members": [
          {
            "head_img": "https://rdbk.rootdata.com/uploads/public/b12/1669630219503.jpg",
            "name": "Yi He",
            "X": "https://twitter.com/heyibinance",
            "position": "Head"
          }
        ],
        "logo": "https://rdbk.rootdata.com/uploads/public/b11/1666594924745.jpg",
        "invest_name": "Binance Labs"
      }
    ],
    "total": 1
  },
  "result": 200
}
Failed Response Sample
{
  "data": {},
  "result": 404,
  "message": "error message"
}

5. Query Fundraising (Plus, Pro)

  • URL: https://api.rootdata.com/open/get_fac
  • Method: POST
  • Description: Get the fundraising information of the project. (default to 2022 to now)
  • Supported plan: Plus, Pro
Request Headers
Parameter
Type
Required
Description
apikeystringtrue The API key you applied for.
languagestringfalse Desired language version (e.g. 'en' for English, 'cn' for Chinese, 'en' is the default)
Request Parameters
Parameter
Type
Required
Description
pageintfalse Page number, '1' is the default
page_sizeintfalse The number of items per page is set to a default of 10, with a maximum limit of 200.
start_timestringfalse Fundraising Announcement Date (Start). yyyy-MM
end_timestringfalse Fundraising Announcement Date (End). yyyy-MM
min_amountintfalse Minimum fundraising amount range.(USD)
max_amountintfalse Maximum fundraising amount range.(USD)
project_idintfalse Project ID
Response Content
Parameter
Type
Description
logo string
URL of the Project logo.
name string
Project name.
rounds string
Round name.
published_time string
Announcement Date of Fundraising.
amount long
Fundraising amount.(USD)
project_id int
Project ID
valuation long
Valuation.(USD)
invests array
Investor information, including Logo and name.
Request Sample
curl -X POST -H "apikey: Your APIKEY" -H "language: en" -H "Content-Type: application/json" -d '{ }' https://api.rootdata.com/open/get_fac
Successful Response Sample
{
  "data": {
    "total": 2870,
    "items": [
      {
        "amount": 2500000,
        "valuation": 30000000,
        "published_time": "2023-10",
        "name": "Convergence",
        "logo": "https://rdbk.rootdata.com/uploads/public/b6/1671983908027.jpg",
        "rounds": "Pre-Seed",
        "invests": [
          {
            "name": "C² Ventures",
            "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666777874118.jpg"
          },
          {
            "name": "Big Brain Holdings",
            "logo": "https://rdbk.rootdata.com/uploads/public/b17/1666778919102.jpg"
          },
          {
            "name": "Israeli Blockchain Association",
            "logo": "https://rdbk.rootdata.com/uploads/public/b26/1668496875036.jpg"
          }
        ]
      }
    ]
  },
  "result": 200
}
Failed Response Sample
{
  "data": {},
  "result": 404,
  "message": "error message"
}

6. Synchronous Updates (Pro)

  • URL: https://api.rootdata.com/open/ser_change
  • Method: POST
  • Description: Get the updated data in unit time period. The data is updated every day, and the limit is 1 time per day
  • Supported plan: Pro
Request Headers
Parameter
Type
Required
Description
apikeystringtrue The API key you applied for.
languagestringfalse Desired language version (e.g. 'en' for English, 'cn' for Chinese, 'en' is the default)
Request Parameters
Parameter
Type
Required
Description
begin_timelongtrue Begin time, timestamp
end_timelongtrue End time, timestamp
Response Content
Parameter
Type
Description
id int
ID
type int
1: Project, 2: Organization
name string
Data name corresponding to the type.
update_time long
Update time, timestamp.
Request Sample
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 Response Sample
{
  "data": [
    {
      "update_time": 1693974909261,
      "name": "Ethereum",
      "id": 12,
      "type": 1
    }
  ],
  "result": 200
}
Failed Response Sample
{
  "data": {},
  "result": 404,
  "message": "error message"
}

Error Handling

  • 110 Authentication Failed: Authentication Failed
  • 400 Bad Request: Request parameters are invalid or missing
  • 403 Forbidden: Access denied, access limit reached
  • 404 Not Found: No matching information found
  • 410 High visit frequency: Your visit frequency is too high. Please wait for one minute before resetting
  • 500 Internal Server Error: Internal Server Error

Authentication and access restrictions

This API cannot be accessed directly and requires a specific request. Each API Key is limited to 30 requests per minute.