rootdata

What this skill does

# 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:

```bash
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.