# SuperTrend & Trend-Following API
> Live trend-following indicators that traders run to ride a trend and time its turn, computed on demand from the OHLC candles you pass in — no key, no cache, nothing stored. The supertrend endpoint returns the SuperTrend line, the ATR-banded trailing level that sits below price in an uptrend (acting as support) and above it in a downtrend (acting as resistance) and flips when a close crosses it, with the current trend. The aroon endpoint returns Aroon Up, Aroon Down and the Aroon Oscillator, which measure how recently the highest high and lowest low were made — a reading of 100 means it just happened — to tell you how fresh and strong the trend is. The vortex endpoint returns the Vortex Indicator's VI+ and VI- lines, whose crossover is a classic trend-change signal. These are trend-following indicators, deliberately distinct from the ADX, Parabolic SAR and Donchian set and from momentum, volatility and volume tools: they each use the high, low and close to follow a trend and flag its reversal with their own formula. Works for any market — forex, stocks, crypto or commodities — because you supply the candles. Computed locally and deterministically, so it is instant and private. Ideal for trend-following bots, signal dashboards and back-tests. SuperTrend defaults to period 10 multiplier 3; Aroon to 25; Vortex to 14. Live, nothing stored. 3 compute endpoints. For ADX/Parabolic-SAR/Donchian use a trend-indicators API; for RSI/MACD use a technical-indicators API.

## 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/supertrend-api/..."
```

## Pricing
- **Free** (Free) — 4,150 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 84,500 calls/Mo, 6 req/s
- **Pro** ($23/Mo) — 443,000 calls/Mo, 18 req/s
- **Business** ($54/Mo) — 2,790,000 calls/Mo, 45 req/s

## Endpoints

### Trend

#### `GET /v1/aroon` — Aroon Up/Down + Oscillator

**Parameters:**
- `candles` (query, required, string) — OHLC candles open:high:low:close Example: `100:102:99:101,101:104:100:103,103:105:101:104,104:106:103:105,105:107:104:106,106:108:105:107,107:109:106:108,108:110:107:109,109:111:108:110,110:112:109:111,111:113:110:112,112:114:111:113,113:115:112:114,114:116:113:115,115:117:114:116,116:118:115:117,117:119:116:118,118:120:117:119,119:121:118:120,120:122:119:121,121:123:120:122,122:124:121:123,123:125:122:124,124:126:123:125,125:127:124:126,126:128:125:127`
- `period` (query, optional, string) — Period (default 25; needs period + 1 candles) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/supertrend-api/v1/aroon?candles=100%3A102%3A99%3A101%2C101%3A104%3A100%3A103%2C103%3A105%3A101%3A104%2C104%3A106%3A103%3A105%2C105%3A107%3A104%3A106%2C106%3A108%3A105%3A107%2C107%3A109%3A106%3A108%2C108%3A110%3A107%3A109%2C109%3A111%3A108%3A110%2C110%3A112%3A109%3A111%2C111%3A113%3A110%3A112%2C112%3A114%3A111%3A113%2C113%3A115%3A112%3A114%2C114%3A116%3A113%3A115%2C115%3A117%3A114%3A116%2C116%3A118%3A115%3A117%2C117%3A119%3A116%3A118%2C118%3A120%3A117%3A119%2C119%3A121%3A118%3A120%2C120%3A122%3A119%3A121%2C121%3A123%3A120%3A122%2C122%3A124%3A121%3A123%2C123%3A125%3A122%3A124%2C124%3A126%3A123%3A125%2C125%3A127%3A124%3A126%2C126%3A128%3A125%3A127&period=25"
```

**Response:**
```json
{
    "data": {
        "note": "Aroon Up/Down measure how recently the highest high / lowest low occurred over the period (100 = just now). Oscillator = Up - Down.",
        "period": 25,
        "signal": "strong_uptrend",
        "source": "SUPERTREND",
        "candles": 26,
        "aroon_up": 100,
        "aroon_down": 0,
        "aroon_oscillator": 100
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:56.698Z",
        "request_id": "9e72175b-03fc-4d9b-bcdc-7fe1ef31a8ef"
    },
    "status": "ok",
    "message": "Aroon computed",
    "success": true
}
```

#### `GET /v1/supertrend` — SuperTrend line + trend

