rootdata

RootData

RootData Web3 intelligence API for:

• project / investor / person search
• project detail lookup
• recent funding rounds
• trending projects (daily / weekly)
• personnel job changes

Script Usage

This is a script-mode skill. Use from a bash block:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/rootdata")
from exports import rd_search, rd_project_detail, rd_funding_rounds

print(rd_search(query="berachain")[:2])
print(rd_project_detail(project_id=3375, include_investors=True).get("project_name"))
print(rd_funding_rounds(page=1, page_size=5).get("total"))
EOF

Available functions in exports.py: rd_init_key, rd_search, rd_id_map, rd_project_detail, rd_funding_rounds, rd_hot_index, rd_job_changes.

First-Time Setup (auto-init key)

RootData provides an anonymous low-privilege key via init API.

• Env var used by this skill: ROOTDATA_SKILL_KEY
• If the var is missing, call rd_init_key() once and persist it to your environment.

Init endpoint:

• POST https://api.rootdata.com/open/skill/init
• body: {}
• returns api_key

Functions

rd_init_key()

Get a new anonymous API key from RootData init endpoint.

Returns dict:

• api_key
• message

rd_search(query, precise_x_search=False, language='en')

Search projects / investors / people by keyword.

Endpoint: POST /open/skill/ser_inv

Body:

• query: string
• precise_x_search: bool

Returns list of entities. Common fields:

• id
• type (1=project, 2=institution, 3=person)
• name
• one_liner
• introduce
• rootdataurl

rd_id_map(type, language='en')

Get all IDs by type.

Endpoint: POST /open/skill/id_map

Body:

• type: 1 (project) | 2 (institution) | 3 (person)

Returns list with id, name.

rd_project_detail(project_id=None, contract_address=None, include_investors=True, language='en')

Get project detail by project_id or contract address.

Endpoint: POST /open/skill/get_item

Body (one of):

• project_id: int
• contract_address: string
• include_investors: bool

Returns project detail (fields vary), often including:

• project_id, project_name, token_symbol
• one_liner, description, tags
• contracts, social_media
• total_funding
• investors (when requested)

rd_funding_rounds(page=1, page_size=20, project_id=None, start_time=None, end_time=None, min_amount=None, max_amount=None, language='en')

Get funding round list with filters.

Endpoint: POST /open/skill/get_fac

Notes:

• data covers past 365 days
• max 3 investors per round
• valuation field removed upstream

Returns dict:

• total
• items (list)

rd_hot_index(days=1, language='en')

Get trending project ranking.

Endpoint: POST /open/skill/hot_index

Body:

• days: 1 (today) | 7 (this week)

Returns list, common fields:

• rank, project_id, project_name, token_symbol, one_liner, tags, X, rootdataurl

rd_job_changes(recent_joinees=True, recent_resignations=True, language='en')

Get recent personnel moves.

Endpoint: POST /open/skill/job_changes

Body:

• recent_joinees: bool
• recent_resignations: bool

Returns dict with:

• recent_joinees (max 20)
• recent_resignations (max 20)

Language Header

Pass language header:

• en (default)
• cn

Error Handling

HTTP codes:

• 200 success
• 400 bad params
• 401 invalid key
• 404 not found
• 429 rate limit
• 500 internal error

Rate limit:

• 200 requests / minute / key
• on 429, use Retry-After header before retry

Usage Notes

• Keep a cached ROOTDATA_SKILL_KEY to avoid frequent init calls.
• For research tasks, preferred flow:
  1. rd_search → find entity ID
  2. rd_project_detail / rd_funding_rounds for deeper analysis
• Funding rounds endpoint is recent-window only (365 days), mention this explicitly in outputs.