---
title: "Current consensus state"
method: GET
path: "/consensus/tipstate"
tags: ["consensus"]
---

# Current consensus state

`GET /consensus/tipstate`

Returns the full consensus state at the current chain tip.

## Response `200`

Consensus state at the tip.

- ConsensusState — Snapshot of consensus state at a given tip.
  - `index` ChainIndex, required
    - `height` integer, required — Block height.
    - `id` string, required — 256-bit blake2b hash.
  - `prevTimestamps` string[], required — Recent block timestamps from newest to oldest.
  - `depth` string, required — 256-bit blake2b hash.
  - `childTarget` string, required — 256-bit blake2b hash.
  - `siafundTaxRevenue` string, required — Hastings (1 Siacoin = 10^24 Hastings).
  - `oakTime` string, required — Oak target window as a Go duration string.
  - `oakTarget` string, required — 256-bit blake2b hash.
  - `foundationSubsidyAddress` string, required — Human-readable Sia address.
  - `foundationManagementAddress` string, required — Human-readable Sia address.
  - `totalWork` string, required — Quantity of work encoded as a decimal string.
  - `difficulty` string, required — Quantity of work encoded as a decimal string.
  - `oakWork` string, required — Quantity of work encoded as a decimal string.
  - `elements` ElementAccumulator, required — Sparse Merkle forest tracking consensus elements.
    - `numLeaves` integer, required — Number of leaves represented by the accumulator.
    - `trees` Hash256[], required — Merkle roots for the populated accumulator trees in ascending height order.
  - `attestations` integer, required

## Changes

- **2025-10-22** `4780f06511f2` — 14 info
  - added the required property `attestations` to the response with the `200` status
  - added the required property `childTarget` to the response with the `200` status
  - added the required property `depth` to the response with the `200` status
  - added the required property `difficulty` to the response with the `200` status
  - …10 more
- **2025-10-08** `103993fc0091` — 14 breaking
  - removed the required property `attestations` from the response with the `200` status
  - removed the required property `childTarget` from the response with the `200` status
  - removed the required property `depth` from the response with the `200` status
  - removed the required property `difficulty` from the response with the `200` status
  - …10 more

[Change history](https://skmtc.dev/siafoundation/apis/hostd-api/changes/consensus/tipstate/get.md)

---

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