Queries

hotkey-conviction

Conviction metrics for a hotkey on a subnet.

View as Markdown

Returns conviction_alpha denominated in the subnet's alpha, rolled forward to the current block.

Category: Locks & conviction

Parameters

ParameterTypeDescription
hotkey_ss58stringHotkey whose conviction to read.
netuidintegerSubnet to query.

CLI

btcli query hotkey-conviction --hotkey <ss58|name> --netuid <integer> --json

Python

Typed namespace method (autocomplete, signature help):

import bittensor as sub

async with sub.Client("finney") as client:
    result = await client.locks.hotkey_conviction(hotkey_ss58="5F...", netuid=1)

Or dispatch by name, as an agent would:

result = await client.read("hotkey_conviction", hotkey_ss58="5F...", netuid=1)