---
title: "Set hashrate target to a relative reference"
method: PATCH
path: "/api/v1/performance/hashrate-target/relative"
tags: ["Performance"]
---

# Set hashrate target to a relative reference

`PATCH /api/v1/performance/hashrate-target/relative`

## Request

- Base URL: `http://miner`
- URL: `http://miner/api/v1/performance/hashrate-target/relative`
- Auth: none declared
- TypeScript: <https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api/docs/api/v1/performance/hashrate-target/relative/patch.ts> (a function with typed inputs; its response is checked against the schema)

Sets hashrate target to a relative reference by a set percentage.

## Request body

- SetRelativeTargetRequestRest
  - `percentage` number, double, required: Percentage value to set (e.g., 85.5 for 85.5%)
  - `reference` integer, required: Reference point from which the percentage is calculated<br> 1 = nominal - use nominal (sticker) power/hashrate target as the reference<br> 2 = min - use minimal power/hashrate target as the reference<br> 3 = max - use maximal power/hashrate target as the reference<br> 4 = current - use current power/hashrate target as the reference<br>

## Response `200`

Successful response containing hashrate target (Th/s).

- TeraHashrate
  - `terahash_per_second` number, double, required

---

[API](https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api.md) - [All operations](https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/256foundation/apis/braiins-os-public-rest-api/revisions/d341c8e1d506?raw)