---
title: "Current metrics snapshot"
method: GET
path: "/metrics"
tags: ["metrics"]
---

# Current metrics snapshot

`GET /metrics`

Returns a snapshot of host metrics at the specified or current timestamp.

## Query parameters

- `timestamp` string, date-time

## Response `200`

Metrics as of the requested timestamp.

- Metrics
  - `accounts` AccountsMetrics, required
    - `active` integer, required — Number of active ephemeral accounts.
    - `balance` string, required — Hastings (1 Siacoin = 10^24 Hastings).
  - `revenue` RevenueMetrics, required
    - `potential` Revenue, required
      - `rpc` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `storage` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `ingress` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `egress` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `registryRead` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `registryWrite` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `earned` Revenue, required
      - `rpc` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `storage` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `ingress` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `egress` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `registryRead` string, required — Hastings (1 Siacoin = 10^24 Hastings).
      - `registryWrite` string, required — Hastings (1 Siacoin = 10^24 Hastings).
  - `pricing` PricingMetrics, required
    - `contractPrice` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `ingressPrice` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `egressPrice` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `baseRPCPrice` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `sectorAccessPrice` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `storagePrice` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `collateralMultiplier` number, double, required — Current collateral multiplier applied to storage price.
  - `contracts` ContractsMetrics, required
    - `active` integer, required — Number of active contracts.
    - `rejected` integer, required — Number of rejected contracts.
    - `failed` integer, required — Number of failed contracts.
    - `renewed` integer, required — Number of renewed contracts.
    - `successful` integer, required — Number of successfully completed contracts.
    - `lockedCollateral` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `riskedCollateral` string, required — Hastings (1 Siacoin = 10^24 Hastings).
  - `storage` StorageMetrics, required
    - `totalSectors` integer, required — Total number of sector slots across all volumes.
    - `physicalSectors` integer, required — Number of sectors physically stored on disk.
    - `lostSectors` integer, required — Number of sectors lost due to failed volumes.
    - `contractSectors` integer, required — Number of sectors associated with contracts.
    - `tempSectors` integer, required — Number of temporary sectors not yet associated with contracts.
    - `reads` integer, required — Total number of successful sector reads.
    - `writes` integer, required — Total number of successful sector writes.
    - `readBytes` integer, required — Total bytes read from disk.
    - `writeBytes` integer, required — Total bytes written to disk.
    - `sectorCacheHits` integer, required — Number of sector reads served from the in-memory cache.
    - `sectorCacheMisses` integer, required — Number of sector reads that required disk access.
  - `registry` RegistryMetrics, required
    - `entries` integer, required — Current number of registry entries.
    - `maxEntries` integer, required — Maximum number of registry entries allowed.
    - `reads` integer, required — Total number of registry read operations.
    - `writes` integer, required — Total number of registry write operations.
  - `data` DataMetrics, required
    - `rhp` RHPData, required
      - `ingress` integer, required — Total bytes received in the period.
      - `egress` integer, required — Total bytes sent in the period.
    - `syncer` RHPData, required
      - `ingress` integer, required — Total bytes received in the period.
      - `egress` integer, required — Total bytes sent in the period.
  - `wallet` WalletMetrics, required
    - `balance` string, required — Hastings (1 Siacoin = 10^24 Hastings).
    - `immatureBalance` string, required — Hastings (1 Siacoin = 10^24 Hastings).
  - `timestamp` string, date-time, required — Timestamp the metrics were recorded at.

---

[API](https://skmtc.net/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.net/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/versions/08ff756929fc/schema)