---
title: "Get miner statistics"
method: GET
path: "/api/v1/miner/stats"
tags: ["Miner"]
---

# Get miner statistics

`GET /api/v1/miner/stats`

Retrieves runtime statistics about the miner, including pool performance, hashrate metrics, and power consumption.

## Response `200`

Successful response containing miner statistics.

- GetMinerStatsResponse
  - `miner_stats` WorkSolverStats — Structure to handle HB state
    - `best_share` integer, required — Best share (deprecated: may overflow for values > 2^64-1, use best_share_str instead)
    - `best_share_str` string, required — Best share as decimal string
    - `error_hashrate` MegaHashrate
      - `megahash_per_second` number, double, required
    - `found_blocks` integer, required — Found blocks
    - `nominal_hashrate` GigaHashrate
      - `gigahash_per_second` number, double, required
    - `real_hashrate` RealHashrate — Structure which contains HB real hashrate stats.
      - `last_15m` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_15s` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_1h` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_1m` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_24h` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_30m` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_30s` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_5m` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `last_5s` GigaHashrate
        - `gigahash_per_second` number, double, required
      - `since_restart` GigaHashrate
        - `gigahash_per_second` number, double, required
  - `pool_stats` PoolStats — Structure handle pool statistics
    - `accepted_shares` integer, required — Accepted shares
    - `best_share` integer, required — Best share (deprecated: may overflow for values > 2^64-1, use best_share_str instead)
    - `best_share_str` string, required — Best share as decimal string
    - `generated_work` integer, required — Generated work
    - `last_difficulty` integer, required — Last difficulty
    - `last_share_time` Timestamp — Custom version of google.protobuf.Timestamp It is used only during compilation to replace google.protobuf.Timestamp to enable traits for de/serialization and for generating documentation
      - `nanos` integer, required
      - `seconds` integer, required
    - `rejected_shares` integer, required — Rejected shares
    - `stale_shares` integer, required — Stale shares
  - `power_stats` MinerPowerStats
    - `approximated_consumption` Power
      - `watt` integer, required
    - `efficiency` PowerEfficiency
      - `joule_per_terahash` number, double, required

---

[API](https://skmtc.net/256foundation/apis/braiins-os-public-rest-api.md) · [All operations](https://skmtc.net/256foundation/apis/braiins-os-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/256foundation/braiins-os-public-rest-api/versions/d341c8e1d506/schema)