rootdata-crypto-plugin

Pre-flight Dependencies (auto-injected by Plugin Store CI)

Run once per session before first use. These checks ensure required tools are installed.

Version check (auto-injected)

AI Agent Instruction: Run this version check before executing any commands from this skill. The check is a read-only fetch from raw.githubusercontent.com — it does not install anything. If it reports Update available, you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested npx skills add … command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding.

# Check for skill updates (1-hour cache).
# Network scope: this block calls raw.githubusercontent.com for the version probe only.
# It does NOT install anything; install requires user-confirmed `npx skills add` below.
UPDATE_CACHE="$HOME/.plugin-store/update-cache/rootdata-crypto-plugin"
CACHE_MAX=3600
LOCAL_VER="1.0.0"
DO_CHECK=true

if [ -f "$UPDATE_CACHE" ]; then CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0) NOW=$(date +%s) AGE=$(( NOW - CACHE_MOD )) [ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false fi

if [ "$DO_CHECK" = true ]; then REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/rootdata-crypto-plugin/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}') if [ -n "$REMOTE_VER" ]; then mkdir -p "$HOME/.plugin-store/update-cache" echo "$REMOTE_VER" > "$UPDATE_CACHE" fi fi

REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER") if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then echo "Update available: rootdata-crypto-plugin v$LOCAL_VER -> v$REMOTE_VER." echo "ACTION REQUIRED: ask the user to confirm before running:" echo " npx skills add okx/plugin-store --skill rootdata-crypto-plugin --global" echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)" fi


---


# RootData Crypto Intelligence (OKX Edition)

## Overview

RootData is a leading Web3 data platform covering crypto projects, investors, funding data, and personnel movements. This skill is the OKX-dedicated integration, isolated from the standard RootData skill with its own API key namespace and endpoints.

## Pre-flight Checks

Before using this skill, ensure:

1. Check if the environment variable `OKX_ROOTDATA_SKILL_KEY` exists.
2. If it does **NOT** exist, call the `/init` command below to generate a key and save it.
3. All subsequent requests must include `Authorization: Bearer {OKX_ROOTDATA_SKILL_KEY}` and `Content-Type: application/json`.

### Initialize API Key

`POST https://api.rootdata.com/open/okx/skill/init`

**When to use**: First-time setup, or when `OKX_ROOTDATA_SKILL_KEY` is missing or invalid.
**Output**: Returns `api_key` (prefixed with `okxsk_`). Save it as `OKX_ROOTDATA_SKILL_KEY`.
**Example**:

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