**Parameters:**
- `candles` (query, required, string) — OHLC candles open:high:low:close, comma-separated oldest first Example: `100:102:99:101,101:104:100:103,103:105:101:104,104:106:103:105,105:107:104:106,106:108:105:107,107:109:106:108,108:110:107:109,109:111:108:110,110:112:109:111,111:113:110:112,112:114:111:113,113:115:112:114,114:116:113:115,115:117:114:116,116:118:115:117,117:119:116:118,118:120:117:119,119:121:118:120,120:122:119:121,121:123:120:122,122:124:121:123,123:125:122:124,124:126:123:125,125:127:124:126,126:128:125:127`
- `period` (query, optional, string) — ATR period (default 10) Example: `10`
- `multiplier` (query, optional, string) — ATR multiplier (default 3) Example: `3`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/supertrend-api/v1/supertrend?candles=100%3A102%3A99%3A101%2C101%3A104%3A100%3A103%2C103%3A105%3A101%3A104%2C104%3A106%3A103%3A105%2C105%3A107%3A104%3A106%2C106%3A108%3A105%3A107%2C107%3A109%3A106%3A108%2C108%3A110%3A107%3A109%2C109%3A111%3A108%3A110%2C110%3A112%3A109%3A111%2C111%3A113%3A110%3A112%2C112%3A114%3A111%3A113%2C113%3A115%3A112%3A114%2C114%3A116%3A113%3A115%2C115%3A117%3A114%3A116%2C116%3A118%3A115%3A117%2C117%3A119%3A116%3A118%2C118%3A120%3A117%3A119%2C119%3A121%3A118%3A120%2C120%3A122%3A119%3A121%2C121%3A123%3A120%3A122%2C122%3A124%3A121%3A123%2C123%3A125%3A122%3A124%2C124%3A126%3A123%3A125%2C125%3A127%3A124%3A126%2C126%3A128%3A125%3A127&period=10&multiplier=3"
```

**Response:**
```json
{
    "data": {
        "atr": 3.0370604,
        "note": "SuperTrend = ATR-banded trailing line; price above it = uptrend (line is support), below = downtrend (line is resistance). A close crossing the line flips the trend.",
        "trend": "up",
        "period": 10,
        "source": "SUPERTREND",
        "candles": 26,
        "distance": 9.61118121,
        "last_close": 127,
        "multiplier": 3,
        "supertrend": 117.38881879
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:56.783Z",
        "request_id": "be58f7b2-b5a3-410a-bcc5-e2484ebdc346"
    },
    "status": "ok",
    "message": "SuperTrend computed",
    "success": true
}
```

#### `GET /v1/vortex` — Vortex Indicator VI+ / VI-

**Parameters:**
- `candles` (query, required, string) — OHLC candles open:high:low:close Example: `100:102:99:101,101:104:100:103,103:105:101:104,104:106:103:105,105:107:104:106,106:108:105:107,107:109:106:108,108:110:107:109,109:111:108:110,110:112:109:111,111:113:110:112,112:114:111:113,113:115:112:114,114:116:113:115,115:117:114:116,116:118:115:117,117:119:116:118,118:120:117:119,119:121:118:120,120:122:119:121,121:123:120:122,122:124:121:123,123:125:122:124,124:126:123:125,125:127:124:126,126:128:125:127`
- `period` (query, optional, string) — Period (default 14) Example: `14`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/supertrend-api/v1/vortex?candles=100%3A102%3A99%3A101%2C101%3A104%3A100%3A103%2C103%3A105%3A101%3A104%2C104%3A106%3A103%3A105%2C105%3A107%3A104%3A106%2C106%3A108%3A105%3A107%2C107%3A109%3A106%3A108%2C108%3A110%3A107%3A109%2C109%3A111%3A108%3A110%2C110%3A112%3A109%3A111%2C111%3A113%3A110%3A112%2C112%3A114%3A111%3A113%2C113%3A115%3A112%3A114%2C114%3A116%3A113%3A115%2C115%3A117%3A114%3A116%2C116%3A118%3A115%3A117%2C117%3A119%3A116%3A118%2C118%3A120%3A117%3A119%2C119%3A121%3A118%3A120%2C120%3A122%3A119%3A121%2C121%3A123%3A120%3A122%2C122%3A124%3A121%3A123%2C123%3A125%3A122%3A124%2C124%3A126%3A123%3A125%2C125%3A127%3A124%3A126%2C126%3A128%3A125%3A127&period=14"
```

**Response:**
```json
{
    "data": {
        "note": "Vortex Indicator: VI+ = sum(|high - prior low|)/sum(TR); VI- = sum(|low - prior high|)/sum(TR). VI+ above VI- = uptrend; a crossover signals a trend change.",
        "period": 14,
        "source": "SUPERTREND",
        "spread": 0.666667,
        "candles": 26,
        "vi_plus": 1.333333,
        "vi_minus": 0.666667,
        "direction": "bullish"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:56.875Z",
        "request_id": "ec8865a5-084f-4fdf-a6d4-f3b218657708"
    },
    "status": "ok",
    "message": "Vortex computed",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "candles = open:high:low:close, comma-separated, oldest first. SuperTrend period defaults to 10 (multiplier 3); Aroon to 25; Vortex to 14.",
        "source": "Computed in-process from caller-supplied OHLC candles (no upstream)",
        "service": "supertrend-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/aroon": "Aroon Up/Down + Oscillator (candles=o:h:l:c,...&period=25).",
            "GET /v1/vortex": "Vortex Indicator VI+ / VI- (candles=o:h:l:c,...&period=14).",
            "GET /v1/supertrend": "SuperTrend line + trend (candles=o:h:l:c,...&period=10&multiplier=3)."
        },
        "description": "Live trend-following indicators computed on demand from OHLC candles. The supertrend endpoint returns the SuperTrend line (ATR-banded stop-and-flip) and the trend; the aroon endpoint returns Aroon Up/Down and the Aroon Oscillator; the vortex endpoint returns the Vortex Indicator's VI+ and VI- lines. Trend-following indicators distinct from the ADX/Parabolic-SAR/Donchian set and from momentum, volatility and volume tools — they use the high/low/close to follow a trend and flag its reversal. Computed locally, nothing stored.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:56.990Z",
        "request_id": "b1955046-7ee6-4f9c-a521-d612fc963afc"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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