# Subtensor Chain Events API

> Subtensor Chain Events API is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-02).

Fetches recent Subtensor (Bittensor) blockchain events, filterable by pallet, event name, block range, and pagination.

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/subtensor-events?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/subtensor-chain-events-api-b00eaf51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8zDpPilzoHyAdTvknYRxk

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 subtensor-chain-events-api-b00eaf51
```

Example prompt: Can you pull the most recent Transfer events from the Balances pallet on the Subtensor chain — give me up to 100 per page, starting at page 1?

## When to prefer this

Use this endpoint when you need structured, filterable on-chain event data from the Bittensor/Subtensor blockchain, especially when you want to monitor specific pallets (SubtensorModule, Balances, System) or event types (Transfer, ExtrinsicSuccess) with pagination support. Prefer this over raw block explorers when you need programmatic access to event streams.

## Known failure modes

- Missing or invalid TAOSTATS_API_KEY returns 401 Unauthorized
- Invalid pallet name returns empty result set or 400 error
- Page number out of range returns empty results
- limit exceeding 100 is rejected with validation error
- Subtensor node or TaoStats API downtime causes 502/503 errors

## How this service works

Recent Subtensor chain events, optionally filtered by pallet, event name, block range, or pagination. Requires TAOSTATS_API_KEY.

## Output

Returns a paginated list of recent Subtensor chain events, each including the pallet name, event name, block number, and associated event data/metadata, filtered by any specified pallet, event name, or block range.

## 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",
     "properties": {
      "name": {
       "type": "string",
       "description": "Event name (e.g. ExtrinsicSuccess, Transfer)"
      },
      "page": {
       "type": "integer",
       "default": 1,
       "minimum": 1,
       "description": "Page number"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum events to return"
      },
      "pallet": {
       "type": "string",
       "description": "Substrate pallet name (e.g. SubtensorModule, System, Balances)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/subtensor-chain-events-api-b00eaf51/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)