Are you a TypeScript developer using our APIs? Our SDK might slimplify things!

Our Typescript SDK is now available. It offers full access to the Taostats API, but also full customized RPC access to the Bittensor chain.

IN addition to making calls to Taostats, you can do any transaction on the chain using the RPC nodes.

The Taostats TypeScript SDK is available on GitHub. The latest installation instructions can be found there.

Requirements: Node.js v 22.3.0 or higher

npm install @taostats/sdk
# or
yarn add @taostats/sdk
# or
pnpm add @taostats/sdk

Setup

the .env has three variables:

TAOSTATS_API_KEY='your-taostats-api-key'

# Only needed to interact with certain blockchain modules(stake, unstake, transfer, move) 
TAO_ACCOUNT_SEED="your twelve word seed phrase"
# OR
TAO_ACCOUNT_PRIVATE_KEY="your_private_key_in_hex"

RPC_URL="wss://your_custom_url" #Optional

• TAOSTATS_API_KEY: Your API key. Required to make API calls with Taostats
• TAO_ACCOUNT_SEED: Your 12 word wallet phrase. Used for RPC calls on chain. BE CAREFUL! The .gitignore is properly set, but if your server is compromised, you may loose access to your wallet.
• TAO_ACCOUNT_PRIVATE_KEY: A hex encoded version of your private key. Used for RPC calls on chain. BE CAREFUL! The .gitignore is properly set, but if your server is compromised, you may loose access to your wallet.
• RPC_URL: Change to run your code in testnet, or in a private node.

Usage

API Modules

The modules below mirror the Taostats API surface. New endpoints are added over time — for the complete, current set see the API Reference or the SDK's own type definitions.

Parameters are all identical to those in the API

• client.taoPrices - TAO price and market data endpoints
  • getTaoPrice
  • getTaoPriceHistory
  • getTaoPriceOHLC
• client.tradingView - TradingView UDF history data for subnets
  • getTradingViewHistory
• client.delegations - Delegation/staking data, slippage calculations, and stake balances
  • getSlippage
  • getDelegationEvents
  • getStakeBalanceSumInTao
  • getdTaoStakeBalance
  • getdTaoHistoricalStakeBalance
• client.accounts - Account information, balances, and transactions
  • getAccount
  • getAccountHistory
  • getTransfers
  • getOnChainIdentity
• client.chain - Blockchain data including blocks, extrinsics, events, and network statistics
  • getBlocks
  • getBlockNumbersByInterval
  • getExtrinsics
  • getEvents
  • getChainCalls
  • getLatestStats
  • getStatsHistory
  • getRuntimeVersion
  • getRuntimeVersionHistory
  • getProxyCalls
• client.subnets - Subnet data, registration, pricing, and comprehensive analytics
  • getSubnets
  • getHistoricalSubnetPricesSum
  • getLatestSubnetPricesSum
  • getSubnetRegistrations
  • getSubnetRegistrationCostHistory
  • getCurrentSubnetRegistrationCost
  • getSubnetOwner
  • getSubnetIdentity
  • getSubnetEmission
  • getSubnetsPoolsHistory
  • getCurrentSubnetPools
  • getSubnetHistory
• client.metagraph - Metagraph data including miner incentive distributions
  • getMinerIncentiveDistributionBySubnet
  • getSubnetAxonIpDistribution
  • getSubnetColdkeyDistribution
  • getLatestMinerWeight
  • getMinerWeightHistory
  • getNeuronDeregistrations
  • getNeuronRegistrations
  • getRootSubnetHistory
  • getRootSubnet
  • getHistory
  • getLatest
• client.live - Real-time blockchain data and live network information
  • getFreeTaoBalance
  • getLatestBlockExtrinsics
  • getExtrinsicsForBlockRange
  • getExtrinsicsForSpecificBlock
  • getRawExtrinsicsForSpecificBlock
  • getNodeTransactionPool
  • getNodeVersion
  • getPalletByConstants
  • getPalletEvents
• client.evm - EVM-related operations and data
  • getEVMTransactions
  • getEVMBlocks
  • getEVMContracts
  • getEVMLogs