---
title: "Scan chart and candlestick patterns (beta)"
method: GET
path: "/v1/patterns/{ticker}"
tags: ["Chart Patterns"]
---

# Scan chart and candlestick patterns (beta)

`GET /v1/patterns/{ticker}`

## Request

- Base URL: `https://tradewink.fly.dev`
- URL: `https://tradewink.fly.dev/v1/patterns/{ticker}`
- Auth: HTTP bearer

**Beta.** Runs Tradewink's rule-based detectors over daily closing prices (double top/bottom, head and shoulders, triangle, flag, cup and handle, rounding bottom, wedge) and over the latest OHLC bars (single- and multi-candle patterns), returning each detected pattern with its direction, heuristic confidence and key price levels. Read-only: the scan does not change signal scoring, create signals or place orders, and a detected pattern is not a forecast. Most chart detectors need 30-60 bars, so `period` defaults to `6mo`. Also available as the `get_chart_patterns` MCP tool.

## Path parameters

- `ticker` string, required: US stock ticker symbol (1-5 uppercase letters, optional .X suffix)

## Query parameters

- `period` '1d' | '5d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y'

## Response `200`

Pattern scan

- object
  - `ok` true, required
  - `data` object, required: Beta. Read-only scan output; it does not change signal scoring or create signals.
    - `ticker` string, required
    - `period` '1d' | '5d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y', required
    - `beta` true, required
    - `bars` integer, required: Daily bars scanned
    - `chart_patterns` ChartPattern[], required
      - `name` 'double_top' | 'double_bottom' | 'head_and_shoulders' | 'inverse_head_and_shoulders' | 'triangle' | 'flag' | 'cup_and_handle' | 'rounding_bottom' | 'wedge', required
      - `direction` 'bullish' | 'bearish' | 'neutral', required
      - `confidence` number, required: Heuristic cleanliness score of the structure, not a probability of success
      - `key_levels` object, required: Labelled price levels (neckline, peaks, troughs, trendlines)
      - `target` number, nullable: Measured-move level implied by the pattern
    - `candlestick_patterns` CandlestickPattern[], required: Candle patterns on the most recent bars; empty when OHLC columns are missing
      - `name` string, required
      - `direction` 'bullish' | 'bearish' | 'neutral', required
      - `strength` number, required
    - `candlestick_bias` object, nullable
      - `net_bias` 'bullish' | 'bearish' | 'neutral'
      - `net_strength` number
    - `insufficient_bars` string[]: Chart detectors skipped because the series is shorter than their minimum

## Other responses

- `400`: Invalid ticker or period
- `404`: No historical data
- `429`: Per-key rate limit exceeded (`code: rate_limited`). Wait `Retry-After` seconds.
- `502`: Market data fetch or scan failed

---

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