Taostats API Reference

New here?

Start with the API Quickstart — authentication, base URL, and your first request in one page.

156 endpoints across 32 groups, auto-generated from the live OpenAPI spec. Pick a category to see the endpoints, or use the sidebar to jump straight to a group.

Accounts & balances

Account — 2 endpoints

• Get Account History
• Get Account

Stake balance — 5 endpoints

• Get Stake Balance Sum in Tao
• Get dTao Historical Stake Balance
• Get dTao Stake Balance
• Coldkey stake portfolio with cost basis and P&L
• Get Historical Stake

Delegation — 3 endpoints

• Get Staking/Delegation Events
• Get Slippage
• List dTao trades (swap events)

Hotkeys — 2 endpoints

• Get Parent/Child Hotkey History
• Get Parent/Child hotkey relationships

Identity — 2 endpoints

• Get Api Identity History V1
• Get On Chain Identity

Subnets & metagraph

Subnet — 22 endpoints

• Get Historical Subnet Pools
• Get Current Subnet Pools
• Get Historical Sum of Subnet Prices
• Get Current Sum of Subnet Prices
• Get Subnet Emission
• Net TAO flow per subnet
• Get Subnet Coldkey Distribution
• Get Subnet Miner Incentive Distribution
• Get Subnet Axon IP Distribution
• Get Subnet History
• Get Api Subnet Identity Set V1
• Get Subnet Identity
• Get Subnets
• Get Api Subnet Metadata V1
• Get Neuron Deregistrations
• Get Neuron Registrations
• Get Subnet Owner
• Get Api Subnet Pruning History V1
• Get Api Subnet Pruning Latest V1
• Get Subnet Registration Cost History
• Get Subnet Registration Cost
• Get Subnet Registrations

Metagraph — 4 endpoints

• Get Metagraph History
• Get Metagraph
• Get Root Subnet History
• Get Root Subnet Metagraph

Neuron — 5 endpoints

• Aggregated neuron stats history (per subnet)
• Latest aggregated neuron stats (per subnet)
• Neuron history
• Neuron incentive distribution
• Latest neuron state

Validators & miners

Validators — 27 endpoints

• Historical coldkey alpha shares per hotkey/subnet
• Latest coldkey alpha shares per hotkey/subnet
• Aggregated delegation volume
• Historical hotkey alpha shares per subnet
• Latest hotkey alpha shares per subnet
• Historical hotkey emissions per subnet
• Get Validators in a Subnet
• Historical validator dividends per subnet
• Latest validator dividends per subnet
• Get Validator History (dTao)
• Get Validator (dTao)
• Get Validator Performance History (dTao)
• Get Validator Performance (dTao)
• Historical validator APY snapshots
• Get Validator Yield
• Get Validator History
• Get Api Validator Identity V1
• Get Validator
• Get Validator Metrics History
• Get Validator Metrics
• Get Validator Performance
• Get Weight Copiers
• Get Validator Weights History v1
• Get Historical Validator Weights v2
• Get Current Validator Weights v1
• Get Current Validator Weights V2
• Batch lookup: latest validator APY for many positions

Miners — 4 endpoints

• Miner autostake events
• Miner coldkey summary
• Get Miner Weights History
• Get Latest Miner Weight

Blocks, chain & runtime

Blocks — 3 endpoints

• Get Api Block Emission V1
• Get Block Number over Interval
• Get Blocks

Chain (calls, extrinsics, events) — 6 endpoints

• Get Chain Calls
• Get Event
• Get Extrinsics
• Get Proxy Calls
• Get Historical Runtime Version
• Get Runtime Version

Network parameter — 1 endpoint

• Get Api Network Parameter Latest V1

Pending coldkey swap — 1 endpoint

• Get Api Pending Coldkey Swap V1

Live RPC & substrate

RPC / substrate (live) — 16 endpoints

• Live: Get Free Tao Balance
• Live: Get Extrinsics for Block Range
• Live: Get Latest Block Extrinsics
• Live: Get Extrinsics for Specific Block
• Live: Get Extrinsic
• Live: Get Raw Extrinsics for Specific Block
• Live: Get Node Transaction Pool
• Live: Get Node Version
• Live: Get Pallet Consts
• Live: Get Pallet Consts by Id
• Live: Get Pallet Events
• Live: Get Pallet Events by Id
• Live: List Pallet Storage Items
• Live: Get Pallet Storage Item
• Get Api V1 Rpc Ws Target
• Post Api V1 Rpc Http

Seal blob — 1 endpoint

• Post Api Seal Blob V1

Tokenomics & emission

Burn — 2 endpoints

• Cumulative burned alpha per subnet
• List alpha-burn events

Stats — 2 endpoints

• Get Stats History
• Get Stats Latest

Price — 4 endpoints

• Get Price History
• Get Price
• Get Price OHLC
• Get Api Price Simple Latest V1

TradingView — 3 endpoints

• TradingView UDF config
• Trading View History
• TradingView UDF symbol info

CoinGecko — 4 endpoints

• Get Coingecko Asset
• Get Coingecko events
• Get Coingecko latest block
• Get Coingecko Pair

Exchanges — 1 endpoint

• Get Exchanges

Trades, transfers & OTC

Transfers — 1 endpoint

• Get Transfers

OTC — 12 endpoints

• OTC listing event history
• List OTC alpha listings
• OTC lockup claims
• OTC lockup listing event history
• List OTC lockup listings
• OTC lockup purchases
• Per-user OTC lockup statistics
• OTC offer event history
• List OTC alpha offers
• OTC subnet freeze status
• Executed OTC trades
• Per-user OTC statistics

Conviction — 2 endpoints

• Get Api Conviction History V1
• Get Api Conviction Latest V1

Root claim — 1 endpoint

• Get Api Root Claim V1

Accounting & tax

Accounting / tax — 6 endpoints

• Get Coldkey Report as CSV
• Get Coldkey Report
• Get Api Accounting Tax Csv V1
• Get Api Accounting Tax Token V1
• Get Api Accounting Tax V1
• Accounting

EVM & smart contracts

EVM — 8 endpoints

• Get EVM Address
• Get EVM Block
• Get EVM Contract
• List ERC-20 token holders
• List ERC-20 tokens
• List ERC-20 transfers
• Get EVM Log
• Get EVM Transaction

Contract events — 2 endpoints

• Get Api Contract Event Id V1
• Get Api Contract Event V1

Dev insights

Dev activity — 2 endpoints

• Get Api Dev Activity History V1
• Get Api Dev Activity Latest V1

Dev changelog — 1 endpoint

• Get Api Dev Changelog V1

Meta

Status — 1 endpoint

• Get API Status

Looking for something specific

OpenAPI JSON Canonical machine-readable spec (auto-generated).

Getting started with the Taostats API Authentication, rate limits, and your first request.

Get an API key Free tier available at taostats.io/pro.

Sample apps TypeScript examples for every endpoint.