Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/taapi-io:taapi-io-volatility-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: TAAPI.IO Volatility API
version: 2.0.0
description: 'Technical Analysis API providing indicator calculations and OHLCV candle data for crypto and stock markets.
Each indicator is exposed as its own endpoint (`GET /indicator/`) with only the parameters that indicator actually accepts documented.
## Authentication
All endpoints require a valid API key passed as a **Bearer token** in the `Authorization` header:
```
Authorization: Bearer
```
Get your API key at taapi.io.
## Rate Limiting
Requests are rate-limited per API key according to your subscription plan (see taapi.io for plan limits). Limits use a **fixed window**: the window (15 seconds by default) starts with your first request, and the counter resets when it expires.
Every authenticated response includes these headers:
| Header | Meaning |
|--------|---------|
| `X-RateLimit-Limit` | Requests allowed per window |
| `X-RateLimit-Remaining` | Requests left in the current window |
| `X-RateLimit-Reset` | Seconds until the current window resets |
When the limit is exceeded the API returns **HTTP 429** with:
```json
{ "error": "Too Many Requests", "retryAfter": 9 }
```
Wait `retryAfter` seconds before retrying.
## Real-time streaming (WebSocket)
For live indicator updates over a persistent connection, use the **streaming** service on the same domain:
- **WebSocket URL:** `wss://v2.taapi.io/streaming` (or your base URL + `/streaming` if using path-based routing)
- **Health check:** `GET https://v2.taapi.io/streaming/health`
All messages are JSON objects with a `type` field. Streaming uses `interval` (not `timeframe` as in REST); allowed intervals are `1m`, `5m`, `15m` and `1h`. Symbols use the same format as the REST API (`BTCUSDT`, not `BTC/USDT`) and must appear in `GET /exchanges/{exchange}/symbols`.
**Connection flow:**
1. Connect to the WebSocket URL.
2. **Authenticate** — send: `{ "type": "auth", "token": "Bearer " }`
- Response: `{ "type": "auth_ok", "userId": "...", "plan": { "socketSubscriptionsAllowed": 10, "streamThrottleMs": 5000 } }` or `{ "type": "auth_error", "error": "..." }`
3. **Subscribe** to an indicator — send:
`{ "type": "subscribe", "id": "my_rsi", "exchange": "binance", "symbol": "BTCUSDT", "interval": "1m", "indicator": "rsi", "params": { "period": 14 } }`
- Response: `{ "type": "subscribed", "id": "binance_btcusdt_1m_my_rsi", "subscription": "binance:btcusdt:1m", "indicator": "rsi" }`
- The returned `id` is the **scoped id**: `___`, lowercased. Use it to unsubscribe and to read updates.
4. **Receive updates** — the server pushes only values that changed, keyed by scoped id. Values are arrays, as in the REST API:
`{ "type": "update", "subscription": "binance:btcusdt:1m", "data": { "binance_btcusdt_1m_my_rsi": { "value": [41.99], "timestamp": [1793656260] } } }`
5. **Unsubscribe** — send the scoped id: `{ "type": "unsubscribe", "id": "binance_btcusdt_1m_my_rsi" }` → `{ "type": "unsubscribed", "id": "binance_btcusdt_1m_my_rsi" }`
**Other message types:**
- `{ "type": "subscribe_bulk", "exchange": "binance", "symbols": ["BTCUSDT", "ETHUSDT"], "intervals": ["1m"], "indicators": [{ "id": "my_rsi", "name": "rsi", "params": { "period": 14 } }] }` — subscribes every symbol × interval × indicator combination. The server replies `subscribe_bulk_ack`, then `subscribe_bulk_complete` with the `subKeys` registered.
- `{ "type": "unsubscribe_all" }` → `{ "type": "unsubscribed_all", "message": "..." }`
- `{ "type": "list" }` → `{ "type": "subscriptions", "data": { ... } }` (add `"unpack": true` for a flat array)
- `{ "type": "ping" }` → `{ "type": "pong", "timestamp": 1793656260000 }`
- Errors arrive as `{ "type": "error", "error": "..." }`.
Use the same API key (Bearer token) as for the REST API.'
servers:
- url: https://v2.taapi.io
description: Production
- url: http://localhost:8080
description: Local development
security:
- bearerAuth: []
tags:
- name: Volatility
description: Volatility indicators
paths:
/indicator/adr:
get:
summary: Average Daily Range (ADR)
description: '**ADR** — Average Daily Range (ADR) is the average high-to-low range of the previous candles, in price and as a percentage (ADR%). Use the 1d timeframe for the classic daily version. Also returns how much of a normal range the current candle has already covered, a common gauge for day-trading targets and stops.'
operationId: get_adr
tags:
- Volatility
parameters:
- $ref: '#/components/parameters/exchange'
- $ref: '#/components/parameters/symbol'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/results'
- $ref: '#/components/parameters/backtrack'
- name: period
in: query
required: false
description: Number of completed candles to average (the current candle is not included).
schema:
type: integer
default: 14
example: 14
responses:
'200':
description: Average Daily Range (ADR) result
content:
application/json:
schema:
type: object
properties:
value:
description: Average high - low of the previous `period` candles, in price units (null until enough candles)
type: array
items:
type: number
format: double
valuePercent:
description: 'ADR%: 100 * (average high / low - 1) over the same candles'
type: array
items:
type: number
format: double
currentRange:
description: High - low of the current candle
type: array
items:
type: number
format: double
rangeUsedPercent:
description: Current candle's range as a percentage of ADR (100 = a full average range)
type: array
items:
type: number
format: double
timestamp:
description: Unix timestamps aligned to each result value — always an array.
type: array
items:
type: integer
'202':
description: Calculation queued — retry after a short delay
content:
application/json:
schema:
$ref: '#/components/schemas/PendingResponse'
'400':
description: Missing or invalid query parameters — ensure ex, sym, and tf are all provided and valid.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required: ex, sym, tf'
'401':
description: Unauthorized — a valid API key must be provided as a Bearer token in the Authorization header.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid or inactive token
'404':
description: Unknown indicator
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
/indicator/atr:
get:
summary: Average True Range (ATR)
description: '**ATR** — Average True Range measures market volatility by calculating the average of the true range over a period. Higher ATR values indicate greater volatility.'
operationId: get_atr
tags:
- Volatility
parameters:
- $ref: '#/components/parameters/exchange'
- $ref: '#/components/parameters/symbol'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/results'
- $ref: '#/components/parameters/backtrack'
- name: period
in: query
required: false
description: Time Period
schema:
type: integer
default: 14
example: 14
responses:
'200':
description: Average True Range (ATR) result
content:
application/json:
schema:
type: object
properties:
value:
description: Indicator output values — always an array, even when results=1.
type: array
items:
type: number
format: double
timestamp:
description: Unix timestamps aligned to each result value — always an array.
type: array
items:
type: integer
'202':
description: Calculation queued — retry after a short delay
content:
application/json:
schema:
$ref: '#/components/schemas/PendingResponse'
'400':
description: Missing or invalid query parameters — ensure ex, sym, and tf are all provided and valid.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required: ex, sym, tf'
'401':
description: Unauthorized — a valid API key must be provided as a Bearer token in the Authorization header.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid or inactive token
'404':
description: Unknown indicator
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
/indicator/cvi:
get:
summary: Chaikin Volatility Index
description: '**CVI** — Chaikin Volatility Index measures the rate of change of the trading range (high minus low), indicating expanding or contracting volatility.'
operationId: get_cvi
tags:
- Volatility
parameters:
- $ref: '#/components/parameters/exchange'
- $ref: '#/components/parameters/symbol'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/results'
- $ref: '#/components/parameters/backtrack'
- name: period
in: query
required: false
description: period
schema:
type: number
format: double
responses:
'200':
description: Chaikin Volatility Index result
content:
application/json:
schema:
type: object
properties:
cvi:
description: Indicator output values — always an array, even when results=1.
type: array
items:
type: number
format: double
timestamp:
description: Unix timestamps aligned to each result value — always an array.
type: array
items:
type: integer
'202':
description: Calculation queued — retry after a short delay
content:
application/json:
schema:
$ref: '#/components/schemas/PendingResponse'
'400':
description: Missing or invalid query parameters — ensure ex, sym, and tf are all provided and valid.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required: ex, sym, tf'
'401':
description: Unauthorized — a valid API key must be provided as a Bearer token in the Authorization header.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid or inactive token
'404':
description: Unknown indicator
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
/indicator/natr:
get:
summary: Normalized Average True Range
description: '**NATR** — Normalized Average True Range expresses ATR as a percentage of the closing price, making volatility comparable across different price levels.'
operationId: get_natr
tags:
- Volatility
parameters:
- $ref: '#/components/parameters/exchange'
- $ref: '#/components/parameters/symbol'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/results'
- $ref: '#/components/parameters/backtrack'
- name: period
in: query
required: false
description: Time Period
schema:
type: integer
default: 14
example: 14
responses:
'200':
description: Normalized Average True Range result
content:
application/json:
schema:
type: object
properties:
value:
description: Indicator output values — always an array, even when results=1.
type: array
items:
type: number
format: double
timestamp:
description: Unix timestamps aligned to each result value — always an array.
type: array
items:
type: integer
'202':
description: Calculation queued — retry after a short delay
content:
application/json:
schema:
$ref: '#/components/schemas/PendingResponse'
'400':
description: Missing or invalid query parameters — ensure ex, sym, and tf are all provided and valid.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required: ex, sym, tf'
'401':
description: Unauthorized — a valid API key must be provided as a Bearer token in the Authorization header.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid or inactive token
'404':
description: Unknown indicator
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
/indicator/trange:
get:
summary: True Range
description: '**TRANGE** — True Range is the greatest of: current high minus current low, current high minus previous close, or current low minus previous close.'
operationId: get_trange
tags:
- Volatility
parameters:
- $ref: '#/components/parameters/exchange'
- $ref: '#/components/parameters/symbol'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/results'
- $ref: '#/components/parameters/backtrack'
responses:
'200':
description: True Range result
content:
application/json:
schema:
type: object
properties:
value:
description: Indicator output values — always an array, even when results=1.
type: array
items:
type: number
format: double
timestamp:
description: Unix timestamps aligned to each result value — always an array.
type: array
items:
type: integer
'202':
description: Calculation queued — retry after a short delay
content:
application/json:
schema:
$ref: '#/components/schemas/PendingResponse'
'400':
description: Missing or invalid query parameters — ensure ex, sym, and tf are all provided and valid.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required: ex, sym, tf'
'401':
description: Unauthorized — a valid API key must be provided as a Bearer token in the Authorization header.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid or inactive token
'404':
description: Unknown indicator
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
/indicator/volatility:
get:
summary: Volatility
description: Volatility measures the standard deviation of logarithmic returns over a period, providing a statistical measure of price variability.
operationId: get_volatility
tags:
- Volatility
parameters:
- $ref: '#/components/parameters/exchange'
- $ref: '#/components/parameters/symbol'
- $ref: '#/components/parameters/timeframe'
- $ref: '#/components/parameters/results'
- $ref: '#/components/parameters/backtrack'
- name: period
in: query
required: false
description: period
schema:
type: number
format: double
responses:
'200':
description: Volatility result
content:
application/json:
schema:
type: object
properties:
volatility:
description: Indicator output values — always an array, even when results=1.
type: array
items:
type: number
format: double
timestamp:
description: Unix timestamps aligned to each result value — always an array.
type: array
items:
type: integer
'202':
description: Calculation queued — retry after a short delay
content:
application/json:
schema:
$ref: '#/components/schemas/PendingResponse'
'400':
description: Missing or invalid query parameters — ensure ex, sym, and tf are all provided and valid.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required: ex, sym, tf'
'401':
description: Unauthorized — a valid API key must be provided as a Bearer token in the Authorization header.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid or inactive token
'404':
description: Unknown indicator
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
components:
parameters:
exchange:
name: exchange
in: query
required: true
description: 'Exchange identifier: `binance`, `binancefutures`, `bybit`, `gateio`, `kraken`, or `stocks` for US stocks. `GET /exchanges` returns the current list.'
schema:
type: string
example: binance
symbol:
name: symbol
in: query
required: true
description: Trading pair or ticker symbol (e.g. `BTCUSDT`, `ETHUSDT`, `AAPL`)
schema:
type: string
example: BTCUSDT
backtrack:
name: backtrack
in: query
required: false
description: Number of candles to skip from the end (shift results back in time).
schema:
type: integer
default: 0
example: 0
timeframe:
name: timeframe
in: query
required: true
description: Candle timeframe
schema:
type: string
enum:
- 1m
- 5m
- 15m
- 1h
- 4h
- 1d
- 1w
example: 1h
results:
name: results
in: query
required: false
description: Number of results to return. Use `max` to return all available results.
schema:
type: integer
default: 1
example: 1
responses:
RateLimited:
description: Rate limit exceeded — your plan allows a fixed number of requests per window (15 seconds by default). Wait `retryAfter` seconds (also in `X-RateLimit-Reset`) before retrying.
headers:
X-RateLimit-Limit:
description: Requests allowed per window for your plan.
schema:
type: integer
example: 30
X-RateLimit-Remaining:
description: Requests left in the current window.
schema:
type: integer
example: 0
X-RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
example: 9
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Too Many Requests
retryAfter:
type: integer
description: Seconds until the current window resets.
example: 9
schemas:
PendingResponse:
type: object
properties:
pending:
type: boolean
example: true
key:
type: string
example: ta:binance:BTCUSDT:1h:rsi:abc123:rmax
ErrorResponse:
type: object
properties:
error:
type: string
example: 'Unknown indicator: fakeindicator'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API key
description: Your TAAPI API key, passed as a Bearer token in the Authorization header.