# Golden Cross / Death Cross Screener API
> Which markets just flipped trend on the most-watched signal in technical analysis — the 50-day vs 200-day moving-average cross — computed live from Yahoo Finance (no key, nothing stored). A golden cross, the 50-day average crossing up through the 200-day, is the classic confirmation of a new uptrend, and a death cross the opposite; funds and headlines move on them. For a cross-asset, cross-sector universe — equity indices and sectors, gold, oil, commodities, bonds and crypto — this computes each asset's 50- and 200-day moving averages, whether it is in a golden-cross (bullish) or death-cross (bearish) regime, how many days since the last cross, and how far price sits above or below each average. The screener endpoint returns the whole board with the markets that have crossed most recently — the fresh golden and death crosses — and the bullish/bearish tally. The asset endpoint returns one market's moving-average card. The universe endpoint lists what is covered. The moving-average-crossover / golden-cross screener cut — distinct from the bring-your-own-candle technical-indicator APIs, the market-breadth API (which aggregates the share above a single moving average) and the FX-only signals 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/goldencross-api/..."
```

## Pricing
- **Free** (Free) — 730 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 16,800 calls/Mo, 6 req/s
- **Pro** ($32/Mo) — 89,000 calls/Mo, 16 req/s
- **Business** ($74/Mo) — 482,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Cross-asset board with golden/death-cross regimes, fresh crosses and tally

**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/goldencross-api/v1/screener?class=sector"
```

**Response:**
```json
{
    "data": {
        "note": "Each market's 50- vs 200-day moving-average cross. regime golden_cross = 50-day above 200-day (bullish uptrend); death_cross = below (bearish). last_cross/days_since_cross flag the most recent flip — fresh crosses (low days) are the actionable signals. ma_gap_pct is how far the 50-day is above/below the 200-day. Assets sorted by ma_gap (strongest uptrend first).",
        "class": "sector",
        "assets": [
            {
                "key": "energy",
                "ma50": 57.8272,
                "class": "sector",
                "label": "Energy",
                "ma200": 50.6449,
                "price": 57.12,
                "trend": "bullish (50 above 200)",
                "regime": "golden_cross",
                "last_cross": null,
                "ma_gap_pct": 14.18,
                "pct_above_ma50": -1.22,
                "pct_above_ma200": 12.79,
                "days_since_cross": null
            },
            {
                "key": "technology",
                "ma50": 167.045,
                "class": "sector",
                "label": "Technology",
                "ma200": 147.8983,
                "price": 183.21,
                "trend": "bullish (50 above 200)",
                "regime": "golden_cross",
                "last_cross": "golden_cross",
                "ma_gap_pct": 12.95,
                "pct_above_ma50": 9.68,
                "pct_above_ma200": 23.88,
                "days_since_cross": 55
       
…(truncated, see openapi.json for full schema)
```

### Asset

#### `GET /v1/asset` — One market moving-average 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/goldencross-api/v1/asset?asset=sp500"
```

**Response:**
```json
{
    "data": {
        "key": "sp500",
        "ma50": 721.0712,
        "note": "One market's moving-average card: price, 50- and 200-day SMAs, the golden/death-cross regime, days since the last cross and how far price sits above each average.",
        "class": "equities",
        "label": "S&P 500",
        "ma200": 685.8166,
        "price": 737.76,
        "trend": "bullish (50 above 200)",
        "regime": "golden_cross",
        "source": "Yahoo Finance",
        "symbol": "SPY",
        "last_cross": null,
        "ma_gap_pct": 5.14,
        "pct_above_ma50": 2.31,
        "pct_above_ma200": 7.57,
        "days_since_cross": null
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:09.089Z",
        "request_id": "b745a01d-937e-46d5-b646-d63ac3ae526a"
    },
    "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/goldencross-api/v1/universe"
```

**Response:**
```json
{
    "data": {
        "note": "Supported instruments. Pass key as asset= to /v1/asset, class= to /v1/screener.",
        "count": 20,
        "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/goldencross-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "screener class= filters by class. asset= is a supported key (see /v1/universe). Moving averages are simple 50- and 200-day. Read fresh per call, nothing cached.",
        "source": "Yahoo Finance daily closes (14mo range) across a multi-asset universe, live",
        "classes": [
            "equities",
            "sector",
            "commodities",
            "bonds",
            "crypto"
        ],
        "service": "goldencross-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/asset": "One market's moving-average card (asset=sp500).",
            "GET /v1/screener": "Cross-asset board with golden/death-cross regimes, fresh crosses and bullish/bearish tally (class=sector optional).",
            "GET /v1/universe": "The supported instruments."
        },
        "description": "Golden cross / death cross screener — which markets just flipped trend on the 50- vs 200-day moving-average cross, live from Yahoo Finance (no key, nothing stored). screener returns a cross-asset board with each market's golden/death-cross regime, the freshest crosses and the bullish/bearish tally. asset returns one market's moving-average card (price, 50/200 SMA, regime, days since cross, distance). universe lists what is covered. The moving-average-crossover / golden-cross screener cut — distinct from the bring-your-own-candle technical-indicator APIs, the market-breadth API and the FX-only signals API.",
       
…(truncated, see openapi.json for full schema)
```


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