# Yahoo Finance



Yahoo Finance's quote cards — one instrument's price and range, its OHLCV candles at any interval, and instrument search across every exchange it carries.



## Yahoo Quote

One instrument's quote card — price, previous close, day range, volume, and the 52-week range, in its own currency.

- Method: `GET`
- Path: `/v1/market/yahoo/quote`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `symbol` | string | required | A Yahoo ticker — `BBCA.JK` for IDX stocks, `BTC-USD` for crypto, `EURUSD=X` for forex. |
| `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/yahoo/quote \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "BBCA.JK",
    "name": "Bank Central Asia Tbk",
    "exchange": "Jakarta",
    "currency": "IDR",
    "price": 6400,
    "previous_close": 6300,
    "day_high": 6400,
    "day_low": 6300,
    "volume": 67749800,
    "fifty_two_week_high": 8750,
    "fifty_two_week_low": 6175,
    "timezone": "Asia/Jakarta"
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T16:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-20T16:35:00.000Z"
  }
}
```

## Yahoo Price History

One instrument's OHLCV candles, at any range and interval the platform carries.

- Method: `GET`
- Path: `/v1/market/yahoo/history`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `symbol` | string | required | A Yahoo ticker, like `BBCA.JK`. |
| `range` | string | optional | How far back to read — `1d`, `5d`, `1mo`, `3mo`, `6mo`, `1y`, `2y`, `5y`, `10y`, `ytd`, or `max`. |
| `interval` | string | optional | Candle size — `1m`, `5m`, `15m`, `30m`, `1h`, `1d`, `1wk`, or `1mo`. |
| `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/yahoo/history \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "BBCA.JK",
    "currency": "IDR",
    "exchange": "Jakarta",
    "granularity": "1d/1mo",
    "candles": [
      {
        "timestamp": 1787097600,
        "open": 6350,
        "high": 6400,
        "low": 6300,
        "close": 6400,
        "volume": 67749800
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T16:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-20T16:35:00.000Z"
  }
}
```

## Yahoo Search

Find instruments by name or ticker — symbol, name, exchange, and type on every hit.

- Method: `GET`
- Path: `/v1/market/yahoo/search`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | required | What to search instruments by. |
| `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/yahoo/search \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "query": "Bank Central Asia",
    "items": [
      {
        "symbol": "BBCA.JK",
        "name": "Bank Central Asia Tbk",
        "exchange": "Jakarta",
        "type": "EQUITY"
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T16:30:00.000Z",
    "age_seconds": 30,
    "next_update_at": "2026-08-20T16:35:00.000Z"
  }
}
```