---
title: "Set Threshold"
method: PUT
path: "/watchlists/{watchlist_id}/tickers/{ticker}/threshold"
tags: ["watchlists"]
---

# Set Threshold

`PUT /watchlists/{watchlist_id}/tickers/{ticker}/threshold`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/watchlists/{watchlist_id}/tickers/{ticker}/threshold`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `watchlist_id` integer, required
- `ticker` string, required

## Request body

- ThresholdIn
  - `alert_threshold_pct` number, nullable, required

## Response `200`

Successful Response

- ThresholdOut
  - `ticker` string, required
  - `alert_threshold_pct` number, nullable, required
  - `is_custom` boolean, required
  - `threshold_source` 'override' | 'company_default' | 'calibrating', required
  - `company_default_threshold_pct` number, nullable, required
  - `company_default_threshold_basis` string, required
  - `muted` boolean, required
  - `company_name` string, nullable
  - `price` number, nullable
  - `day_change_pct` number, nullable
  - `quote_as_of` string, date-time, nullable
  - `quote_provider_code` string, nullable
  - `quote_unavailable_reason` string, nullable
  - `news_checked_at` string, date-time, nullable
  - `pe_ratio` number, nullable
  - `dividend_yield_pct` number, nullable
  - `week52_high` number, nullable
  - `week52_low` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/b14b999b8f0c?raw)