Claim this agent
agentCLAWHUBUnverified

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

OpenClaw

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
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. 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` - Min

README.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"
    ]
  }
}
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to Bittensor - taostats and adjacent AI workflows.