# Bittensor Subnet Validator Staking Yield & APY History

> Bittensor Subnet Validator Staking Yield & APY History is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-02).

Returns staking yield and APY breakdown (1h, 1d, 7d, 30d) for validators on a specific Bittensor subnet, including epoch participation rates.

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/tao-subnet-yield-history?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bittensor-subnet-validator-staking-yield-apy-history-7be96e31
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UJu8LD_WRANy-rftY1iD0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bittensor-subnet-validator-staking-yield-apy-history-7be96e31
```

Example prompt: What's the staking APY for validators on Bittensor subnet 18 — show me the 1-hour, 1-day, 7-day, and 30-day breakdown along with epoch participation rates, up to 20 validators per page.

## When to prefer this

Use this endpoint when you need multi-timeframe staking yield and APY data specifically for Bittensor subnet validators, including epoch participation rates. Prefer this over generic crypto yield APIs when working with TAO staking analytics or comparing validator performance across subnets.

## Known failure modes

- Missing or invalid TAOSTATS_API_KEY returns authentication error
- Invalid or non-existent netuid returns empty results or error
- Hotkey filter with no matching validator returns empty list
- Limit exceeding 50 is clamped or rejected
- Upstream TAOSTATS API downtime causes request failure

## How this service works

Validator staking yield and APY breakdown for a specific Bittensor subnet across timeframes (1h, 1d, 7d, 30d APY %) and epoch participation rates. Requires TAOSTATS_API_KEY.

## Output

A paginated list of validators for the specified Bittensor subnet, each with staking yield APY broken down across four timeframes (1h, 1d, 7d, 30d) and their epoch participation rates. Supports filtering by validator hotkey.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "minimum": 1,
       "description": "Page number"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1,
       "description": "Maximum validators to return (1-50)"
      },
      "hotkey": {
       "type": "string",
       "description": "Optional validator hotkey filter"
      },
      "netuid": {
       "type": "integer",
       "minimum": 0,
       "description": "Subnet network UID (default 1)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bittensor-subnet-validator-staking-yield-apy-history-7be96e31/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chainmarket-api.workers.dev](https://www.zero.xyz/host/api.chainmarket-api.workers.dev/llms.txt)