# ADX & Trend-Strength Screener (Multi-Asset) API
> Which markets are strongly trending and which are stuck going nowhere, computed live from Yahoo Finance (no key, nothing stored). The Average Directional Index is the definitive measure of trend STRENGTH (not direction): above 25 a market has a real trend worth riding, below 20 it is choppy and range-bound where trend systems get whipsawed. The companion +DI and -DI lines give the direction — +DI over -DI is an uptrend, the reverse a downtrend. For a cross-asset, cross-sector universe — equity indices and sectors, gold, oil, commodities, bonds and crypto — this computes each asset's 14-day ADX, +DI and -DI (Wilder's method), and classifies it as a strong uptrend, strong downtrend, developing trend or ranging. The screener endpoint returns the strong uptrends and downtrends across the board, ranked by ADX, plus the ranging list. The asset endpoint returns one market's directional-movement card. The universe endpoint lists what is covered. The cross-asset ADX / trend-strength screener cut — distinct from the bring-your-own-candle trend-indicator API and the moving-average, RSI, MACD, Bollinger and Donchian screeners. It separates the trending markets from the chop across every asset class at once.

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

## Pricing
- **Free** (Free) — 770 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 17,200 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 89,000 calls/Mo, 16 req/s
- **Business** ($78/Mo) — 484,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Cross-asset board with strong up/down trends and ranging markets ranked by ADX

**Parameters:**
- `class` (query, optional, string) — Filter by class: equities, sector, commodities, bonds, crypto Example: `sector`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/adxscreener-api/v1/screener?class=sector"
```

**Response:**
```json
{
    "data": {
        "note": "Each market's 14-day ADX, +DI and -DI (Wilder). ADX>=25 = a strong trend worth riding; <20 = ranging/choppy. direction up = +DI above -DI. Sorted by ADX (strongest trend first). ADX measures trend STRENGTH, not direction.",
        "class": "sector",
        "assets": [
            {
                "adx": 32.5,
                "key": "technology",
                "class": "sector",
                "label": "Technology",
                "regime": "strong downtrend",
                "plus_di": 21.7,
                "minus_di": 30,
                "direction": "down",
                "trend_strength": "strong"
            },
            {
                "adx": 23.4,
                "key": "utilities",
                "class": "sector",
                "label": "Utilities",
                "regime": "developing downtrend",
                "plus_di": 21,
                "minus_di": 28.9,
                "direction": "down",
                "trend_strength": "developing"
            },
            {
                "adx": 17.2,
                "key": "health_care",
                "class": "sector",
                "label": "Health Care",
                "regime": "ranging / no trend",
                "plus_di": 28.3,
                "minus_di": 16.4,
                "direction": "up",
                "trend_strength": "weak/ranging"
            },
            {
                "adx": 14.4,
                "key": "real_estate",
                "cl
…(truncated, see openapi.json for full schema)
```

### Asset

#### `GET /v1/asset` — One market ADX / directional-movement card

**Parameters:**
- `asset` (query, required, string) — Asset key (see /v1/universe) Example: `sp500`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/adxscreener-api/v1/asset?asset=sp500"
```

**Response:**
```json
{
    "data": {
        "adx": 27.4,
        "key": "sp500",
        "note": "One market's directional-movement card: 14-day ADX (trend strength), +DI and -DI (direction) and a regime label. ADX>=25 is a strong trend; <20 is ranging.",
        "class": "equities",
        "label": "S&P 500",
        "regime": "strong downtrend",
        "source": "Yahoo Finance",
        "symbol": "SPY",
        "plus_di": 16.5,
        "minus_di": 27.4,
        "direction": "down",
        "trend_strength": "strong"
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:03.283Z",
        "request_id": "21b678f4-f146-40cc-a4ec-c5b299fe1d5b"
    },
    "status": "ok",
    "message": "Asset retrieved successfully",
    "success": true
}
```

### Universe

#### `GET /v1/universe` — Supported instruments

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

**Response:**
```json
{
    "data": {
        "note": "Supported instruments. Pass key as asset= to /v1/asset, class= to /v1/screener.",
        "count": 21,
        "assets": [
            {
                "key": "sp500",
                "class": "equities",
                "label": "S&P 500",
                "symbol": "SPY"
            },
            {
                "key": "nasdaq100",
                "class": "equities",
                "label": "Nasdaq 100",
                "symbol": "QQQ"
            },
            {
                "key": "small_caps",
                "class": "equities",
                "label": "US Small Caps",
                "symbol": "IWM"
            },
            {
                "key": "developed_intl",
                "class": "equities",
                "label": "Developed ex-US",
                "symbol": "EFA"
            },
            {
                "key": "emerging",
                "class": "equities",
                "label": "Emerging Markets",
                "symbol": "EEM"
            },
            {
                "key": "technology",
                "class": "sector",
                "label": "Technology",
                "symbol": "XLK"
            },
            {
                "key": "financials",
                "class": "sector",
                "label": "Financials",
                "symbol": "XLF"
            },
            {
                "key": "energy",
                "class": "sector",
                "label": "Energy",
      
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "note": "screener class= filters by class. asset= is a supported key (see /v1/universe). ADX, +DI and -DI use Wilder's 14-period smoothing. Read fresh per call, nothing cached.",
        "source": "Yahoo Finance daily OHLC (6mo range) across a multi-asset universe, live",
        "classes": [
            "equities",
            "sector",
            "commodities",
            "bonds",
            "crypto"
        ],
        "service": "adxscreener-api",
        "settings": {
            "period": 14,
            "strong_threshold": 25,
            "ranging_threshold": 20
        },
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/asset": "One market's ADX / directional-movement card (asset=sp500).",
            "GET /v1/screener": "Cross-asset board with strong up/down trends and ranging markets, ranked by ADX (class=sector optional).",
            "GET /v1/universe": "The supported instruments."
        },
        "description": "ADX & trend-strength screener (multi-asset) — which markets are strongly trending and which are ranging, live from Yahoo Finance (no key, nothing stored). screener returns the strong uptrends and downtrends across a cross-asset board ranked by ADX, plus the ranging list. asset returns one market's directional-movement card (ADX, +DI, -DI, regime). universe lists what is covered. The cross-asset ADX / trend-strength screener cut — distinct from the bring-your-own-candle trend-indica
…(truncated, see openapi.json for full schema)
```


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