# FX Pivot Points API
> Live FX pivot points — the classic support and resistance map traders watch — as an API, computed from European Central Bank daily reference rates. For any currency pair it takes the prior completed week's or month's high, low and close and returns the central pivot P plus three resistances (R1, R2, R3) and three supports (S1, S2, S3), in both the Classic and Fibonacci methods. It also returns the current rate, whether it sits above the pivot (bullish bias) or below (bearish), and the nearest level above and below — ready-made entry, target and stop levels. Get a pair's pivots, or scan a whole basket for bias at a glance. A support/resistance layer for forex, trading and charting apps. Live, no key. Distinct from rate, strength, volatility, correlation, signal (MA/RSI), range, seasonality and drawdown APIs — this is the pivot-point S/R map.

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

## Pricing
- **Free** (Free) — 8,000 calls/Mo, 4 req/s
- **Starter** ($9/Mo) — 120,000 calls/Mo, 12 req/s
- **Pro** ($26/Mo) — 650,000 calls/Mo, 35 req/s
- **Desk** ($62/Mo) — 3,200,000 calls/Mo, 100 req/s

## Endpoints

### Pivots

#### `GET /v1/pivots` — Pivot levels (classic + fibonacci) for a pair

**Parameters:**
- `base` (query, required, string) — Base currency (ISO 4217) Example: `EUR`
- `quote` (query, required, string) — Quote currency (ISO 4217) Example: `USD`
- `period` (query, optional, string) — Prior period: weekly|monthly Example: `weekly`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fxpivots-api/v1/pivots?base=EUR&quote=USD&period=weekly"
```

**Response:**
```json
{
    "data": {
        "base": "EUR",
        "pair": "EURUSD",
        "as_of": "2026-06-08",
        "quote": "USD",
        "period": "weekly",
        "classic": {
            "r1": 1.16547,
            "r2": 1.16693,
            "r3": 1.16897,
            "s1": 1.16197,
            "s2": 1.15993,
            "s3": 1.15847,
            "pivot": 1.16343
        },
        "current": 1.154,
        "position": {
            "bias": "bearish",
            "nearest_support": null,
            "nearest_resistance": {
                "level": "S3",
                "value": 1.15847
            }
        },
        "fibonacci": {
            "r1": 1.16477,
            "r2": 1.1656,
            "r3": 1.16693,
            "s1": 1.1621,
            "s2": 1.16127,
            "s3": 1.15993,
            "pivot": 1.16343
        },
        "prior_period": {
            "to": "2026-06-05",
            "low": 1.1614,
            "from": "2026-05-27",
            "high": 1.1649,
            "close": 1.164,
            "observations": 8
        }
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:48.324Z",
        "request_id": "d5b20466-2cda-4f96-a847-b95aaf8e5018"
    },
    "status": "ok",
    "message": "Pivots retrieved successfully",
    "success": true
}
```

### Scan

#### `GET /v1/scan` — Scan a basket vs a base for pivot and bias

**Parameters:**
- `base` (query, optional, string) — Base currency (ISO 4217) Example: `USD`
- `period` (query, optional, string) — Prior period: weekly|monthly Example: `weekly`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fxpivots-api/v1/scan?base=USD&period=weekly"
```

**Response:**
```json
{
    "data": {
        "base": "USD",
        "as_of": "2026-06-08",
        "count": 7,
        "pairs": [
            {
                "r1": 0.86061,
                "s1": 0.85802,
                "bias": "bullish",
                "pair": "USDEUR",
                "pivot": 0.85953,
                "quote": "EUR",
                "current": 0.86655
            },
            {
                "r1": 160.0612,
                "s1": 159.46523,
                "bias": "bullish",
                "pair": "USDJPY",
                "pivot": 159.66389,
                "quote": "JPY",
                "current": 159.96534
            },
            {
                "r1": 0.74496,
                "s1": 0.7412,
                "bias": "bullish",
                "pair": "USDGBP",
                "pivot": 0.74361,
                "quote": "GBP",
                "current": 0.74835
            },
            {
                "r1": 1.4059,
                "s1": 1.39372,
                "bias": "bullish",
                "pair": "USDAUD",
                "pivot": 1.39919,
                "quote": "AUD",
                "current": 1.41343
            },
            {
                "r1": 1.3918,
                "s1": 1.38256,
                "bias": "bullish",
                "pair": "USDCAD",
                "pivot": 1.38612,
                "quote": "CAD",
                "current": 1.39367
            },
            {
                "r1": 0.79087,
                "s1": 0.78403,
      
…(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/fxpivots-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "as_of": "2026-06-08",
        "source": "ECB daily reference rates via Frankfurter (live)",
        "methods": [
            "classic",
            "fibonacci"
        ],
        "periods": [
            "weekly",
            "monthly"
        ],
        "service": "fxpivots-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/scan": "Scan a basket vs a base for pivot/bias (base=USD, period=).",
            "GET /v1/pivots": "A pair's pivot levels (base=EUR&quote=USD, period=weekly|monthly): classic + fibonacci, current bias."
        },
        "description": "Live FX pivot points (support/resistance) from ECB reference rates (Frankfurter): for any currency pair, the central pivot P plus R1–R3 and S1–S3 in Classic and Fibonacci methods, computed from the prior completed week's or month's high/low/close, with the current rate, its bullish/bearish bias and the nearest level above and below. Get a pair's pivots or scan a basket. Live, no key. Distinct from rate, strength, volatility, correlation, signal, range, seasonality and drawdown APIs — this is the pivot-point S/R map.",
        "scan_basket": [
            "USD",
            "EUR",
            "JPY",
            "GBP",
            "AUD",
            "CAD",
            "CHF",
            "NZD"
        ]
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:48.516Z",
        "request_id": "888ace2d-5c5a-44d4-a3f0-2362a51d086e"
    },
    "statu
…(truncated, see openapi.json for full schema)
```


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