Using the API
API changelog
Every change to /api/v2 that you code against, newest first: new and changed fields, deprecations with their sunset dates, and route changes.
How changes are announced
- One entry per change you code against: a version bump, an additive or breaking change to a response, a route change, or a deprecation. Correcting a wrong value is not an entry.
- Each entry has a kind: additive, breaking, deprecation or route. Breaking means code written for the previous version would read the new one differently without being changed.
- An entry's date is the day its notice period starts.
- Entries contain no addresses, keys or per-account data.
- Additive changes can ship at any time, including a new value in an open list of values. A renamed field, a change of meaning, a removal or a narrower type ships next to the old field: the old one stays, marked deprecated with its sunset date, for at least 90 days from its entry here. An endpoint is removed only after at least 6 months' notice here. Operations and response fields marked
x-stability: betacan change incompatibly with one release's notice: the entry for release N announces the change, which ships in N+1 or later.
A response's meta.data_version names its family and the version it serves, such as account/19. How deprecations show up in the spec and in response headers is under Versioning.
Baseline
Baseline: API 1.164.0
What changes: nothing. This is the starting point the rules above apply from: the public /api/v2 surface as served by API 1.164.0, 204 documented operations. An operation documented later is listed in its own entry the day it is announced. Each response's
meta.data_versionnames its family and version; the table below lists the version each family serves and its routes. Later entries record changes against it.Errors: every error is
application/problem+json: a Problem object withtype,title,status,detail,code,request_id,errors(more members per code, as the served document states).codeis an open vocabulary: the served document'sx-error-cataloguelists each code with its status, meaning and whether a retry can succeed (239 codes at 1.164.0); new codes may be added, so show an unknown one withdetail.Deprecated members (50): served now, marked deprecated in the served document with sunset 2027-02-15, and removed no earlier than that. Use the replacement named:
Show the list
AccountColdkeySwapAnnouncement.announced_at_block: useexecutable_at_block(account)AccountIncomePosition.locked_alpha_rao: useAccountDetail.subnet_locks(account)AccountIncomePosition.locked_alpha_rao: useAccountPositionsMeta.subnet_locks(account_positions)AccountPosition.locked_alpha_rao: useAccount.subnet_locks(accounts)AccountPosition.locked_alpha_rao: useAccountPositionsItem.subnet_locks(accounts_positions)BasketsValidatorMeta.missing_reason: usevalidator_unavailable_reason(baskets)Candle.carried: useis_carried(subnet_candles, subnets)EvmAddressApprovalsMeta.fold_height: usecomputed_through_height(evm_token_allowances)EvmAddressNftsMeta.fold_height: usecomputed_through_height(evm_nfts)EvmAddressTokenBalance.price_null_reason: useprice_unavailable_reason(evm_token_balances)EvmAddressTokenBalance.value_null_reason: usevalue_unavailable_reason(evm_token_balances)EvmAddressTokenTransfersMeta.fold_height: usecomputed_through_height(evm_token_transfers)EvmAddressTokensMeta.fold_height: usecomputed_through_height(evm_token_balances)EvmTaoCoverage.stage: usedataset(evm_tao_daily, evm_tao_holders)EvmTaoDailyMeta.days_not_built: usedays_unavailable(evm_tao_daily)EvmTokenDetail.folded_supply_raw: usecomputed_supply_raw(evm_tokens)EvmTokenDetail.price_null_reason: useprice_unavailable_reason(evm_tokens)EvmTokenDetailMeta.fold_height: usecomputed_through_height(evm_tokens)EvmTokenHeader.folded_supply_raw: usecomputed_supply_raw(evm_nfts, evm_token_holders, evm_token_transfers)EvmTokenHolder.share_of_supply_null_reason: useshare_of_supply_unavailable_reason(evm_token_holders)EvmTokenHoldersMeta.fold_height: usecomputed_through_height(evm_token_holders)EvmTokenListItem.folded_supply_raw: usecomputed_supply_raw(evm_tokens)EvmTokenListItem.price_null_reason: useprice_unavailable_reason(evm_tokens)EvmTokenNftsMeta.fold_height: usecomputed_through_height(evm_nfts)EvmTokenTransfersMeta.fold_height: usecomputed_through_height(evm_token_transfers)EvmTokensCoverage.stage: usedataset(evm_nfts, evm_token_allowances, evm_token_balances, evm_token_holders, evm_token_transfers, evm_tokens)EvmTokensListMeta.fold_height: usecomputed_through_height(evm_tokens)HotkeyEmission30d.days_built: usedays_available(account, hotkey, validators)HotkeyEmission30d.other_spot_tao_rao: useowner_cut_spot_tao_rao(account, hotkey, validators)LifeSummaryData.page: useprofile(subnet_life_summary)PortfolioRootAccrualEra.built: useavailable(portfolio_series)PortfolioSeriesDay.total_ex_basket_spot_tao_rao: usetotal_spot_tao_rao(portfolio_series)RegistrationActivityRow.cost_pct_reason: usecost_percentiles_unavailable_reason(registration_analytics)RegistrationCostRow.cost_pct_reason: usecost_percentiles_unavailable_reason(registration_analytics)RegistrationTenureRow.tenure_pct_reason: usetenure_percentiles_unavailable_reason(registration_analytics)SearchMeta.index_built_at: useindex_updated_at(search)StatusReadDelay.replica_replay_time: usedata_as_of(coverage)Subnet.owner_buyback_30d_alpha_rao: useowner_pool_buys_30d_alpha_rao(subnets)Subnet.owner_buyback_30d_tao_rao: useowner_pool_buys_30d_tao_rao(subnets)Subnet.owner_buyback_lifetime_alpha_rao: useowner_pool_buys_lifetime_alpha_rao(subnets)Subnet.owner_buyback_lifetime_from_height: useowner_pool_buys_lifetime_from_height(subnets)Subnet.owner_buyback_lifetime_tao_rao: useowner_pool_buys_lifetime_tao_rao(subnets)Subnet.owner_buyback_share_of_owner_cut_30d_ratio: useowner_pool_buys_share_of_owner_cut_30d_ratio(subnets)Subnet.page: useprofile(subnets)SubnetNetEmissionWindow.days_built: usedays_available(subnet_life_summary, subnet_net_emission, subnets)SubnetPage.owner_buyback_30d_alpha_rao: useowner_pool_buys_30d_alpha_rao(subnets)SubnetPage.owner_buyback_30d_tao_rao: useowner_pool_buys_30d_tao_rao(subnets)SubnetPage.owner_buyback_lifetime_alpha_rao: useowner_pool_buys_lifetime_alpha_rao(subnets)SubnetPage.owner_buyback_lifetime_from_height: useowner_pool_buys_lifetime_from_height(subnets)SubnetPage.owner_buyback_lifetime_tao_rao: useowner_pool_buys_lifetime_tao_rao(subnets)SubnetPage.owner_buyback_share_of_owner_cut_30d_ratio: useowner_pool_buys_share_of_owner_cut_30d_ratio(subnets)SubnetPage.page: useprofile(subnets)
Routes with no data_version (4): integration feeds in a third party's format; the route promise covers them like any other:
- GET
/integrations/coingecko/asset(beta) - GET
/integrations/coingecko/events(beta) - GET
/integrations/coingecko/latest-block(beta) - GET
/integrations/coingecko/pair(beta)
- GET
Stability: each operation's
x-stabilityin the served document says which notice in rule 5 applies: 70 operations arestableand 134beta, and response members are markedx-stability: betathere too. The table's Stability column gives each family's value, and marks each route where a family's routes differ.
Families, their data_version and routes (162)
accountaccount/19stable
account_activityaccount_activity/15beta
account_activity_countsaccount_activity_counts/1beta
account_basketsaccount_baskets/3beta
account_claim_previewaccount_claim_preview/3beta
account_dailyaccount_daily/1beta
account_historyaccount_history/5stable
account_owner_buybacksaccount_owner_buybacks/2beta
account_position_seriesaccount_position_series/3beta
account_positionsaccount_positions/7stable
account_seriesaccount_series/22beta
accountsaccounts/9stable
- GET
/accounts - POST
/accounts/batch
- GET
accounts_activityaccounts_activity/7beta
accounts_positionsaccounts_positions/5stable
address_labelsaddress_labels/1beta
address_name_checkaddress_name_check/1beta
basketbasket/17beta
basket_holdersbasket_holders/1beta
basket_owed_dailybasket_owed_daily/1beta
basket_targetbasket_target/1beta
basketsbaskets/18beta
- GET
/baskets
- GET
blockblock/7stable
block_callsblock_calls/3stable
block_eventsblock_events/2stable
block_extrinsicsblock_extrinsics/6stable
blocksblocks/2stable
- GET
/blocks
- GET
callcall/4stable
- GET
/calls/{id}
- GET
call_namescall_names/1beta
- GET
/calls/names
- GET
callscalls/4stable
- GET
/calls
- GET
claim_previewclaim_preview/1beta
coldkey_swaps_pendingcoldkey_swaps_pending/1beta
compiler_versionscompiler_versions/1stable
container_image_tagscontainer_image_tags/1beta
contract_verificationcontract_verification/1beta
cost_basiscost_basis/3beta
coveragecoverage/2beta
- GET
/status
- GET
entityentity/2stable
entity_membersentity_members/2stable
entity_searchentity_search/1stable
escrow_attributionescrow_attribution/1beta
eventevent/2stable
- GET
/events/{id}
- GET
eventsevents/3mixed
- GET
/baskets/{hotkey}/events(beta) - GET
/events(stable) - GET
/hotkeys/{hotkey}/take-changes(stable)
- GET
evm_addressevm_address/1beta
evm_blockevm_block/3stable
evm_blocksevm_blocks/2stable
- GET
/evm/blocks
- GET
evm_contractevm_contract/2stable
evm_contract_abievm_contract_abi/1stable
evm_contract_sourceevm_contract_source/1stable
evm_contractsevm_contracts/3stable
evm_logevm_log/1stable
evm_logsevm_logs/1stable
- GET
/evm/logs
- GET
evm_nftsevm_nfts/1beta
evm_precompileevm_precompile/3stable
evm_precompilesevm_precompiles/3stable
evm_tao_dailyevm_tao_daily/1beta
evm_tao_holdersevm_tao_holders/1beta
evm_token_allowancesevm_token_allowances/1beta
evm_token_balancesevm_token_balances/1beta
evm_token_holdersevm_token_holders/1beta
evm_token_transfersevm_token_transfers/1beta
evm_tokensevm_tokens/1beta
evm_transactionevm_transaction/3stable
evm_transactionsevm_transactions/2stable
extrinsicextrinsic/8stable
extrinsic_callsextrinsic_calls/3stable
extrinsic_eventsextrinsic_events/2stable
extrinsic_writesextrinsic_writes/2stable
extrinsicsextrinsics/7stable
- GET
/extrinsics
- GET
forexforex/5stable
fund_nav_seriesfund_nav_series/3beta
fund_performancefund_performance/3beta
generationsgenerations/3stable
hotkeyhotkey/11beta
- GET
/hotkeys - POST
/hotkeys/batch - GET
/hotkeys/{hotkey}
- GET
hotkey_commitmentshotkey_commitments/1beta
hotkey_emissionshotkey_emissions/2beta
hotkey_familyhotkey_family/1beta
hotkey_performancehotkey_performance/3beta
hotkey_staker_summaryhotkey_staker_summary/1beta
hotkey_stakershotkey_stakers/4beta
hotkey_weights_latesthotkey_weights_latest/1beta
identitiesidentities/2stable
identity_historyidentity_history/4stable
identity_searchidentity_search/1stable
key_swapskey_swaps/1beta
- GET
/key-swaps - POST
/key-swaps/batch
- GET
labellabel/1stable
labelslabels/1stable
- GET
/labels - POST
/labels/batch
- GET
leaderboardleaderboard/4beta
- GET
/leaderboard
- GET
link_verdictslink_verdicts/1beta
- POST
/links/verdicts
- POST
metadata_digestmetadata_digest/1beta
multisigmultisig/1beta
multisig_operationmultisig_operation/1beta
multisig_operationsmultisig_operations/1beta
network_activitynetwork_activity/2beta
network_announcementsnetwork_announcements/1beta
network_eventsnetwork_events/1beta
network_moversnetwork_movers/1beta
network_parametersnetwork_parameters/2beta
network_seriesnetwork_series/1beta
portfolio_seriesportfolio_series/29beta
position_historyposition_history/4stable
registration_analyticsregistration_analytics/1beta
repo_advisoriesrepo_advisories/1beta
repo_imagesrepo_images/1beta
repo_setup_runsrepo_setup_runs/1beta
repo_star_historyrepo_star_history/1beta
richlistrichlist/1beta
root_accrual_networkroot_accrual_network/1beta
runtimeruntime/2stable
runtime_apisruntime_apis/2stable
runtime_coderuntime_code/1beta
runtime_diffruntime_diff/1stable
runtime_metadataruntime_metadata/1stable
runtime_palletruntime_pallet/1stable
runtime_palletsruntime_pallets/1stable
runtimesruntimes/2stable
- GET
/runtimes
- GET
searchsearch/3beta
- GET
/search - GET
/search/quick
- GET
stake_historystake_distribution_network_v1+stake_rotation_v1beta
stake_quotestake_quote/2beta
stake_yieldsstake_yields/1beta
staking_optionsstaking_options/1beta
storage_historystorage_history/1beta
storage_keysstorage_keys/1beta
storage_valuestorage_value/1beta
subnet_advisoriessubnet_advisories/1beta
subnet_candlessubnet_candles/12stable
subnet_changessubnet_changes/1beta
subnet_changes_recentsubnet_changes_recent/1beta
subnet_commitment_summarysubnet_commitment_summary/1beta
subnet_commitmentssubnet_commitments/1beta
subnet_daily_historysubnet_daily_history/3beta
subnet_dominancesubnet_dominance_meta_v1+subnet_dominance_v1beta
subnet_emission_sharesubnet_emission_share/3beta
subnet_emissionssubnet_emissions/2beta
subnet_fundssubnet_funds/1beta
subnet_holders_dailysubnet_holders_daily/3beta
subnet_hyperparam_changessubnet_hyperparam_changes/3stable
subnet_life_summarysubnet_life_summary/1beta
subnet_linkssubnet_links/1beta
subnet_markssubnet_marks/3stable
subnet_metagraphsubnet_metagraph/8stable
subnet_net_emissionsubnet_net_emission/4beta
subnet_owner_transferssubnet_owner_transfers/2beta
subnet_price_attributionsubnet_price_attribution/1beta
subnet_registrationssubnet_registrations/3beta
subnet_reposubnet_repo/1beta
subnet_revenuesubnet_revenue/3beta
subnet_stake_flows_dailysubnet_stake_flows_daily/3beta
subnet_validatorssubnet_validators/7beta
subnet_web_presencesubnet_web_presence/1beta
subnet_web_presence_historysubnet_web_presence_history/1beta
subnetssubnets/28mixed
- GET
/subnets(stable) - GET
/subnets/names(stable) - GET
/subnets/{netuid}(stable) - GET
/subnets/{netuid}/epoch(beta)
- GET
swap_quoteswap_quote/1beta
tao_candlestao_candles/7stable
tao_markettao_market/6stable
- GET
/markets/tao
- GET
tradestrades/7stable
transferstransfers/4stable
- GET
/transfers
- GET
validator_setupvalidator_setup/1beta
validator_trendvalidator_trend_meta_v1+validator_trend_v1beta
validatorsvalidators/5beta
- GET
/validators
- GET
verified_contractsverified_contracts/1stable
verified_linksverified_links/1beta
weight_submissionsweight_submissions/1beta
The changelog of record, export v0.2.67.