# Crypto Candlestick Pattern Detector API
> Which reversal and continuation candlestick patterns have just printed on a coin, and which coins across the market are flashing one right now, detected live from Binance candles — no key, nothing stored. Candlestick patterns are the oldest price-action signals there are: a hammer at the bottom of a move, a bearish engulfing at the top, a doji marking indecision. The detect endpoint fetches a pair's recent candles and returns the patterns found on the latest ones — each with its name, whether it is bullish, bearish or neutral, the candle it formed on and a short meaning — plus the latest OHLC. The screener endpoint scans a basket of coins and surfaces the ones whose most recent completed candle just formed a bullish or bearish reversal pattern, so you can find fresh setups across the market in one call. The symbols endpoint lists tradable pairs. This is the coin-native candlestick-pattern screener cut for crypto — it fetches the live data itself, distinct from the generic pattern-recognition calculator (which you feed your own OHLC), the Donchian breakout, the momentum and the volume-profile APIs in the catalogue. Detected patterns include hammer, shooting star, bullish/bearish engulfing, doji, marubozu and morning/evening star. Pairs are Binance symbols (BTCUSDT) or a coin=BTC&quote=USDT form; interval is 1h/4h/1d/1w.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cryptopatterns-api/..."
```

## Pricing
- **Free** (Free) — 450 calls/Mo, 2 req/s
- **Starter** ($10/Mo) — 13,200 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 73,000 calls/Mo, 16 req/s
- **Business** ($79/Mo) — 375,000 calls/Mo, 40 req/s

## Endpoints

### Patterns

#### `GET /v1/detect` — Candlestick patterns on a pair's latest candles

**Parameters:**
- `symbol` (query, required, string) — Binance pair Example: `BTCUSDT`
- `interval` (query, optional, string) — 1h, 4h, 1d or 1w (default 1d) Example: `1d`
- `lookback` (query, optional, string) — Candles to scan (1-30, default 5) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptopatterns-api/v1/detect?symbol=BTCUSDT&interval=1d&lookback=10"
```

#### `GET /v1/screener` — Scan a basket for fresh pattern signals

**Parameters:**
- `coins` (query, optional, string) — Comma list of coins (default liquid majors) Example: `BTC,ETH,SOL,DOGE,XRP`
- `interval` (query, optional, string) — 1h, 4h, 1d or 1w (default 1d) Example: `1d`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptopatterns-api/v1/screener?coins=BTC%2CETH%2CSOL%2CDOGE%2CXRP&interval=1d"
```

#### `GET /v1/symbols` — Tradable Binance pairs

**Parameters:**
- `quote` (query, optional, string) — Filter by quote asset Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptopatterns-api/v1/symbols?quote=USDT"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptopatterns-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/cryptopatterns-api
OpenAPI spec: https://www.oanor.com/api/cryptopatterns-api/openapi.json