# StockAnalysis — Zapi reference

> Kutipan saham dan ETF Amerika tanpa API key: harga, perubahan, OHLC, volume, rentang 52 minggu, dan sesi extended-hours.

**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:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/stockanalysis
- 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

---

## StockAnalysis

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

Kutipan saham dan ETF Amerika tanpa API key: harga, perubahan, OHLC, volume, rentang 52 minggu, dan sesi extended-hours.

**Tags:** stock, etf, quote, usa, finance

### Quote

Kutipan satu saham atau ETF Amerika, termasuk harga sesi after-hours kalau ada.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Ticker symbol. Required. |
| `type` | enum(stock|etf) | query | no | `stock` (default) or `etf` — they live on different upstream paths. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:stockanalysis/quote?symbol=AAPL&type=stock" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:stockanalysis/quote?symbol=AAPL&type=stock", {
  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:stockanalysis/quote?symbol=AAPL&type=stock",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "low": 310.74,
  "asOf": "Aug 7, 2026, 4:00 PM EDT",
  "high": 314.81,
  "open": 311.45,
  "type": "stock",
  "price": 313.33,
  "change": 0.92,
  "low52w": 216.58,
  "source": "stockanalysis",
  "symbol": "AAPL",
  "volume": 34562295,
  "high52w": 344.57,
  "exchange": "NASDAQ",
  "tradingDay": "2026-08-07",
  "marketStatus": "closed",
  "changePercent": 0.29,
  "extendedPrice": 313.25,
  "previousClose": 313.33,
  "extendedChange": -0.08,
  "extendedSession": "After-hours"
}
```

---


_Generated: 2026-08-08T12:08:40.397Z_