# Market Benchmarks



The numbers every market page quotes — volatility, the US headline indices, and the dollar.



## CBOE Volatility Index (VIX)

The market's fear gauge — implied volatility on the S&P 500, the number every risk-off headline quotes.

- Method: `GET`
- Path: `/v1/market/benchmarks/vix`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/benchmarks/vix \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "TVC:VIX",
    "name": "VOLATILITY S&P 500",
    "exchange": "TVC",
    "type": "index",
    "currency": null,
    "close": 15.34,
    "change": -0.68,
    "change_percent": -4.24,
    "open": 16.02,
    "high": 16.1,
    "low": 15.2,
    "volume": null,
    "market_cap": null,
    "pe_ratio": null,
    "eps": null,
    "sector": null,
    "description": null,
    "logo": null
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-21T13:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-21T13:35:00.000Z"
  }
}
```

## S&P 500 Index

The US large-cap benchmark — the level every portfolio on earth is measured against.

- Method: `GET`
- Path: `/v1/market/benchmarks/spx`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/benchmarks/spx \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "SP:SPX",
    "name": "S&P 500",
    "exchange": "SP",
    "type": "index",
    "currency": null,
    "close": 7671.56,
    "change": 30.44,
    "change_percent": 0.4,
    "open": 7641.12,
    "high": 7680.2,
    "low": 7635.9,
    "volume": null,
    "market_cap": null,
    "pe_ratio": null,
    "eps": null,
    "sector": null,
    "description": null,
    "logo": null
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-21T13:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-21T13:35:00.000Z"
  }
}
```

## Nasdaq-100 Index

The Nasdaq-100 — the technology-heavy benchmark of the hundred largest non-financials on the exchange.

- Method: `GET`
- Path: `/v1/market/benchmarks/ndx`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/benchmarks/ndx \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "NASDAQ:NDX",
    "name": "Nasdaq 100 Index",
    "exchange": "NASDAQ",
    "type": "index",
    "currency": null,
    "close": 29242.64,
    "change": 29.48,
    "change_percent": 0.1,
    "open": 29213.16,
    "high": 29301.5,
    "low": 29190.02,
    "volume": null,
    "market_cap": null,
    "pe_ratio": null,
    "eps": null,
    "sector": null,
    "description": null,
    "logo": null
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-21T13:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-21T13:35:00.000Z"
  }
}
```

## US Dollar Index (DXY)

The dollar against the basket — the level every commodity, EM currency, and risk asset is priced against.

- Method: `GET`
- Path: `/v1/market/benchmarks/dxy`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/benchmarks/dxy \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "TVC:DXY",
    "name": "U.S. Dollar Currency Index",
    "exchange": "TVC",
    "type": "index",
    "currency": null,
    "close": 98.87,
    "change": 0.03,
    "change_percent": 0.03,
    "open": 98.84,
    "high": 99.1,
    "low": 98.7,
    "volume": null,
    "market_cap": null,
    "pe_ratio": null,
    "eps": null,
    "sector": null,
    "description": null,
    "logo": null
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-21T13:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-21T13:35:00.000Z"
  }
}
```