# Stock Trades & Quotes

Stock trades are available across stock plans with plan-specific delay and lookback. Stock quote endpoints require an Expert or Commercial Stocks API subscription.

## Trades

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

```bash
curl "https://api.cutemarkets.com/v1/stocks/trades/AAPL/?timestamp.gte=2026-05-06T13:30:00Z&limit=1000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Last trade

```http
GET /v1/stocks/trades/{ticker}/last/
```

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

Free and Developer stock plans receive delayed last-trade data. Expert and Commercial receive live last-trade data.

## Quotes

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

```bash
curl "https://api.cutemarkets.com/v1/stocks/quotes/AAPL/?timestamp.gte=2026-05-06T13:30:00Z&limit=1000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Last quote

```http
GET /v1/stocks/quotes/{ticker}/last/
```

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

## Quote plan requirement

Quotes and last quote require Expert or Commercial on the **Stocks API** product.

```json
{
  "status": "ERROR",
  "request_id": "cm_abc123",
  "error": {
    "code": "plan_upgrade_required",
    "message": "This endpoint requires an Expert or Commercial plan."
  }
}
```

## Pagination and limits

Trades and quotes default to `limit=1000` and clamp to `limit=10000`. Paginated responses include a signed `next_url` with a `page` cursor.
