---
title: "Current host settings"
method: GET
path: "/settings"
tags: ["settings"]
---

# Current host settings

`GET /settings`

Returns the host's current configuration settings.

## Response `200`

Host configuration.

- HostSettings
  - `acceptingContracts` boolean — Whether the host is accepting new contracts.
  - `netAddress` string — Public hostname or IP address of the host. Must not include a port.
  - `maxContractDuration` integer — Maximum allowed contract duration in blocks.
  - `windowSize` integer — Storage proof window size in blocks.
  - `contractPrice` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `baseRPCPrice` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `sectorAccessPrice` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `collateralMultiplier` number, double — Multiplier applied to storage price to calculate collateral per byte per block.
  - `maxCollateral` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `storagePrice` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `egressPrice` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `ingressPrice` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `priceTableValidity` integer — How long a price table remains valid in nanoseconds.
  - `maxRegistryEntries` integer — Maximum number of registry entries the host will store.
  - `accountExpiry` integer — Duration before an idle ephemeral account expires in nanoseconds.
  - `maxAccountBalance` string — Hastings (1 Siacoin = 10^24 Hastings).
  - `ingressLimit` integer — Bandwidth limit for RHP ingress in bytes per second. 0 means unlimited.
  - `egressLimit` integer — Bandwidth limit for RHP egress in bytes per second. 0 means unlimited.
  - `syncerIngressLimit` integer — Bandwidth limit for syncer ingress in bytes per second. 0 means unlimited.
  - `syncerEgressLimit` integer — Bandwidth limit for syncer egress in bytes per second. 0 means unlimited.
  - `ddns` DNSSettings
    - `provider` string — DNS provider name (e.g. "cloudflare", "duckdns", "noip", "route53"). Empty disables DDNS.
    - `ipv4` boolean — Whether to update the IPv4 DNS record.
    - `ipv6` boolean — Whether to update the IPv6 DNS record.
    - `options` object, nullable — Provider-specific configuration options.
  - `sectorCacheSize` integer — Number of sectors to cache in memory for faster reads.
  - `revision` integer — Settings revision number managed by the caller.

## Changes

- **2026-01-07** `d96c56d6970b` — 2 info
  - added the optional property `syncerEgressLimit` to the response with the `200` status
  - added the optional property `syncerIngressLimit` to the response with the `200` status
- **2025-10-09** `9253c6f7b002` — 2 breaking
  - the `accountExpiry` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
  - the `priceTableValidity` response's property type/format changed from `string`/`` to `integer`/`int64` for status `200`
- **2025-10-08** `103993fc0091` — 2 breaking, 2 warning
  - the `accountExpiry` response's property type/format changed from `integer`/`int64` to `string`/`` for status `200`
  - the `priceTableValidity` response's property type/format changed from `integer`/`int64` to `string`/`` for status `200`
  - removed the optional property `syncerEgressLimit` from the response with the `200` status
  - removed the optional property `syncerIngressLimit` from the response with the `200` status

[Change history](https://skmtc.dev/siafoundation/apis/hostd-api/changes/settings/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)