---
title: "Pinned settings"
method: GET
path: "/settings/pinned"
tags: ["settings"]
---

# Pinned settings

`GET /settings/pinned`

Returns the host's pinned price settings. Requires an explorer.

## Response `200`

Pinned settings response.

- PinnedSettings
  - `currency` string, required — Three-letter external currency code (e.g. "usd"). Required when any pin is enabled.
  - `threshold` number, double, required — Percentage threshold (0 to 1) that triggers a settings update when the exchange rate changes.
  - `storage` Pin, required
    - `pinned` boolean, required — Whether this price is pinned to the external currency.
    - `value` number, double, required — Price in the external currency. Only used when pinned is true.
  - `ingress` Pin, required
    - `pinned` boolean, required — Whether this price is pinned to the external currency.
    - `value` number, double, required — Price in the external currency. Only used when pinned is true.
  - `egress` Pin, required
    - `pinned` boolean, required — Whether this price is pinned to the external currency.
    - `value` number, double, required — Price in the external currency. Only used when pinned is true.
  - `maxCollateral` Pin, required
    - `pinned` boolean, required — Whether this price is pinned to the external currency.
    - `value` number, double, required — Price in the external currency. Only used when pinned is true.

---

[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)