RootData Crypto

RootData Crypto Intelligence

RootData is a leading Web3 data platform covering crypto projects, investors, funding data, and personnel movements.

First-Time Setup

Check if environment variable ROOTDATA_SKILL_KEY exists.

If it does NOT exist, call:

POST https://api.rootdata.com/open/skill/init
Content-Type: application/json
Body: {}

Save the returned api_key as environment variable ROOTDATA_SKILL_KEY. Confirm to user: "RootData access is ready. You can now query crypto data."

All requests below must include these headers:

Authorization: Bearer {ROOTDATA_SKILL_KEY}
Content-Type: application/json

Security note: The API key generated by /skill/init is an anonymous, low-privilege key used solely to call RootData's public data endpoints. It will be stored by your agent as a local environment variable (ROOTDATA_SKILL_KEY). This key has no access to any personal account data. You can revoke it at any time by contacting RootData support.

Skill 1: Search

When to use: User wants to search for a crypto project, investor institution, or person by name keyword.

Request:

POST https://api.rootdata.com/open/skill/ser_inv
Body:
{
  "query": "",
  "precise_x_search": false
}

Key response fields:

Skill 2: Get All IDs by Type

When to use: User asks for a complete list of all project IDs, institution IDs, or person IDs.

Request:

POST https://api.rootdata.com/open/skill/id_map
Body:
{
  "type": <1=Project | 2=Institution | 3=Person>
}

Key response fields:

Skill 3: Project Detail

When to use: User asks for detailed information about a specific crypto project (by project ID or contract address).

Request:

POST https://api.rootdata.com/open/skill/get_item
Body:
{
  "project_id": ,
  "include_investors": true
}

Or query by contract address:

{
  "contract_address": "<0x...>",
  "include_investors": true
}

Key response fields:

Skill 4: Funding Rounds

When to use: User asks about funding history, investment rounds, "how much did XX raise", or "who invested in XX".

Data range: Covers funding rounds from the past 365 days only. If user requests data older than one year, the API will automatically return only the most recent 365 days of data.

Investor limit: Each funding round returns a maximum of 3 investors (prioritized by lead investors first).

Request:

POST https://api.rootdata.com/open/skill/get_fac
Body:
{
  "page": 1,
  "page_size": 20,
  "project_id": ,
  "start_time": "",
  "end_time": "",
  "min_amount": ,
  "max_amount": 
}

All fields are optional. Omit any field not specified by the user.

Key response fields:

Note: The valuation field has been removed from the response.

Skill 5: Trending Projects

When to use: User asks "what's hot in crypto today", "trending projects", "top projects this week", or similar.

Request:

POST https://api.rootdata.com/open/skill/hot_index
Body:
{
  "days": <1 = today's trending | 7 = this week's trending>
}

Key response fields:

Skill 6: Personnel Job Changes

When to use: User asks about recent job changes in crypto, "who joined which project", "who left which company", personnel movements, or executive changes in the Web3 industry.

Data limit: Returns a maximum of 20 recent entries for each category (joinees and resignations).

Request:

POST https://api.rootdata.com/open/skill/job_changes
Body:
{
  "recent_joinees": true,
  "recent_resignations": true
}

Parameters:

Key response fields:

Example use cases:

Multi-Language Support

Add header language: cn for Chinese responses, or language: en for English (default).

All name fields, descriptions, and position titles will be returned in the requested language.

Rate Limits

Error Codes

Best Practices

1. Always initialize first: Check for ROOTDATA_SKILL_KEY before making any requests 2. Cache results: Responses are cached for 5-10 minutes, repeated queries will be faster 3. Use specific queries: More specific search keywords yield better results 4. Follow rate limits: Monitor X-RateLimit-Remaining header to avoid hitting limits 5. Handle errors gracefully: Check result field in response (200 = success) 6. Provide context: When showing funding data, mention it covers the past 365 days only 7. Investor limit: When showing funding rounds, note that only top 3 investors are displayed per round

Version History

v1.0.3 (2026-03-30)

v1.0.2

1. Always initialize first: Check for ROOTDATA_SKILL_KEY before making any requests 2. Cache results: Responses are cached for 5-10 minutes, repeated queries will be faster 3. Use specific queries: More specific search keywords yield better results 4. Follow rate limits: Monitor X-RateLimit-Remaining header to avoid hitting limits 5. Handle errors gracefully: Check result field in response (200 = success) 6. Provide context: When showing funding data, mention it covers the past 365 days only 7. Investor limit: When showing funding rounds, note that only top 3 investors are displayed per round