# Stock Snapshots

Stock snapshot endpoints provide market-state views for all stocks, one ticker, or directional movers.

## Full market snapshot

```http
GET /v1/stocks/snapshot/
```

```bash
curl "https://api.cutemarkets.com/v1/stocks/snapshot/" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Common query parameters include `include_otc`, `ticker.any_of`, and `limit` where supported by the endpoint.

## Ticker snapshot

```http
GET /v1/stocks/snapshot/{ticker}/
```

```bash
curl "https://api.cutemarkets.com/v1/stocks/snapshot/AAPL/" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

The response is a single snapshot object in the standard CuteMarkets envelope.

## Movers

```http
GET /v1/stocks/snapshot/movers/{direction}/
```

`direction` is `gainers` or `losers`.

```bash
curl "https://api.cutemarkets.com/v1/stocks/snapshot/movers/gainers/?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Plan behavior

Free and Developer stock subscriptions receive delayed snapshot data. Expert and Commercial stock subscriptions receive live stock data.