# coldkey-lock (/docs/query/coldkey-lock)

`locked_alpha` is denominated in the subnet's alpha and rolled forward
(decayed) to the current block; `is_perpetual` locks do not decay.

**Category:** Locks & conviction

## Parameters [#parameters]

| Parameter      | Type    | Description                 |
| -------------- | ------- | --------------------------- |
| `coldkey_ss58` | string  | Coldkey whose lock to read. |
| `netuid`       | integer | Subnet to query.            |

## CLI [#cli]

```bash
btcli query coldkey-lock --coldkey <ss58|name> --netuid <integer> --json
```

## Python [#python]

```python
import bittensor as sub

async with sub.Client("finney") as client:
    result = await client.read("coldkey_lock", coldkey_ss58="5F...", netuid=1)
```