Subtensor Storage Query Examples
info
The following outline of subtensor storage query examples is provided for high-level reference and is not exhaustive. For a complete specification of all available queries, see the Subtensor API reference.
1. AccumulatedLeaseDividends
- Description: Storage for a lease ID's accumulated dividends.
- Query Type:
u16 -> unknown - Parameters:
lease_id:u32
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
lease_id = 1
result = substrate.query('SubtensorModule', 'AccumulatedLeaseDividends', [lease_id])
print(result.value)
2. Active
- Description: Storage for Active.
- Query Type:
u16 -> unknown - Parameters:
netuid:u16
- Default Value:
[] - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'Active', [netuid])
print(result.value)
3. ActivityCutoff
- Description: Activity cutoff for networks.
- Query Type:
u16 -> u16 - Parameters:
netuid:u16
- Default Value:
5000 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'ActivityCutoff', [netuid])
print(result.value)
4. AdjustmentAlpha
- Description: Alpha adjustment value for the network. Not used for neuron registration.
- Query Type:
u16 -> u64 - Parameters:
netuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'AdjustmentAlpha', [netuid])
print(result.value)
5. AdjustmentInterval
- Description: Adjustment interval for networks. Not used for neuron registration.
- Query Type:
u16 -> u16 - Parameters:
netuid:u16
- Default Value:
100 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'AdjustmentInterval', [netuid])
print(result.value)
6. AdminFreezeWindow
- Description: Global window (in blocks) at the end of each tempo where admin ops are disallowed
- Query Type:
u16 - Parameters: None
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
result = substrate.query('SubtensorModule', 'AdminFreezeWindow')
print(result.value)
7. Alpha
- Description: Storage for Alpha.
- Query Type:
(AccountId, AccountId, u16) -> unknown - Parameters:
hotkey:AccountIdcoldkey:AccountIdnetuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
from bittensor_wallet import Keypair
hotkey = Keypair.create_from_uri('//Alice').ss58_address
coldkey = Keypair.create_from_uri('//Bob').ss58_address
netuid = 1
result = substrate.query('SubtensorModule', 'Alpha', [hotkey, coldkey, netuid])
print(result)
8. AlphaDividendsPerSubnet
- Description: Last total alpha dividend for a hotkey on a subnet.
- Query Type:
(u16, AccountId) -> u64 - Parameters:
netuid:u16hotkey:AccountId
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
from bittensor_wallet import Keypair
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
hotkey = Keypair.create_from_uri('//Alice').ss58_address
result = substrate.query('SubtensorModule', 'AlphaDividendsPerSubnet', [netuid, hotkey])
print(result.value)
9. AlphaMapLastKey
- Description: Storage for AlphaMapLastKey.
- Query Type:
unknown - Parameters: None
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
result = substrate.query('SubtensorModule', 'AlphaMapLastKey')
print(result.value)
10. AlphaSigmoidSteepness
- Description: Storage for AlphaSigmoidSteepness.
- Query Type:
u16 -> unknown - Parameters:
netuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'AlphaSigmoidSteepness', [netuid])
print(result.value)
11. AlphaValues
- Description: Alpha values for the network (lower and upper alpha).
- Query Type:
u16 -> (u16, u16) - Parameters:
netuid:u16
- Default Value:
(45875, 58982) - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'AlphaValues', [netuid])
print(result.value)
12. AssociatedEvmAddress
- Description: Storage for the EVM address associated with a subnet's uid.
- Query Type:
(u16, u16) -> u16 - Parameters:
key:AccountIdnetuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
uid = 1
result = substrate.query('SubtensorModule', 'AssociatedEvmAddress', [netuid, uid])
print(result)
13. AutoStakeDestination
- Description: Storage for AutoStakeDestination.
- Query Type:
(u16, AccountId) -> unknown - Parameters:
netuid:u16hotkey:AccountId
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
from bittensor_wallet import Keypair
hotkey = Keypair.create_from_uri('//Alice').ss58_address
result = substrate.query('SubtensorModule', 'AutoStakeDestination', [hotkey, netuid])
print(result)
14. AutoStakeDestinationColdkeys
- Description: Storage for AutoStakeDestinationColdkeys.
- Query Type:
(u16, AccountId) -> unknown - Parameters:
netuid:u16hotkey:AccountId
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
from bittensor_wallet import Keypair
hotkey = Keypair.create_from_uri('//Alice').ss58_address
result = substrate.query('SubtensorModule', 'AutoStakeDestinationColdkeys', [hotkey, netuid])
print(result.value)
15. Axons
- Description: Axon information for a given hotkey within a network.
- Query Type:
(u16, AccountId) -> AxonInfoOf - Parameters:
netuid:u16hotkey:AccountId
- Default Value:
None - Python Example:
from async_substrate_interface import SubstrateInterface
from bittensor_wallet import Keypair
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
hotkey = Keypair.create_from_uri('//Alice').ss58_address
result = substrate.query('SubtensorModule', 'Axons', [netuid, hotkey])
print(result)
16. BlockAtRegistration
- Description: Block number at registration for a given UID.
- Query Type:
(u16, u16) -> u64 - Parameters:
netuid:u16uid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
uid = 123
result = substrate.query('SubtensorModule', 'BlockAtRegistration', [netuid, uid])
print(result.value)
17. BlockEmission
- Description: The total block emission value.
- Query Type:
u64 - Parameters: None
- Default Value:
1000000000 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
result = substrate.query('SubtensorModule', 'BlockEmission')
print(result.value)
18. BlocksSinceLastStep
- Description: Number of blocks since the last mechanism step.
- Query Type:
u16 -> u64 - Parameters:
netuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'BlocksSinceLastStep', [netuid])
print(result.value)
19. Bonds
- Description: Bond values of UIDs in a network.
- Query Type:
(u16, u16) -> Vec<(u16, u16)> - Parameters:
netuid:u16uid:u16
- Default Value:
[] - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
uid = 123
result = substrate.query('SubtensorModule', 'Bonds', [netuid, uid])
print(result.value)
20. BondsMovingAverage
- Description: Moving average of bonds in the network.
- Query Type:
u16 -> u64 - Parameters:
netuid:u16
- Default Value:
900000 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'BondsMovingAverage', [netuid])
print(result.value)
21. BondsPenalty
- Description: Bonds penalty setting for a subnet.
- Query Type:
u16 -> u16 - Parameters:
netuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'BondsPenalty', [netuid])
print(result.value)
22. BondsResetOn
- Description: Storage for BondsResetOn.
- Query Type:
u16 -> unknown - Parameters:
netuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'BondsResetOn', [netuid])
print(result.value)
23. Burn
- Description: Burn value for a given network.
- Query Type:
u16 -> u64 - Parameters:
netuid:u16
- Default Value:
1000000000 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'Burn', [netuid])
print(result.value)
24. BurnRegistrationsThisInterval
- Description: Number of burn registrations in this interval.
- Query Type:
u16 -> u16 - Parameters:
netuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'BurnRegistrationsThisInterval', [netuid])
print(result.value)
25. ChildKeys
- Description: Maps parent keys to child keys with proportions.
- Query Type:
(AccountId, u16) -> Vec<(u64, AccountId)> - Parameters:
parent:AccountIdnetuid:u16
- Default Value:
[] - Python Example:
from async_substrate_interface import SubstrateInterface
from bittensor_wallet import Keypair
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
parent = Keypair.create_from_uri('//Alice').ss58_address
netuid = 1
result = substrate.query('SubtensorModule', 'ChildKeys', [parent, netuid])
print(result.value)
26. ChildkeyTake
- Description: Returns the childkey take for a given hotkey on a specific subnet.
- Query Type:
(AccountId, u16) -> u16 - Parameters:
hotkey:AccountIdnetuid:u16
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
from bittensor_wallet import Keypair
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
hotkey = Keypair.create_from_uri('//Alice').ss58_address
netuid = 1
result = substrate.query('SubtensorModule', 'ChildkeyTake', [hotkey, netuid])
print(result.value)
27. CKBurn
- Description: Storage for coldkey burn.
- Query Type:
u64 - Parameters: None
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
result = substrate.query('SubtensorModule', 'CKBurn')
print(result.value)
29. ColdkeySwapAnnouncements
- Description: Storage for ColdkeySwapAnnouncements.
- Query Type:
u16 -> AccountId - Parameters:
coldkey:AccountId
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
from bittensor_wallet import Keypair
coldkey = Keypair.create_from_uri('//Bob').ss58_address
result = substrate.query('SubtensorModule', 'ColdkeySwapAnnouncements', [coldkey])
print(result.value)
30. ColdkeySwapAnnouncementDelay
- Description: The number of blocks that must pass after a coldkey swap is announced before it can be executed.
- Query Type:
u32 - Parameters: None
- Default Value:
36000 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
result = substrate.query('SubtensorModule', 'ColdkeySwapAnnouncementDelay')
print(result.value)
31. CommitRevealWeightsEnabled
- Description: Indicates whether the commit-reveal process for weights is enabled for a given network.
- Query Type:
u16 -> bool - Parameters:
netuid:u16
- Default Value:
false - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'CommitRevealWeightsEnabled', [netuid])
print(result.value)
32. CommitRevealWeightsVersion
- Description: Storage for CommitRevealWeightsVersion.
- Query Type:
u16 - Parameters: None
- Default Value:
0 - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
result = substrate.query('SubtensorModule', 'CommitRevealWeightsVersion')
print(result.value)
33. Consensus
- Description: Consensus values of UIDs in a network.
- Query Type:
u16 -> Vec<u16> - Parameters:
netuid:u16
- Default Value:
[] - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
result = substrate.query('SubtensorModule', 'Consensus', [netuid])
print(result.value)
34. CRV3WeightCommits
- Description: Stores a queue of v3 commits for an account on a given netuid and epoch.
- Query Type:
(u16, u64) -> VecDeque<(AccountId, Vec<u8>, u64)> - Parameters:
netuid:u16commit_epoch:u64
- Default Value:
[] - Python Example:
from async_substrate_interface import SubstrateInterface
substrate = SubstrateInterface(url="wss://test.finney.opentensor.ai:443")
netuid = 1
commit_epoch = 100
result = substrate.query('SubtensorModule', 'CRV3WeightCommits', [netuid, commit_epoch])
print(result.value)