BB Width API — Detect the Squeeze Before the Pop

Bollinger Band Width = (upper − lower) / middle. Watch it compress to detect low-volatility coiling — a precursor to breakouts.

No credit card$2.50 PAYG credit on sign up
15+API endpoints
42Indicator series
M1–D17 timeframes
$2.50PAYG starting credit
Why TickAtlas

What is the BB Width API?

Bollinger Band Width measures the percentage distance between the upper and lower Bollinger Bands relative to the middle band: (Upper − Lower) / Middle × 100. When BB Width contracts to its lowest point in a given period, a volatility squeeze is forming — historically a precursor to a significant directional breakout. Our API delivers the current width value, individual band levels, and a squeeze signal so your bot can detect and trade breakouts programmatically.

Pre-Calculated, Redis-Cached

Indicator values are computed server-side on every new candle. Your app queries the result — no TA library, no candle history needed.

7 Timeframes

M1, M5, M15, M30, H1, H4, D1 — the same endpoint serves scalpers and position traders alike.

Forex, Crypto, Commodities

EURUSD, GBPUSD, XAUUSD, BTCUSD, USDJPY — data available for every symbol in our data.

One Request. Instant Data.

REQUEST
curl -X GET \
  "https://tickatlas.com/v1/indicator?symbol=EURUSD&indicator=BB_width&timeframe=H1" \
  -H "X-API-Key: YOUR_API_KEY"
200 OK
{
  "success": true,
  "data": {
    "symbol": "EURUSD",
    "timeframe": "H1",
    "indicator": "BB_width",
    "value": 0.00410,
    "bid": 1.08401,
    "ask": 1.08414,
    "updated_at": 1711548000,
    "server_time": "2024-03-27T14:00:00+00:00"
  }
}

Plug into any stack

  • ChatGPT Custom GPTs
  • Claude Tools
  • Python / pandas
  • Node.js
  • Discord bots
  • Slack webhooks
  • n8n
  • Zapier
  • Google Sheets
Pricing

Start on pay-as-you-go, upgrade when the traffic justifies it.

Every new account starts with $2.50 of pay-as-you-go credit and no card. Monthly plans add a flat monthly price, WebSocket streaming and support.

Pay as you go
$2.50 credit No card required to start
  • $2.50 of credit included
  • Every REST endpoint except raw ticks
  • No card required, no overage
  • 10 API keys
See plan details
Starter
$29 per month · 10,000 requests/day · 120/min
  • Every REST endpoint except raw ticks
  • WebSocket streaming, 5 symbols
  • Released calendar actuals
  • Email support
  • 3 API keys
See plan details
Frequently asked questions

What developers ask first.

Straight answers on limits, coverage and how the endpoint behaves in production.

How is BB Width calculated?

BB Width = (Upper Band − Lower Band) / Middle Band × 100. The Bollinger Bands use 20-period SMA as the middle band, with upper and lower bands set at 2 standard deviations. Our API pre-calculates this using candle close prices from our data.

What qualifies as a 'squeeze' signal?

There is no squeeze flag in the response — BB_width is a number. A squeeze is when the current BB Width sits near its lowest value over your chosen lookback window, indicating unusually contracted bands relative to recent history. When the squeeze ends and width expands, that is typically the breakout entry.

Can I use BB Width history to identify past squeezes?

Yes — use GET /v1/indicator/history with indicator=BB_width. Plot the width series to find historical squeeze lows. This is useful for understanding how long squeezes typically last on a given symbol/timeframe before breaking out.

Does the response include the band levels?

Not from the BB_width call itself — /v1/indicator returns one value per request. Use GET /v1/indicators?symbol=EURUSD&timeframe=H1&category=volatility instead: BB_upper, BB_middle, BB_lower and BB_width come back together in the indicators map, so you get the band levels to set bracket orders around in one call.

Start building

Start Building in 5 Minutes

Sign up, grab your API key, make your first request.

Every new account starts with $2.50 of pay-as-you-go credit. No card required.