Response:
```json
{
  "result": 200,
  "data": {
    "api_key": "okxsk_xxxxxxxxxxxxxxxx"
  }
}

After saving, confirm to user: "RootData (OKX) access is ready. You can now query crypto data."

Commands

All requests must include:

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

Search

POST https://api.rootdata.com/open/okx/skill/ser_inv

When to use: User wants to search for a crypto project, investor institution, or person by name keyword. Use this as the first step when an entity ID is not yet known. Output: A list of matching entities with their IDs, types, names, and descriptions. Example:

{
  "query": "Uniswap",
  "precise_x_search": false
}

Key response fields:

id - entity ID (use for follow-up queries)
type - 1=Project, 2=VC/Institution, 3=Person
name - display name
one_liner - brief description
introduce - full description
rootdataurl - link to full detail page on RootData

Get All IDs by Type

POST https://api.rootdata.com/open/okx/skill/id_map

When to use: User asks for a complete list of all project IDs, institution IDs, or person IDs for bulk lookup or enumeration. Output: Array of { id, name } entries for all entities of the specified type. Example:

{
  "type": 1
}

type values: 1=Project, 2=VC/Institution, 3=Person

Key response fields:

id - entity ID
name - entity name

Project Detail

POST https://api.rootdata.com/open/okx/skill/get_item

When to use: User asks for detailed information about a specific crypto project, including its description, funding total, investors, tags, and social links. Output: Full project profile including funding summary, contracts, social media, and investor list. Example (by project ID):

{
  "project_id": 12345,
  "include_investors": true
}

Or by contract address:

{
  "contract_address": "0xabc123...",
  "include_investors": true
}

Key response fields:

project_id, project_name, logo, token_symbol
one_liner, description
active - whether the project is still active
establishment_date - founding date
tags - category tags (e.g. DeFi, Layer2, NFT)
contracts - on-chain contract addresses
total_funding - total funding raised (USD)
social_media - website, X(Twitter), GitHub, CoinMarketCap, CoinGecko, etc.
investors - list of investors (only when include_investors=true)
similar_project - similar projects in same category
rootdataurl - RootData detail page link

Funding Rounds

POST https://api.rootdata.com/open/okx/skill/get_fac

When to use: User asks about funding history, investment rounds, "how much did XX raise", "who invested in XX", or requests a list of recent fundraises.

Data range: Covers funding rounds from the past 365 days only. Requests for older data will automatically return only the most recent 365 days.

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

Output: Paginated list of funding rounds with project info and investor details. Example:

{
  "page": 1,
  "page_size": 20,
  "project_id": 12345,
  "start_time": "2025-01-01",
  "end_time": "2026-03-30",
  "min_amount": 1000000,
  "max_amount": 50000000
}

All fields except page and page_size are optional. Omit any field not specified by the user.

Key response fields:

total - total matching records
items - list of funding rounds, each containing:
- name - project name
- logo - project logo
- rounds - round type (Seed / Series A / Series B / etc.)
- published_time - announcement date
- amount - funding amount (USD)
- project_id - project ID
- data_status - data verification status
- source_url - original news source link
- X - project's X (Twitter) URL
- one_liner - project brief description
- invests - up to 3 investors, each with:
  - name, logo
  - lead_investor - 1=lead investor, 0=participating
  - type - 1=Project, 2=VC/Institution, 3=Person
  - invest_id - investor ID
  - rootdataurl - investor detail page

Trending Projects

POST https://api.rootdata.com/open/okx/skill/hot_index

When to use: User asks "what's hot in crypto today", "trending projects", "top projects this week", or similar trending/popularity queries. Output: Ranked list of trending projects for the requested time window. Example:

{
  "days": 1
}

days values: 1=today's trending, 7=this week's trending

Key response fields:

rank - ranking position
project_id, project_name, logo, token_symbol
one_liner - brief description
tags - category tags
X - Twitter/X profile URL
rootdataurl - RootData detail page link

Personnel Job Changes

POST https://api.rootdata.com/open/okx/skill/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.

Output: Two arrays - recent hires and recent departures - each with up to 20 entries. Example:

{
  "recent_joinees": true,
  "recent_resignations": true
}

Parameters:

recent_joinees - true to get recent hires/joiners
recent_resignations - true to get recent departures
Both can be true simultaneously
If both are false or omitted, returns empty data

Key response fields:

recent_joinees - array of recent hires (max 20), each containing:
- people_id - person ID
- people_name - person's name
- head_img - profile photo
- company_type - 1=Project, 2=VC/Institution, 3=Person
- company_id - company/project ID
- company - company/project name
- position - job title
recent_resignations - array of recent departures (max 20), same structure

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.

Error Handling

Error	Cause	Resolution
`401 Unauthorized`	Missing or invalid `OKX_ROOTDATA_SKILL_KEY`	Re-run `/init` to generate a new key and update the env variable
`429 Too Many Requests`	Rate limit exceeded (200 req/min)	Wait for the number of seconds in the `Retry-After` response header, then retry
`400 Bad Request`	Invalid or missing required parameters	Check request body; verify `type`, `days`, or `page` values are correct
`404 Not Found`	Entity ID does not exist	Confirm the ID via `/ser_inv` search before calling detail endpoints
`500 Internal Server Error`	Upstream server error	Retry after a short delay; if persistent, report to RootData support
`result` field != `200`	Application-level error	Read the `message` field in the response for details

If you receive HTTP 429, check the Retry-After header and wait before retrying. Monitor X-RateLimit-Remaining to track remaining quota.

Security Notices

This skill is read-only and does not perform any write, trade, or transaction operations.
The okxsk_ prefixed API key is an anonymous, low-privilege key used solely to call RootData's public data endpoints. It has no access to any personal account or wallet data.
The key is stored as a local environment variable (OKX_ROOTDATA_SKILL_KEY) and is never sent to any service other than api.rootdata.com.
You can revoke the key at any time by contacting RootData support.
Rate limit: 200 requests per minute per API key.

Version History

v1.0.0 (2026-04-27)

Initial OKX edition release
Isolated endpoint namespace: /open/okx/skill/
Isolated API key namespace: okxsk_ prefix, env var OKX_ROOTDATA_SKILL_KEY
6 skills: Search, ID Map, Project Detail, Funding Rounds, Trending Projects, Personnel Job Changes
Funding data limited to past 365 days; max 3 investors per round
Job changes: max 20 entries per category

About this skill

Pre-flight Dependencies (auto-injected by Plugin Store CI)

Version check (auto-injected)

Commands

Search

Get All IDs by Type

Project Detail

Funding Rounds

Trending Projects

Personnel Job Changes

Multi-Language Support

Error Handling

Security Notices

Version History

v1.0.0 (2026-04-27)