# Forex Movers & Performance API
> What is actually moving in the currency market right now, computed live from Yahoo Finance (no key, nothing stored). Just as stock and crypto traders watch the day's biggest gainers and losers, FX traders want the pairs on the move — the ones breaking out and breaking down across the majors and crosses. For every pair this measures the change on the day, over the week and over the month, with the day's high and low and where the current rate sits in that day's range. The movers endpoint returns the whole board ranked by daily change — the top gainers and losers — plus the weekly and monthly leaders, so you can see momentum across horizons at a glance. The pair endpoint returns one pair's full performance card. The pairs endpoint lists what is covered. The FX movers / performance-dashboard cut — distinct from the currency-strength meter (which aggregates each currency's move across all its pairs into one score), the FX price, range and volatility APIs. It answers which pairs are moving today, not how strong the euro is.

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

## Pricing
- **Free** (Free) — 1,100 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 26,000 calls/Mo, 6 req/s
- **Pro** ($29/Mo) — 125,000 calls/Mo, 18 req/s
- **Business** ($69/Mo) — 620,000 calls/Mo, 45 req/s

## Endpoints

### Movers

#### `GET /v1/movers` — All pairs ranked by daily change with weekly/monthly leaders

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

### Pair

#### `GET /v1/pair` — One pair performance card

**Parameters:**
- `pair` (query, required, string) — FX pair (see /v1/pairs) Example: `EURUSD`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fxmovers-api/v1/pair?pair=EURUSD"
```

### Pairs

#### `GET /v1/pairs` — Supported FX pairs

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

### Meta

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

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


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