# blocks-until-next-epoch (/docs/query/blocks-until-next-epoch)

Derived from the chain's own `next_epoch_start_block` at one pinned block.
The actual fire can shift by a few blocks (per-block epoch cap defers,
owner triggers pull earlier) — to act on the epoch itself, use
`client.wait_for_epoch()`.

**Category:** Epochs & timing

## Parameters [#parameters]

| Parameter | Type    | Description      |
| --------- | ------- | ---------------- |
| `netuid`  | integer | Subnet to query. |

## CLI [#cli]

```bash
btcli query blocks-until-next-epoch --netuid <integer> --json
```

## Python [#python]

Namespace method (autocomplete, signature help):

```python
import bittensor as bt

sub = bt.Subtensor()
result = sub.epochs.blocks_until_next_epoch(netuid=1)
```

Or dispatch by name, as an agent would:

```python
result = sub.read("blocks_until_next_epoch", netuid=1)
```

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

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

* Runtime API [`SubnetInfoRuntimeApi.get_next_epoch_start_block`](/code/pallets/subtensor/src/coinbase/run_coinbase.rs#L1183-L1197)

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