Bittensor - taostats
Access Bittensor blockchain data via TaoStats API for subnets, validators, miners, staking, emissions, and market metrics. Skill: Bittensor - taostats Owner: vanlabs-dev Summary: Access Bittensor blockchain data via TaoStats API for subnets, validators, miners, staking, emissions, and market metrics. Tags: latest:1.0.2 Version history: v1.0.2 | 2026-02-11T03:52:20.687Z | user - Documentation updated. - Removed instructions to add the TAOSTATS_API_KEY export to shell profiles. - Added Python client reference: added mention of taostats_cli
Rank
62
Safety
84
Downloads
674
Updated
Apr 15, 2026
Version
1.0.2
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 674 downloads reported by the source. Last updated 4/15/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Apr 15, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Apr 15, 2026
- Adoption signal
- 674 downloadsadoption · observed Apr 15, 2026
- Latest release
- 1.0.2release · observed Feb 11, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install kn7a81sdex3gszysgg397hwvw180y8sb:bittensor-taostats- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-vanlabs-dev-bittensor-taostats/snapshot"
Documentation
CLAWHUB
39,723 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
# TaoStats Skill
**Purpose**: Interact with TaoStats API for Bittensor blockchain data - subnets, validators, miners, staking, emissions, and more.
**API Documentation**: https://docs.taostats.io/
**Base URL**: `https://api.taostats.io`
**Rate Limit**: 5 calls/minute (free tier)
---
## Setup
### 1. Set API Key
Get a free API key from [taostats.io](https://taostats.io) and export it as an environment variable:
```bash
export TAOSTATS_API_KEY="tao-xxxxx:yyyyy"
```
### 2. Source Helper Functions
```bash
source ~/.openclaw/workspace/skills/taostats/taostats.sh
```
---
## Complete Endpoint Reference
### dTAO Pool Endpoints
#### `GET /api/dtao/pool/latest/v1?netuid={N}`
**CRITICAL**: This endpoint has EVERYTHING for trading decisions.
**Key Fields**:
- `price` - Current alpha price in TAO
- `root_prop` - % of price from root TAO injection (CRITICAL for entry validation)
- `fear_and_greed_index` / `fear_and_greed_sentiment` - Market sentiment
- `seven_day_prices` - Historical price array (42 data points)
- `price_change_1_hour`, `price_change_1_day`, `price_change_1_week`, `price_change_1_month`
- `market_cap`, `liquidity`, `total_tao`, `total_alpha`
- `tao_volume_24_hr`, `alpha_volume_24_hr`, `buys_24_hr`, `sells_24_hr`
- `highest_price_24_hr`, `lowest_price_24_hr`
**Example**:
```bash
curl -s "https://api.taostats.io/api/dtao/pool/latest/v1?netuid=33" \
-H "Authorization: $TAOSTATS_API_KEY" | jq '.data[0].root_prop'
# Returns: "0.2104087259347016725" (21% - GOOD entry)
```
#### `GET /api/dtao/pool/history/v1?netuid={N}&limit={L}`
Historical pool snapshots for backtesting.
#### `GET /api/dtao/validator/yield/latest/v1?netuid={N}`
Validator APYs with multiple timeframes.
**Key Fields**:
- `seven_day_apy` - Primary metric for staking decisions
- `one_day_apy`, `one_hour_apy`, `thirty_day_apy`
- `seven_day_epoch_participation` - Validator reliability
- `name`, `hotkey.ss58`, `stake`, `take`
**Example**:
```bash
curl -s "https://api.taostats.io/api/dtao/validator/yield/latest/v1?netuid=33" \
-H "Authorization: $TAOSTATS_API_KEY" | \
jq -r '.data | sort_by(-.seven_day_apy) | .[0] |
"\(.name // .hotkey.ss58): \(.seven_day_apy * 100)% APY"'
```
#### `GET /api/dtao/stake_balance/latest/v1?coldkey={COLDKEY}`
All stake positions across all subnets.
**Key Fields**:
- `netuid`, `hotkey.ss58`, `hotkey_name`
- `balance_as_tao` - ⚠️ IN RAO (divide by 1e9)
- `price`, `price_change_1_day`
- `root_prop` - Per-position root proportion
### Subnet Endpoints
#### `GET /api/subnet/latest/v1` or `?netuid={N}`
Complete subnet parameters and economics.
**Key Fields**:
- `netuid`, `emission`, `projected_emission`
- `net_flow_1_day`, `net_flow_7_days`, `net_flow_30_days` - Capital flow tracking
- `recycled_24_hours`, `recycled_lifetime` - Registration economics
- `tao_flow`, `excess_tao` - dTAO mechanics
- `immune_owner_uids_limit`, `immunity_period` - Risk assessment
- `max_validators`, `active_validators`
- `difficulty`, `adjustment_alpha` - MinREADME.md
# TaoStats Skill - Quick Start ## Installation ```bash # Already installed at ~/.openclaw/workspace/skills/taostats/ ``` ## Setup 1. Ensure `.taostats` file exists in workspace root with your API key 2. Source the functions: `source ~/.openclaw/workspace/skills/taostats/taostats.sh` ## Most Useful Commands ### Check Portfolio ```bash taostats_stake_balance "YOUR_COLDKEY" | jq '.data[] | "SN\(.netuid): \((.balance_as_tao | tonumber) / 1e9) TAO"' ``` ### Find Best Validator ```bash taostats_top_validators 12 ``` ### Scan for High APY ```bash taostats_scan_apy 80 # Find subnets with >80% APY ``` ### Check Transaction History ```bash taostats_delegation_history "YOUR_COLDKEY" 10 ``` ### Get Total Staked ```bash taostats_total_staked "YOUR_COLDKEY" ``` ## Full Documentation See `SKILL.md` for complete function reference and examples.
_meta.json
{
"ownerId": "kn7a81sdex3gszysgg397hwvw180y8sb",
"slug": "bittensor-taostats",
"version": "1.0.2",
"publishedAt": 1770781940687
}skill.json
{
"name": "taostats",
"version": "1.1.0",
"description": "TaoStats API wrapper for Bittensor blockchain data - subnets, validators, staking, emissions. Read-only GET calls to api.taostats.io.",
"author": "vanlabs-dev",
"created": "2026-02-03",
"tags": [
"bittensor",
"taostats",
"blockchain",
"crypto",
"api"
],
"dependencies": {
"system": [
"curl",
"jq",
"bc"
],
"python": [
"requests"
],
"api": [
"TaoStats API key (free tier at taostats.io)"
]
},
"files": {
"main": "taostats.sh",
"python": [
"taostats_client.py",
"balance_history.py",
"validator_tracker.py"
],
"docs": [
"SKILL.md",
"README.md"
]
},
"credentials": {
"required": [
"TAOSTATS_API_KEY"
],
"description": "Free API key from taostats.io. Export as environment variable.",
"storage": "environment_variable"
},
"setup": {
"env_vars": [
"TAOSTATS_API_KEY"
]
},
"permissions": {
"network": [
"api.taostats.io"
],
"filesystem": "read-only",
"disableModelInvocation": true
},
"functions": [
"taostats_pool",
"taostats_validator_yield",
"taostats_stake_balance",
"taostats_delegation_history",
"taostats_pruning",
"taostats_dev_activity",
"taostats_metagraph",
"taostats_slippage",
"taostats_coldkey_balance",
"taostats_top_validators",
"taostats_total_staked",
"taostats_dereg_risk",
"taostats_scan_apy",
"taostats_tao_price",
"rao_to_tao",
"tao_to_rao",
"taostats_batch_apy"
],
"examples": [
{
"name": "Check portfolio",
"command": "taostats_total_staked YOUR_COLDKEY"
},
{
"name": "Find best validator",
"command": "taostats_top_validators 12"
},
{
"name": "Scan high APY",
"command": "taostats_scan_apy 100"
}
],
"requires": {
"env": [
"TAOSTATS_API_KEY"
]
}
}activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceUrl": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-vanlabs-dev-bittensor-taostats/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-vanlabs-dev-bittensor-taostats/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "674 downloads",
"href": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceUrl": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.2",
"href": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceUrl": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-11T03:52:20.687Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-vanlabs-dev-bittensor-taostats/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-vanlabs-dev-bittensor-taostats/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.2",
"description": "- Documentation updated. - Removed instructions to add the TAOSTATS_API_KEY export to shell profiles. - Added Python client reference: added mention of taostats_client.py and example usage. - No code or functional changes.",
"href": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceUrl": "https://clawhub.ai/vanlabs-dev/bittensor-taostats",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-11T03:52:20.687Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
