# miner-collateral (/docs/query/miner-collateral)

Collateral is keyed by hotkey + coldkey so nominators on the same hotkey are
never charged for the owner's bond. When `coldkey_ss58` is omitted, the
hotkey owner is used.

`locked_alpha` is non-withdrawable stake released through earned emission
(miner incentive and validator dividends) at `drain_ratio` alpha per alpha
earned; `min_locked_alpha` is the miner-set floor the lock self-maintains
around (the drain stops at it and emission fills any shortfall);
`earned_alpha` is lifetime emission since the collateral entry existed.
Derived: `headroom_alpha` (draining portion above the floor),
`shortfall_alpha` (capture in progress below the floor), and
`releasable_work_alpha` (emission still needed to release the headroom).
The lock survives deregistration and is credited on re-registration.

**Category:** Mining & collateral

## Parameters [#parameters]

| Parameter      | Type    | Description                                                         |
| -------------- | ------- | ------------------------------------------------------------------- |
| `netuid`       | integer | Subnet to query.                                                    |
| `hotkey_ss58`  | string  | Miner hotkey of the bonded stake position.                          |
| `coldkey_ss58` | string  | Coldkey of the bonded stake position. Defaults to the hotkey owner. |

## CLI [#cli]

```bash
btcli query miner-collateral --netuid <integer> --hotkey <ss58|name> --coldkey <ss58|name> --json
```

## Python [#python]

Namespace method (autocomplete, signature help):

```python
import bittensor as bt

sub = bt.Subtensor()
result = sub.collateral.miner_collateral(netuid=1, hotkey_ss58="5F...", coldkey_ss58="5F...")
```

Or dispatch by name, as an agent would:

```python
result = sub.read("miner_collateral", netuid=1, hotkey_ss58="5F...", coldkey_ss58="5F...")
```

Async is the same surface awaited: `async with bt.Subtensor() as client:`.

## On-chain implementation [#on-chain-implementation]

* Storage [`SubtensorModule.Owner`](/code/pallets/subtensor/src/lib.rs#L1347)

Every file is browsable under [/code](/code) exactly as built into the runtime.