# Stooq — Zapi reference

> Stooq — single-symbol quote off the HTML quote page.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/stooq
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Stooq

**Category:** finance · **Slug:** `stooq`
**Detail page:** https://zpi.web.id/api/finance/stooq

Stooq — single-symbol quote off the HTML quote page.

**Tags:** finance, stooq

### Quote

Stooq — single-symbol quote off the HTML quote page.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:stooq/quote`
- **Cache TTL:** 30s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Stooq symbol. FX/metals `xauusd`, crypto `btcusd`, US equity `aapl.us`, commodity `cl.f` |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:stooq/quote?symbol=xauusd" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:stooq/quote?symbol=xauusd", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:stooq/quote?symbol=xauusd",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ask": 4528.66,
  "bid": 4528.11,
  "low": 4509.89,
  "date": "2026-08-21",
  "high": 4542.47,
  "last": 4528.39,
  "name": "Gold (ozt) / U.S. Dollar",
  "open": 4518.26,
  "time": "04:26:24",
  "change": 9.01,
  "symbol": "xauusd",
  "volume": null,
  "askSize": null,
  "bidSize": null,
  "provider": "stooq",
  "turnover": null,
  "tradeCount": null,
  "openInterest": null,
  "changePercent": 0.2,
  "previousClose": 4519.38
}
```

---

### History

Stooq — daily OHLC history off the HTML history page.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:stooq/history`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Stooq symbol. FX/metals `xauusd`, crypto `btcusd`, US equity `aapl.us`, commodity `cl.f` |
| `page` | number | query | no | Page of 40 daily rows, newest first. Default 1 |
| `from` | string | query | no | Oldest date to include, YYYY-MM-DD |
| `to` | string | query | no | Newest date to include, YYYY-MM-DD |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:stooq/history?symbol=xauusd&page=1&from=2024-01-01&to=2024-01-31" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:stooq/history?symbol=xauusd&page=1&from=2024-01-01&to=2024-01-31", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:stooq/history?symbol=xauusd&page=1&from=2024-01-01&to=2024-01-31",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": null,
  "name": "Gold (ozt) / U.S. Dollar",
  "page": 1,
  "count": 40,
  "items": [
    {
      "low": 4450.995,
      "date": "2026-08-20",
      "high": 4540.275,
      "open": 4522.985,
      "close": 4519.375,
      "change": -3.66,
      "volume": null,
      "changePercent": -0.08
    },
    {
      "low": 4325.405,
      "date": "2026-08-19",
      "high": 4524.295,
      "open": 4336.765,
      "close": 4523.035,
      "change": 188.73,
      "volume": null,
      "changePercent": 4.35
    },
    {
      "low": 4329.385,
      "date": "2026-08-18",
      "high": 4435.785,
      "open": 4417.835,
      "close": 4334.305,
      "change": -82.41,
      "volume": null,
      "changePercent": -1.87
    },
    {
      "low": 4367.485,
      "date": "2026-08-17",
      "high": 4428.865,
      "open": 4376.385,
      "close": 4416.715,
      "change": 40.45,
      "volume": null,
      "changePercent": 0.92
    },
    {
      "low": 4311.095,
      "date": "2026-08-14",
      "high": 4396.845,
      "open": 4354.125,
      "close": 4376.265,
      "change": 25.09,
      "volume": null,
      "changePercent": 0.58
    },
    {
      "low": 4344.735,
      "date": "2026-08-13",
      "high": 4449.085,
      "open": 4410.705,
      "close": 4351.175,
      "change": -57.42,
      "volume": null,
      "changePercent": -1.3
    },
    {
      "low": 4362.655,
      "date": "2026-08-12",
      "high": 4440.155,
      "open": 4372.515,
      "close": 4408.595,
      "change": 40.46,
      "volume": null,
      "changePercent": 0.93
    },
    {
      "low": 4356.965,
      "date": "2026-08-11",
      "high": 4435.135,
      "open": 4389.525,
      "close": 4368.135,
      "change": -22.23,
      "volume": null,
      "changePercent": -0.51
    }
  ],
  "total": 15315,
  "symbol": "xauusd",
  "hasMore": true,
  "nextPage": 2,
  "provider": "stooq"
}
```

---


_Generated: 2026-08-21T07:41:30.576Z_