# US Stock Market Movers API
> Live US market movers from Nasdaq — no key, nothing stored. The "what's moving today" view of the US stock market: the day's biggest gainers, biggest losers and most-active names across stocks, ETFs and mutual funds, distinct from the index-constituent, single-quote and crypto-movers APIs in the catalogue. The gainers endpoint returns the top advancing names with their last price, price change and percent change. The losers endpoint returns the top declining names. The active endpoint returns the most-active names by share volume — or by dollar volume — with their last price and price change. Each endpoint takes an asset class: stocks (default), etf or funds. Build market-dashboard tickers, daily-mover newsletters, momentum scanners and trading-idea bots on top of real Nasdaq market-movers data. Data updates through the US trading day and is static outside market hours; prices and percentages are returned as clean numbers.

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

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 175,000 calls/Mo, 10 req/s
- **Pro** ($26/Mo) — 800,000 calls/Mo, 28 req/s
- **Scale** ($57/Mo) — 2,900,000 calls/Mo, 60 req/s

## Endpoints

### Gainers

#### `GET /v1/gainers` — Top advancing names

**Parameters:**
- `asset` (query, optional, string) — Asset class: stocks, etf, funds (default stocks) Example: `stocks`

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

### Losers

#### `GET /v1/losers` — Top declining names

**Parameters:**
- `asset` (query, optional, string) — Asset class: stocks, etf, funds (default stocks) Example: `stocks`

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

### Active

#### `GET /v1/active` — Most-active names

**Parameters:**
- `asset` (query, optional, string) — Asset class: stocks, etf (default stocks) Example: `stocks`
- `by` (query, optional, string) — volume or dollar (default volume) Example: `volume`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/stockmovers-api/v1/active?asset=stocks&by=volume"
```

### Meta

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

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


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