# Investing — Zapi reference

> Data pasar finansial lengkap — quote saham/forex/crypto/komoditas, teknikal, OHLCV historis, berita, analisis, dan kalender ekonomi.

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

**Related:**
- Detail page: https://zapi.ink/api/finance/investing
- Endpoint catalog: https://zapi.ink/category/finance
- Concise index: https://zapi.ink/llms.txt
- Full reference: https://zapi.ink/llms-full.txt

---

## Investing

**Category:** finance · **Slug:** `investing`
**Detail page:** https://zapi.ink/api/finance/investing

Data pasar finansial lengkap — quote saham/forex/crypto/komoditas, teknikal, OHLCV historis, berita, analisis, dan kalender ekonomi.

**Tags:** finance, stocks, forex, crypto, market, quotes, economic-calendar

### Search

Cari instrumen (saham/forex/crypto/komoditas) + berita.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/search`
- **Cache TTL:** 120s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Kata kunci pencarian instrumen/berita |
| `type` | enum(all|quotes|news|articles) | query | no | Bagian hasil yang dikembalikan (default all) |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/search?q=apple&type=all" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/search?q=apple&type=all", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/search?q=apple&type=all",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "news": [
    {
      "id": 4741015,
      "url": "https://www.investing.com/news/stock-market-news/exclusivetatas-iphone-parts-factory-contaminated-farmland-water-india-pollution-body-alleges-4741015",
      "image": "https://i-invdn-com.investing.com/trkd-images/LYNXMPEM5C08U_L.jpg",
      "title": "Exclusive-Tata’s iPhone parts factory contaminated farmland water, India pollution body alleges"
    },
    {
      "id": 4741023,
      "url": "https://www.investing.com/news/stock-market-news/mag-7-mangos-spacex-forces-name-rethink-on-wall-streets-techstock-moniker-4741023",
      "image": "https://i-invdn-com.investing.com/trkd-images/LYNXMPEM5C09W_L.jpg",
      "title": "Mag 7? MANGOS? SpaceX forces name rethink on Wall Street’s tech-stock moniker"
    },
    {
      "id": 4739346,
      "url": "https://www.investing.com/news/economy-news/hedge-funds-sold-broader-tech-ahead-of-spacex-ipo-jpmorgan-data-shows-4739346",
      "image": "https://i-invdn-com.investing.com/trkd-images/LYNXMPEM5B0QU_L.jpg",
      "title": "Hedge funds sold broader tech ahead of SpaceX IPO, JPMorgan data shows"
    },
    {
      "id": 4739803,
      "url": "https://www.investing.com/news/company-news/healthcare-triangle-closes-36m-convertible-note-offering-93CH-4739803",
      "image": "https://i-invdn-com.investing.com/news/LYNXNPEB6R0AQ_S.jpg",
      "title": "Healthcare Triangle closes $3.6M convertible note offering"
    },
    {
      "id": 4741019,
      "url": "https://www.investing.com/news/company-news/tata-iphone-parts-plant-warned-over-wastewater-pollution--reuters-4741019",
      "image": "https://i-invdn-com.investing.com/news/moved_small-LYNXMPEK8O0ML_L.jpg",
      "title": "Tata iPhone parts plant warned over wastewater pollution - Reuters"
    }
  ],
  "query": "apple",
  "quotes": [
    {
      "url": "https://www.investing.com/equities/apple-computer-inc",
      "name": "Apple Inc",
      "type": "Stock - NASDAQ",
      "pairId": 6408,
      "symbol": "AAPL",
      "country": "USA",
      "exchange": "NASDAQ"
    },
    {
      "url": "https://www.investing.com/crypto/bunny/apple-usd",
      "name": "dog with apple in mouth US Dollar",
      "type": "FX - XT.COM",
      "pairId": 1225435,
      "symbol": "APPLE/USD",
      "country": "dog_with_apple_in_mouth",
      "exchange": "XT.COM"
    },
    {
      "url": "https://www.investing.com/equities/apple-computer-inc?cid=986251",
      "name": "Apple Inc",
      "type": "Stock - Switzerland",
      "pairId": 986251,
      "symbol": "AAPLUSD",
      "country": "Switzerland",
      "exchange": "Switzerland"
    },
    {
      "url": "https://www.investing.com/equities/apple-computer-inc?cid=963008",
      "name": "Apple Inc",
      "type": "Stock - Xetra",
      "pairId": 963008,
      "symbol": "AAPL",
      "country": "Germany",
      "exchange": "Xetra"
    },
    {
      "url": "https://www.investing.com/equities/apple-computer-inc?cid=993325",
      "name": "Apple Inc",
      "type": "Stock - Switzerland",
      "pairId": 993325,
      "symbol": "AAPL",
      "country": "Switzerland",
      "exchange": "Switzerland"
    },
    {
      "url": "https://www.investing.com/equities/apple-computer-inc?cid=1202722",
      "name": "Apple Inc",
      "type": "Stock - London",
      "pairId": 1202722,
      "symbol": "0R2V",
      "country": "UK",
      "exchange": "London"
    },
    {
      "url": "https://www.investing.com/equities/apple-hospitality-reit-inc",
      "name": "Apple Hospitality REIT Inc",
      "type": "Stock - NYSE",
      "pairId": 959642,
      "symbol": "APLE",
      "country": "USA",
      "exchange": "NYSE"
    },
    {
      "url": "https://www.investing.com/etfs/aapy",
      "name": "Kurv Yield Premium Strategy Apple ETF",
      "type": "ETF - NYSE",
      "pairId": 1215129,
      "symbol": "AAPY",
      "country": "USA",
      "exchange": "NYSE"
    }
  ],
  "articles": [
    {
      "id": 200182160,
      "url": "https://www.investing.com/analysis/aapl-(apr-11)-200182160",
      "title": "Apple Consolidates"
    },
    {
      "id": 200282090,
      "url": "https://www.investing.com/analysis/apple-confusion-200282090",
      "title": "Apple Confusion"
    },
    {
      "id": 200412540,
      "url": "https://www.investing.com/analysis/adams-apple-200412540",
      "title": "Adam’s Apple"
    },
    {
      "id": 200367514,
      "url": "https://www.investing.com/analysis/apple-technicals-200367514",
      "title": "Apple Technicals"
    },
    {
      "id": 260813,
      "url": "https://www.investing.com/analysis/rotten-apple-260813",
      "title": "Rotten Apple?"
    }
  ]
}
```

---

### Quote

Quote real-time instrumen (harga, perubahan, range, PE, EPS, dividen).

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/quote`
- **Cache TTL:** 30s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Simbol atau nama instrumen (saham, index, crypto, forex, komoditas). Contoh: AAPL, bitcoin, EUR/USD |
| `pairId` | number | query | no | Pair ID internal langsung (override pencarian). Kalau diisi, parameter `query` tidak dipakai untuk resolve. |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/quote?query=AAPL&pairId=6408" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/quote?query=AAPL&pairId=6408", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/quote?query=AAPL&pairId=6408",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "eps": 8.2491,
  "low": 289.62,
  "url": "https://www.investing.com/equities/apple-computer-inc",
  "beta": 1.06,
  "high": 297.14,
  "last": 291.13,
  "name": "Apple Inc",
  "open": 296.03,
  "type": "Stock - NASDAQ",
  "change": -4.5,
  "pairId": 6408,
  "symbol": "AAPL",
  "volume": 38784789,
  "peRatio": 35.22,
  "revenue": "451.44B",
  "dayRange": "289.62 - 297.14",
  "dividend": 1.08,
  "exchange": "NASDAQ",
  "provider": "investing",
  "avgVolume": 46507492,
  "marketCap": "4.28T",
  "week52Low": 195.07,
  "week52High": 317.4,
  "week52Range": "195.07 - 317.4",
  "changePercent": -1.52,
  "extendedHours": "After",
  "extendedPrice": 291.58,
  "lastTimestamp": 1781294399,
  "oneYearReturn": "48.2%",
  "previousClose": 295.63,
  "exchangeIsOpen": false,
  "extendedChange": 0.45,
  "nextEarningsDate": "2026-07-30",
  "technicalSummary": "Strong Sell",
  "dividendYieldPercent": 0.37
}
```

---

### Technical

Ringkasan analisis teknikal (MA, oscillator, pivot) per timeframe.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/technical`
- **Cache TTL:** 120s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Symbol / company name to resolve (stock, index, crypto, forex, commodity). |
| `pairId` | number | query | no | Optional numeric pair id override. Skips symbol resolution when provided. |
| `timeframe` | enum(5m|15m|1h|1d) | query | no | Analysis timeframe. One of: 5m, 15m, 1h, 1d. |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/technical?query=AAPL&pairId=6408&timeframe=1d" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/technical?query=AAPL&pairId=6408&timeframe=1d", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/technical?query=AAPL&pairId=6408&timeframe=1d",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "name": "Apple Inc",
  "pairId": 6408,
  "symbol": "AAPL",
  "summary": "SELL",
  "timeframe": "1d",
  "updatedAt": 1781294702,
  "indicators": [
    {
      "name": "RSI(14)",
      "value": 44.049,
      "action": "Sell"
    },
    {
      "name": "STOCH(9,6)",
      "value": 29.697,
      "action": "Sell"
    },
    {
      "name": "STOCHRSI(14)",
      "value": 3.783,
      "action": "Oversold"
    },
    {
      "name": "MACD(12,26)",
      "value": 2.68,
      "action": "Buy"
    },
    {
      "name": "ATR(14)",
      "value": 7.5725,
      "action": "High Volatility"
    },
    {
      "name": "ADX(14)",
      "value": 39.584,
      "action": "Sell"
    },
    {
      "name": "CCI(14)",
      "value": -138.3806,
      "action": "Sell"
    },
    {
      "name": "Highs/Lows(14)",
      "value": -10.8686,
      "action": "Sell"
    }
  ],
  "oscillators": {
    "buy": 1,
    "sell": 8,
    "signal": "red",
    "neutral": 2,
    "summary": "Strong Sell"
  },
  "pivotPoints": [
    {
      "level": "R3",
      "classic": 305.96,
      "fibonacci": 301.48
    },
    {
      "level": "R2",
      "classic": 301.48,
      "fibonacci": 298.65
    },
    {
      "level": "R1",
      "classic": 298.55,
      "fibonacci": 296.9
    },
    {
      "level": "Pivot Point",
      "classic": 294.07,
      "fibonacci": 294.07
    },
    {
      "level": "S1",
      "classic": 291.14,
      "fibonacci": 291.24
    },
    {
      "level": "S2",
      "classic": 286.66,
      "fibonacci": 289.49
    },
    {
      "level": "S3",
      "classic": 283.73,
      "fibonacci": 286.66
    }
  ],
  "summaryText": "Sell",
  "movingAverages": {
    "buy": 6,
    "sell": 6,
    "signal": "black",
    "summary": "Neutral"
  },
  "movingAverageDetails": [
    {
      "name": "MA5",
      "simple": 294.09,
      "exponential": 295.69,
      "simpleAction": "Sell",
      "exponentialAction": "Sell"
    },
    {
      "name": "MA10",
      "simple": 302.08,
      "exponential": 299.05,
      "simpleAction": "Sell",
      "exponentialAction": "Sell"
    },
    {
      "name": "MA20",
      "simple": 303.88,
      "exponential": 298.84,
      "simpleAction": "Sell",
      "exponentialAction": "Sell"
    },
    {
      "name": "MA50",
      "simple": 285.49,
      "exponential": 289.41,
      "simpleAction": "Buy",
      "exponentialAction": "Buy"
    },
    {
      "name": "MA100",
      "simple": 272.84,
      "exponential": 278.98,
      "simpleAction": "Buy",
      "exponentialAction": "Buy"
    },
    {
      "name": "MA200",
      "simple": 266.87,
      "exponential": 266.44,
      "simpleAction": "Buy",
      "exponentialAction": "Buy"
    }
  ]
}
```

---

### Historical

Data OHLCV historis (interval & periode fleksibel).

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/historical`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Symbol or name of the instrument to resolve (stock ticker, index, commodity, FX pair, crypto). Resolved to an internal id. |
| `pairId` | number | query | no | Optional internal instrument id override. When provided, symbol resolution is skipped. |
| `interval` | enum(1m|5m|15m|30m|1h|5h|1d|1w|1mo) | query | no | Candle interval: 1m, 5m, 15m, 30m, 1h, 5h (intraday) or 1d, 1w, 1mo. Default 1d |
| `period` | enum(1d|1w|1mo|3mo|6mo|1y|5y|max) | query | no | Lookback range: 1d, 1w, 1mo, 3mo, 6mo, 1y, 5y, max. Default 1mo. The upstream re-aggregates rather than honouring the interval literally — 1y returns ~53 daily rows, 5y ~261. Use max for full-depth candles. Any single call returns at most 5000 rows. |
| `pointscount` | number | query | no | Candle density the upstream is asked for. Only 60, 70, 90, 110, 120, 140 and 160 are accepted. Default 120. It is not a row cap — the cap is 5000 rows per call and is driven by period |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/historical?query=AAPL&pairId=6408&interval=1d&period=1mo&pointscount=120" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/historical?query=AAPL&pairId=6408&interval=1d&period=1mo&pointscount=120", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/historical?query=AAPL&pairId=6408&interval=1d&period=1mo&pointscount=120",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 22,
  "pairId": 6408,
  "period": "1mo",
  "symbol": "AAPL",
  "candles": [
    {
      "low": 293.5,
      "date": "2026-05-13T00:00:00.000Z",
      "high": 300.92,
      "open": 293.5,
      "close": 298.87,
      "volume": 52684260,
      "timestamp": 1778630400000
    },
    {
      "low": 295.38,
      "date": "2026-05-14T00:00:00.000Z",
      "high": 300.45,
      "open": 299.82,
      "close": 298.21,
      "volume": 35324920,
      "timestamp": 1778716800000
    },
    {
      "low": 296.52,
      "date": "2026-05-15T00:00:00.000Z",
      "high": 303.2,
      "open": 297.9,
      "close": 300.23,
      "volume": 54862836,
      "timestamp": 1778803200000
    },
    {
      "low": 294.91,
      "date": "2026-05-18T00:00:00.000Z",
      "high": 300.66,
      "open": 300.24,
      "close": 297.84,
      "volume": 34482960,
      "timestamp": 1779062400000
    },
    {
      "low": 296.35,
      "date": "2026-05-19T00:00:00.000Z",
      "high": 300.51,
      "open": 296.97,
      "close": 298.97,
      "volume": 42243560,
      "timestamp": 1779148800000
    },
    {
      "low": 298.08,
      "date": "2026-05-20T00:00:00.000Z",
      "high": 302.8,
      "open": 298.18,
      "close": 302.25,
      "volume": 38229844,
      "timestamp": 1779235200000
    },
    {
      "low": 300.4,
      "date": "2026-05-21T00:00:00.000Z",
      "high": 305.54,
      "open": 301.05,
      "close": 304.99,
      "volume": 42965128,
      "timestamp": 1779321600000
    },
    {
      "low": 305.84,
      "date": "2026-05-22T00:00:00.000Z",
      "high": 311.4,
      "open": 306.12,
      "close": 308.82,
      "volume": 43670224,
      "timestamp": 1779408000000
    }
  ],
  "interval": "1d"
}
```

---

### News

Berita pasar terbaru / per-instrumen.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/news`
- **Cache TTL:** 180s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Simbol/kata kunci instrumen. Kosongkan untuk berita terbaru umum. |
| `page` | number | query | no | Nomor halaman (default 1) |
| `category` | string | query | no | Filter kategori berita (opsional, hanya untuk feed umum) |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/news?query=apple&page=1&category=economy" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/news?query=apple&page=1&category=economy", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/news?query=apple&page=1&category=economy",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 20,
  "items": [
    {
      "id": 4741066,
      "url": "https://www.investing.com/news/economy-news/uk-intercepts-russian-oil-tanker-linked-to-shadow-fleet-in-english-channel-4741066",
      "image": "https://i-invdn-com.investing.com/news/Shipping_800x533_L_1618572654.jpg",
      "title": "UK intercepts Russian oil tanker linked to shadow fleet in English Channel",
      "source": "Investing.com",
      "excerpt": "Investing.com -- British forces intercepted a Russian shadow fleet oil tanker attempting to transit the English Channel on Sunday,...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T07:05:22.000Z"
    },
    {
      "id": 4741065,
      "url": "https://www.investing.com/news/economy-news/starmer-takaichi-to-discuss-fighter-jet-project-as-uk-funding-questions-persist-4741065",
      "image": "https://i-invdn-com.investing.com/news/moved_LYNXMPEK8O0VV_L.jpg",
      "title": "Starmer, Takaichi to discuss fighter jet project as UK funding questions persist",
      "source": "Investing.com",
      "excerpt": "Investing.com -- British Prime Minister Keir Starmer is set to meet Japanese Prime Minister Sanae Takaichi on Sunday as...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T06:33:08.000Z"
    },
    {
      "id": 4741064,
      "url": "https://www.investing.com/news/economy-news/south-korea-household-loans-surge-as-investors-pile-into-stocks-4741064",
      "image": "https://i-invdn-com.investing.com/news/SouthKorea_800x533_L_1606575512.jpg",
      "title": "South Korea household loans surge as investors pile into stocks",
      "source": "Investing.com",
      "excerpt": "Investing.com -- Citi said a sharp rally in South Korean equities is contributing to rising financial stability risks as household...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T05:59:41.000Z"
    },
    {
      "id": 4741063,
      "url": "https://www.investing.com/news/economy-news/rubio-defends-hormuz-blockade-after-india-protests-deaths-of-sailors-4741063",
      "image": "https://i-invdn-com.investing.com/news/moved_LYNXNPEL3912L_L.jpg",
      "title": "Rubio defends Hormuz blockade after India protests deaths of sailors",
      "source": "Investing.com",
      "excerpt": "Investing.com -- U.S. Secretary of State Marco Rubio defended Washington’s actions in the Strait of Hormuz after India protested...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T05:33:40.000Z"
    },
    {
      "id": 4741062,
      "url": "https://www.investing.com/news/economy-news/japan-moves-to-secure-rare-earth-supplies-with-greenland-visit--nikkei-4741062",
      "image": "https://i-invdn-com.investing.com/news/LYNXMPEB430M1_L.jpg",
      "title": "Japan moves to secure rare earth supplies with Greenland visit - Nikkei",
      "source": "Investing.com",
      "excerpt": "Investing.com -- Japan is preparing to send a delegation to Greenland this summer to evaluate possible rare earth extraction,...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T05:06:10.000Z"
    },
    {
      "id": 4741061,
      "url": "https://www.investing.com/news/economy-news/trump-says-iran-deal-could-be-signed-sunday-tehran-disputes-timing-4741061",
      "image": "https://i-invdn-com.investing.com/news/moved_LYNXMPEM3J0V1_1200_L.jpg",
      "title": "Trump says Iran deal could be signed Sunday, Tehran disputes timing",
      "source": "Investing.com",
      "excerpt": "Investing.com -- U.S. President Donald Trump said an agreement with Iran to halt the war could be signed as early as Sunday,...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T04:10:00.000Z"
    },
    {
      "id": 4741057,
      "url": "https://www.investing.com/news/economy-news/dollar-likely-to-find-support-as-long-as-strait-remains-mostly-closed-4741057",
      "image": "https://i-invdn-com.investing.com/news/LYNXNPEB960O0_L.jpg",
      "title": "Dollar likely to find support as long as Strait remains mostly closed",
      "source": "Investing.com",
      "excerpt": "Investing.com -- The U.S. dollar is likely to remain supported in the near term despite a recent pullback in oil prices, according...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T03:01:52.000Z"
    },
    {
      "id": 4741050,
      "url": "https://www.investing.com/news/economy-news/uk-japan-to-deepen-ties-with-18-billion-investment-agreement-4741050",
      "image": "https://i-invdn-com.investing.com/news/LYNXNPEC501G5_L.jpg",
      "title": "UK, Japan to deepen ties with £18 billion investment agreement",
      "source": "Investing.com",
      "excerpt": "Investing.com -- The UK and Japan are expected to sign an £18 billion ($24.1 billion) investment agreement focused on clean...",
      "category": "ECONOMY",
      "publishedAt": "2026-06-14T00:06:36.000Z"
    }
  ],
  "hasMore": true,
  "nextPage": 2
}
```

---

### Article

Isi artikel berita lengkap (input id dari news).

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/article`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | unknown | query | no | ID artikel berita. Wajib jika `url` kosong. |
| `url` | string | query | no | URL artikel penuh (alternatif `id`). |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/article?id=4741065&url=https%3A%2F%2Fwww.investing.com%2Fnews%2Feconomy-news%2Fsome-article-4741065" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/article?id=4741065&url=https%3A%2F%2Fwww.investing.com%2Fnews%2Feconomy-news%2Fsome-article-4741065", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/article?id=4741065&url=https%3A%2F%2Fwww.investing.com%2Fnews%2Feconomy-news%2Fsome-article-4741065",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": 4741066,
  "url": "https://www.investing.com/news/economy-news/uk-intercepts-russian-oil-tanker-linked-to-shadow-fleet-in-english-channel-4741066",
  "image": "https://i-invdn-com.investing.com/news/Shipping_800x533_L_1618572654.jpg",
  "title": "UK intercepts Russian oil tanker linked to shadow fleet in English Channel",
  "author": "Simon Mugo",
  "source": "Investing.com",
  "authorUrl": "https://www.investing.com/members/contributors/277000282",
  "updatedAt": "2026-06-14T07:05:22Z",
  "relatedIds": [
    8833
  ],
  "contentText": "Investing.com -- British forces intercepted a Russian shadow fleet oil tanker attempting to transit the English Channel on Sunday, according to a statement from the UK Ministry of Defence.\n\nTrack geopolitical developments and energy markets with InvestingPro\n\nThe vessel, identified as the SMYRTOS, was boarded by Royal Marine Commandos and specially trained officers from the National Crime Agency.\n\nBritish authorities said the tanker has been detained and will remain under monitoring off the country’s southern coast while investigations continue.\n\nThe Ministry of Defence said the enforcement action was carried out within British territorial waters and in accordance with domestic and international law.\n\nNo details were immediately provided about the vessel’s cargo, destination, or ownership.\n\nThe interception marks the latest effort by Western governments to crack down on Russia’s so-called shadow fleet, a network of tankers used to transport Russian oil outside the scope of Western sanctions and price cap measures.\n\nThe fleet has become an increasing focus of sanctions enforcement since the start of the war in Ukraine, with European governments stepping up scrutiny of shipping activity in key maritime routes.\n\nBritish Prime Minister Keir Starmer said he personally authorized the operation.\n\n\"This successful operation delivers yet another blow to Russia and reminds those fueling Putin’s war in Ukraine that we will not let them hide,\" Starmer said in a post on X.\n\nThe English Channel is one of the world’s busiest shipping lanes and a critical route for energy and commercial trade between Europe and global markets.\n\nThe incident comes as Western nations continue to tighten enforcement measures aimed at restricting Russia’s ability to generate revenue from oil exports while maintaining support for Ukraine.",
  "publishedAt": "2026-06-14T07:05:22Z"
}
```

---

### Analysis

Artikel analisis/opini per instrumen.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/analysis`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | yes | Simbol/nama instrumen (mis. AAPL, Tesla) |
| `pairId` | number | query | no | Override pair ID internal (lewati resolusi simbol) |
| `page` | number | query | no | Nomor halaman (default 1) |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/analysis?query=AAPL&pairId=1&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/analysis?query=AAPL&pairId=1&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/analysis?query=AAPL&pairId=1&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 10,
  "items": [
    {
      "url": "http://www.investing.com/analysis/spacex-guide-everything-you-need-to-know-about-the-biggest-ipo-in-history-200682043",
      "image": "https://d1-invdn-com.investing.com/company_logo/85038e5c6dc77e60512aa6c2ea4bd961.jpg",
      "title": "SpaceX Guide: Everything You Need to Know About the Biggest IPO in History",
      "author": "Thomas Monteiro",
      "excerpt": "SpaceX begins trading on Nasdaq today under the ticker SPCX, targeting a valuation of approximately $1.75 trillion and seeking to...",
      "articleId": 200682043,
      "publishedAt": "2026-06-12T18:02:17.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/week-ahead-central-bank-decisions-us-retail-sales-and-japan-inflation-in-focus-200682072",
      "image": "https://d1-invdn-com.investing.com/company_logo/202cdce0d0cd64f29fca913a2c714f3a.jpg",
      "title": "Week Ahead: Central Bank Decisions, US Retail Sales, and Japan Inflation in Focus",
      "author": "Ryan Anderson",
      "excerpt": "\nMON: G7 Summit (15-17 Jun), German Wholesale Prices (May), Indian WPI (May), EZ Industrial Production (Apr), US Industrial...",
      "articleId": 200682072,
      "publishedAt": "2026-06-12T14:57:49.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/the-largest-public-offering-in-history-spacex-ipo-comes-with-a-stratospheric-risk-200681913",
      "image": "https://d1-invdn-com.investing.com/company_logo/54f1b84dfaaf7a6d5075200b13f21246.jpg",
      "title": "The Largest Public Offering in History: SpaceX IPO Comes With a Stratospheric Risk",
      "author": "Arturo Gómez Gutiérrez",
      "excerpt": "When Saudi Aramco listed on the Tadawul exchange in December 2019, it set a benchmark that the financial world assumed would stand...",
      "articleId": 200681913,
      "publishedAt": "2026-06-10T18:36:50.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/apples-siri-ai-was-finally-announced--so-why-is-the-stock-tanking-200681818",
      "image": "https://d1-invdn-com.investing.com/company_logo/2ca976c96d700a6557ba4064971fc3ca.jpg",
      "title": "Apple’s Siri AI Was Finally Announced - So Why Is the Stock Tanking?",
      "author": "Sam Quirke ",
      "excerpt": "Apple Inc (NASDAQ:AAPL) started the week with an almost-perfect setup. Multiple quarters of solid results, a market that’s been...",
      "articleId": 200681818,
      "publishedAt": "2026-06-09T15:56:23.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/apple-intelligence-monetization-is-the-real-wwdc-story-200681775",
      "image": "https://d1-invdn-com.investing.com/company_logo/e65d0784b05fbedf064b2abd0dc70a29.jpg",
      "title": "Apple Intelligence Monetization Is the Real WWDC Story",
      "author": "Opeyemi Babalola",
      "excerpt": "Apple’s Siri AI launch signals a new iCloud+ revenue push, but a vague launch timeline sent AAPL down nearly 2% on June 8,...",
      "articleId": 200681775,
      "publishedAt": "2026-06-09T08:38:43.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/week-in-focus-us-cpi-opec-boc-ecb-uk-gdp-and-china-inflation-200681607",
      "image": "https://d1-invdn-com.investing.com/company_logo/202cdce0d0cd64f29fca913a2c714f3a.jpg",
      "title": "Week in Focus: US CPI, OPEC, BoC, ECB, UK GDP and China Inflation",
      "author": "Ryan Anderson",
      "excerpt": "\nSUN: OPEC/JMMC Meeting (Jun)\nMON: Japanese GDP (Q1), German Factory Orders (Apr), US Consumer Inflation Expectations\nTUE: EIA...",
      "articleId": 200681607,
      "publishedAt": "2026-06-05T13:32:04.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/what-exactly-is-agentic-ai-and-why-are-some-stocks-blowing-up-because-of-it-200681295",
      "image": "https://d1-invdn-com.investing.com/company_logo/2ca976c96d700a6557ba4064971fc3ca.jpg",
      "title": "What Exactly Is Agentic AI, and Why Are Some Stocks Blowing Up Because of It?",
      "author": "Sam Quirke ",
      "excerpt": "There is a new phrase dominating Wall Street right now, and if you have been paying attention to earnings calls, analyst notes, or...",
      "articleId": 200681295,
      "publishedAt": "2026-06-01T16:55:26.000Z"
    },
    {
      "url": "http://www.investing.com/analysis/dell-takes-aim-at-apple-with-a-699-xps-13-200681259",
      "image": "https://d1-invdn-com.investing.com/company_logo/ad848e2ff2022b304416fb3bdd9194c4.jpg",
      "title": "Dell Takes Aim at Apple With a $699 XPS 13",
      "author": "Boluwatife Remy",
      "excerpt": "Apple (NASDAQ:AAPL) changed the conversation about laptop pricing earlier this year, and Dell (NYSE:DELL) just fired back in the...",
      "articleId": 200681259,
      "publishedAt": "2026-06-01T09:36:15.000Z"
    }
  ],
  "pairId": 6408,
  "symbol": "AAPL",
  "hasMore": true,
  "nextPage": 2
}
```

---

### Calendar

Kalender ekonomi (filter negara/importance/rentang).

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/calendar`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `country` | string | query | no | Kode negara (US, EU, GB, JP, CN, ID, ...). Kosong = basket negara major utama |
| `importance` | enum(all|high|medium|low) | query | no | Tingkat dampak event. Default all (semua tingkat) |
| `range` | enum(today|tomorrow|week) | query | no | Rentang waktu: today, tomorrow, atau week (default today) |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/calendar?country=US&importance=high&range=today" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/calendar?country=US&importance=high&range=today", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/calendar?country=US&importance=high&range=today",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 87,
  "range": "week",
  "events": [
    {
      "date": "2026-06-15",
      "time": "08:30",
      "event": "NY Empire State Manufacturing Index  (Jun)",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 08:30:00",
      "forecast": "13.20",
      "previous": "19.60",
      "importance": 2
    },
    {
      "date": "2026-06-15",
      "time": "09:15",
      "event": "Capacity Utilization Rate  (May)",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 09:15:00",
      "forecast": "76.2%",
      "previous": "76.1%",
      "importance": 1
    },
    {
      "date": "2026-06-15",
      "time": "09:15",
      "event": "Industrial Production (YoY)  (May)",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 09:15:00",
      "previous": "1.35%",
      "importance": 2
    },
    {
      "date": "2026-06-15",
      "time": "09:15",
      "event": "Industrial Production (MoM)  (May)",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 09:15:00",
      "forecast": "0.3%",
      "previous": "0.7%",
      "importance": 2
    },
    {
      "date": "2026-06-15",
      "time": "09:15",
      "event": "Manufacturing Production (MoM)  (May)",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 09:15:00",
      "previous": "0.6%",
      "importance": 1
    },
    {
      "date": "2026-06-15",
      "time": "10:00",
      "event": "NAHB Housing Market Index  (Jun)",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 10:00:00",
      "forecast": "36",
      "previous": "37",
      "importance": 1
    },
    {
      "date": "2026-06-15",
      "time": "11:30",
      "event": "3-Month Bill Auction",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 11:30:00",
      "previous": "3.640%",
      "importance": 1
    },
    {
      "date": "2026-06-15",
      "time": "11:30",
      "event": "6-Month Bill Auction",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026/06/15 11:30:00",
      "previous": "3.690%",
      "importance": 1
    }
  ],
  "country": "US",
  "importance": "all"
}
```

---

### Market Table

A whole market's live quote table in one call — FX majors with bid/ask, bonds, stocks, indices, commodities, index futures and ETFs.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/market-table`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `table` | enum(forex|commodities|indices|index-futures|bonds|stocks|etf) | query | no | Which market table to pull. forex = 27 major/minor FX pairs with live bid and ask, commodities = metals, energy and agri futures, indices = world cash indices, index-futures = index futures, bonds = government bonds with coupon and price, stocks = headline equities with bid and ask, etf = major ETFs. Default forex |
| `names` | enum(true|false) | query | no | Resolve instrument names and exchanges. The quote table itself carries no names, so this costs one extra lookup per instrument the process has not seen. Set false for the fastest possible price-only table. Default true |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/market-table?table=forex&names=true" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/market-table?table=forex&names=true", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/market-table?table=forex&names=true",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 27,
  "items": [
    {
      "ask": 1.1571,
      "bid": 1.1569,
      "low": 1.1526,
      "high": 1.1586,
      "last": 1.157,
      "name": "EUR/USD",
      "open": 1.1529,
      "type": "Currency",
      "change": 0.0041,
      "lastAt": "2026-08-14T20:58:58.000Z",
      "pairId": 1,
      "symbol": "EUR/USD",
      "volume": 0,
      "dayRange": "1.1526 - 1.1586",
      "exchange": "Real-time Currencies",
      "avgVolume": 0,
      "week52Low": 1.1325,
      "week52High": 1.2079,
      "week52Range": "1.1325 - 1.2079",
      "changePercent": 0.36,
      "lastTimestamp": 1786741138,
      "previousClose": 1.1529,
      "exchangeIsOpen": false,
      "turnoverVolume": 0,
      "technicalSummary": "Strong Buy"
    },
    {
      "ask": 1.3536,
      "bid": 1.3531,
      "low": 1.3482,
      "high": 1.3562,
      "last": 1.3533,
      "name": "GBP/USD",
      "open": 1.3486,
      "type": "Currency",
      "change": 0.0047,
      "lastAt": "2026-08-14T20:58:55.000Z",
      "pairId": 2,
      "symbol": "GBP/USD",
      "volume": 0,
      "dayRange": "1.3482 - 1.3562",
      "exchange": "Real-time Currencies",
      "avgVolume": 0,
      "week52Low": 1.3009,
      "week52High": 1.3869,
      "week52Range": "1.3009 - 1.3869",
      "changePercent": 0.35,
      "lastTimestamp": 1786741135,
      "previousClose": 1.3486,
      "exchangeIsOpen": false,
      "turnoverVolume": 0,
      "technicalSummary": "Buy"
    },
    {
      "ask": 159.34,
      "bid": 159.31,
      "low": 158.6,
      "high": 159.55,
      "last": 159.32,
      "name": "USD/JPY",
      "open": 159.5,
      "type": "Currency",
      "change": -0.18,
      "lastAt": "2026-08-14T20:58:59.000Z",
      "pairId": 3,
      "symbol": "USD/JPY",
      "volume": 0,
      "dayRange": "158.60 - 159.55",
      "exchange": "Real-time Currencies",
      "avgVolume": 0,
      "week52Low": 145.48,
      "week52High": 164,
      "week52Range": "145.48 - 164",
      "changePercent": -0.11,
      "lastTimestamp": 1786741139,
      "previousClose": 159.5,
      "exchangeIsOpen": false,
      "turnoverVolume": 0,
      "technicalSummary": "Buy"
    },
    {
      "ask": 0.8135,
      "bid": 0.8132,
      "low": 0.8104,
      "high": 0.8146,
      "last": 0.8134,
      "name": "USD/CHF",
      "open": 0.8137,
      "type": "Currency",
      "change": -0.0003,
      "lastAt": "2026-08-14T20:58:01.000Z",
      "pairId": 4,
      "symbol": "USD/CHF",
      "volume": 0,
      "dayRange": "0.8104 - 0.8146",
      "exchange": "Real-time Currencies",
      "avgVolume": 0,
      "week52Low": 0.7604,
      "week52High": 0.8208,
      "week52Range": "0.7604 - 0.8208",
      "changePercent": -0.04,
      "lastTimestamp": 1786741081,
      "previousClose": 0.8137,
      "exchangeIsOpen": false,
      "turnoverVolume": 0,
      "technicalSummary": "Strong Buy"
    },
    {
      "ask": 0.7088,
      "bid": 0.7083,
      "low": 0.7054,
      "high": 0.7096,
      "last": 0.7086,
      "name": "AUD/USD",
      "open": 0.7059,
      "type": "Currency",
      "change": 0.0027,
      "lastAt": "2026-08-14T20:58:54.000Z",
      "pairId": 5,
      "symbol": "AUD/USD",
      "volume": 0,
      "dayRange": "0.7054 - 0.7096",
      "exchange": "Real-time Currencies",
      "avgVolume": 0,
      "week52Low": 0.6414,
      "week52High": 0.7279,
      "week52Range": "0.6414 - 0.7279",
      "changePercent": 0.38,
      "lastTimestamp": 1786741134,
      "previousClose": 0.7059,
      "exchangeIsOpen": false,
      "turnoverVolume": 0,
      "technicalSummary": "Strong Buy"
    },
    {
      "ask": 1.388,
      "bid": 1.3869,
      "low": 1.3864,
      "high": 1.3937,
      "last": 1.3874,
      "name": "USD/CAD",
      "open": 1.3931,
      "type": "Currency",
      "change": -0.0057,
      "lastAt": "2026-08-14T20:58:54.000Z",
      "pairId": 7,
      "symbol": "USD/CAD",
      "volume": 0,
      "dayRange": "1.3864 - 1.3937",
      "exchange": "Real-time Currencies",
      "avgVolume": 0,
      "week52Low": 1.3481,
      "week52High": 1.425,
      "week52Range": "1.3481 - 1.425",
      "changePercent": -0.41,
      "lastTimestamp": 1786741134,
      "previousClose": 1.3931,
      "exchangeIsOpen": false,
      "turnoverVolume": 0,
      "technicalSummary": "Strong Sell"
    }
  ],
  "table": "forex",
  "provider": "investing",
  "namedCount": 27
}
```

---

### Earnings Calendar

Every company reporting on a given day, with EPS actual, forecast and previous, revenue and market cap.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/earnings-calendar`
- **Cache TTL:** 900s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `range` | enum(yesterday|today|tomorrow) | query | no | Which reporting day to list. The upstream publishes exactly these three days and no others. Default today |
| `importance` | enum(all|high|medium|low) | query | no | Filter by the upstream's own importance rating: low = 1, medium = 2, high = 3. Default all |
| `symbol` | string | query | no | Keep only rows whose ticker or company name contains this text |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/earnings-calendar?range=today&importance=all&symbol=AAPL" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/earnings-calendar?range=today&importance=all&symbol=AAPL", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/earnings-calendar?range=today&importance=all&symbol=AAPL",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "date": "2026-08-17",
  "count": 197,
  "items": [
    {
      "date": "2026-08-17",
      "pairId": 23647,
      "symbol": "BHP",
      "company": "BHP Group Ltd ADR",
      "country": "United States",
      "countryId": 5,
      "marketCap": "220.87B",
      "shortName": "BHP Group Ltd ADR",
      "timestamp": 1786924800,
      "importance": 1,
      "epsForecast": 2.91,
      "marketPhase": "during-market",
      "parentPairId": 23647,
      "reportPeriod": "06/2026",
      "relatedPairId": 23647,
      "marketCapValue": 220870000000
    },
    {
      "eps": 0.24,
      "date": "2026-08-17",
      "pairId": 1220872,
      "symbol": "GMBXF",
      "company": "Grupo Mexico, S.A.B. De C.V.",
      "country": "United States",
      "revenue": "5.72B",
      "countryId": 5,
      "marketCap": "99.6B",
      "shortName": "Grupo Mexico",
      "timestamp": 1786924800,
      "importance": 1,
      "epsForecast": 0.2149,
      "epsPrevious": 0.21,
      "parentPairId": 27109,
      "reportPeriod": "06/2026",
      "relatedPairId": 1220872,
      "marketCapValue": 99600000000,
      "revenueForecast": "5.63B"
    },
    {
      "date": "2026-08-17",
      "pairId": 942065,
      "symbol": "NABZY",
      "company": "National Australia Bank Ltd ADR",
      "country": "United States",
      "countryId": 5,
      "marketCap": "90.42B",
      "shortName": "National Australia Bank ADR",
      "timestamp": 1786924800,
      "importance": 1,
      "parentPairId": 942065,
      "reportPeriod": "06/2026",
      "relatedPairId": 942065,
      "marketCapValue": 90420000000
    },
    {
      "date": "2026-08-17",
      "pairId": 942253,
      "symbol": "TYIDY",
      "company": "Toyota Industries Corporation",
      "country": "United States",
      "countryId": 5,
      "marketCap": "38.46B",
      "shortName": "Toyota Industries Corporation",
      "timestamp": 1786924800,
      "importance": 1,
      "epsForecast": 2.18,
      "epsPrevious": 0.7667,
      "parentPairId": 942253,
      "reportPeriod": "06/2026",
      "relatedPairId": 942253,
      "marketCapValue": 38460000000,
      "revenueForecast": "6.52B"
    },
    {
      "date": "2026-08-17",
      "pairId": 21187,
      "symbol": "AVVIY",
      "company": "Aviva PLC ADR",
      "country": "United States",
      "countryId": 5,
      "marketCap": "29.41B",
      "shortName": "Aviva ADR",
      "timestamp": 1786924800,
      "importance": 1,
      "parentPairId": 21187,
      "reportPeriod": "06/2026",
      "relatedPairId": 21187,
      "marketCapValue": 29410000000
    },
    {
      "date": "2026-08-17",
      "pairId": 942119,
      "symbol": "PPERY",
      "company": "Bank Mandiri Persero Tbk PT ADR",
      "country": "United States",
      "countryId": 5,
      "marketCap": "21.83B",
      "shortName": "Bank Mandiri Persero ADR",
      "timestamp": 1786924800,
      "importance": 1,
      "epsForecast": 0.3435,
      "epsPrevious": 0.3682,
      "parentPairId": 942119,
      "reportPeriod": "06/2026",
      "relatedPairId": 942119,
      "marketCapValue": 21830000000,
      "revenueForecast": "2.2B"
    }
  ],
  "range": "tomorrow",
  "total": 197,
  "provider": "investing",
  "importance": "all"
}
```

---

### Economic Calendar

Scheduled macro releases with actual, forecast and previous values, plus the revision history.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/economic-calendar`
- **Cache TTL:** 900s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `range` | enum(yesterday|today|tomorrow|week) | query | no | Which window to list. The upstream publishes exactly these four and ignores any explicit date. week is the current Sunday-to-Saturday week. Default today |
| `country` | string | query | no | Keep only events for this country. Accepts US, EU, GB, JP, CN, DE, FR, CA, AU, CH, IT, ES, ID, IN, BR, RU, KR, HK, SG, NZ, MX, ZA, TR, SA. Omit for every country |
| `importance` | enum(all|high|medium|low) | query | no | Expected volatility of the release. Default all |
| `names` | enum(true|false) | query | no | Resolve event names, countries and currencies from the web calendar. Costs one extra request per 200 events. Set false for ids and values only. Default true |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/economic-calendar?range=today&country=US&importance=high&names=true" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/economic-calendar?range=today&country=US&importance=high&names=true", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/economic-calendar?range=today&country=US&importance=high&names=true",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 9,
  "items": [
    {
      "url": "https://www.investing.com/economic-calendar/gdp-119",
      "date": "2026-08-16",
      "time": "23:50",
      "event": "GDP (QoQ) (Q2)",
      "rowId": 554256,
      "period": "q2",
      "country": "Japan",
      "currency": "JPY",
      "datetime": "2026-08-16T23:50:00.000Z",
      "forecast": "0.5%",
      "previous": "0.5%",
      "countryId": 35,
      "direction": "neutral",
      "timestamp": 1786924200,
      "updatedAt": "2026-08-15T19:09:25Z",
      "importance": 3,
      "volatility": "High Volatility Expected",
      "eventAttrId": 119,
      "preliminary": true,
      "relatedArticleId": 0
    },
    {
      "url": "https://www.investing.com/economic-calendar/cpi-67",
      "date": "2026-08-19",
      "time": "06:00",
      "event": "CPI (YoY) (Jul)",
      "rowId": 554444,
      "period": "jul",
      "country": "United Kingdom",
      "currency": "GBP",
      "datetime": "2026-08-19T06:00:00.000Z",
      "forecast": "2.5%",
      "previous": "2.6%",
      "countryId": 4,
      "direction": "neutral",
      "timestamp": 1787119200,
      "updatedAt": "2026-08-15T19:09:24Z",
      "importance": 3,
      "volatility": "High Volatility Expected",
      "eventAttrId": 67,
      "relatedArticleId": 0
    },
    {
      "url": "https://www.investing.com/economic-calendar/cpi-68",
      "date": "2026-08-19",
      "time": "09:00",
      "event": "CPI (YoY) (Jul)",
      "rowId": 554470,
      "period": "jul",
      "country": "Euro Zone",
      "currency": "EUR",
      "datetime": "2026-08-19T09:00:00.000Z",
      "forecast": "2.9%",
      "previous": "2.9%",
      "countryId": 72,
      "direction": "neutral",
      "timestamp": 1787130000,
      "updatedAt": "2026-08-14T18:20:25Z",
      "importance": 3,
      "volatility": "High Volatility Expected",
      "eventAttrId": 68,
      "relatedArticleId": 0
    },
    {
      "url": "https://www.investing.com/economic-calendar/eia-crude-oil-inventories-75",
      "date": "2026-08-19",
      "time": "14:30",
      "event": "Crude Oil Inventories",
      "rowId": 555433,
      "country": "United States",
      "currency": "USD",
      "datetime": "2026-08-19T14:30:00.000Z",
      "previous": "17.423M",
      "countryId": 5,
      "direction": "neutral",
      "timestamp": 1787149800,
      "updatedAt": "2026-08-15T19:09:27Z",
      "importance": 3,
      "volatility": "High Volatility Expected",
      "eventAttrId": 75,
      "relatedArticleId": 0
    },
    {
      "url": "https://www.investing.com/economic-calendar/fomc-meeting-minutes-108",
      "date": "2026-08-19",
      "time": "18:00",
      "event": "FOMC Meeting Minutes",
      "rowId": 555236,
      "country": "United States",
      "currency": "USD",
      "datetime": "2026-08-19T18:00:00.000Z",
      "countryId": 5,
      "direction": "neutral",
      "timestamp": 1787162400,
      "updatedAt": "2026-08-11T06:33:45Z",
      "importance": 3,
      "volatility": "High Volatility Expected",
      "eventAttrId": 108,
      "relatedArticleId": 0
    },
    {
      "url": "https://www.investing.com/economic-calendar/philadelphia-fed-manufacturing-index-236",
      "date": "2026-08-20",
      "time": "12:30",
      "event": "Philadelphia Fed Manufacturing Index (Aug)",
      "rowId": 554545,
      "period": "aug",
      "country": "United States",
      "currency": "USD",
      "datetime": "2026-08-20T12:30:00.000Z",
      "forecast": "24.3",
      "previous": "41.4",
      "countryId": 5,
      "direction": "neutral",
      "timestamp": 1787229000,
      "updatedAt": "2026-08-15T19:09:27Z",
      "importance": 3,
      "volatility": "High Volatility Expected",
      "eventAttrId": 236,
      "relatedArticleId": 0
    }
  ],
  "range": "week",
  "total": 252,
  "dateTo": "2026-08-21",
  "dateFrom": "2026-08-16",
  "provider": "investing",
  "importance": "high",
  "namedCount": 9
}
```

---

### Market Holidays

Which exchanges are shut on a given range, and which close early.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/market-holidays`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `range` | enum(yesterday|today|tomorrow|week) | query | no | Which window to list. The upstream publishes exactly these four and ignores any explicit date. week is the current Sunday-to-Saturday week. Default week |
| `country` | string | query | no | Keep only holidays for this country. Accepts the three-letter code the upstream uses (JPN, USA, GBR, DEU, ZAF, ...) or the country name |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/market-holidays?range=week&country=JPN" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/market-holidays?range=week&country=JPN", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/market-holidays?range=week&country=JPN",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 0,
  "items": [],
  "range": "week",
  "total": 2,
  "country": "JPN",
  "provider": "investing"
}
```

---

### Indicator History

The full published history of one macro indicator, back to its first print.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/indicator-history`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `eventAttrId` | number | query | yes | The indicator's stable id, as returned in `eventAttrId` by the economic-calendar endpoint |
| `country` | string | query | no | Two-letter code of the country that publishes the indicator, as used in its own chart path. It must match the event's country — the same id under another country is a 404. Default us |
| `count` | number | query | no | Keep only the most recent N prints. Omit for the whole series |
| `order` | enum(asc|desc) | query | no | asc = oldest print first, desc = newest first. Default asc |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/indicator-history?eventAttrId=56&country=us&count=120&order=asc" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/indicator-history?eventAttrId=56&country=us&count=120&order=asc", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/indicator-history?eventAttrId=56&country=us&count=120&order=asc",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 120,
  "items": [
    {
      "date": "2016-07-15T12:30:00.000Z",
      "actual": 0.2,
      "forecast": 0.2,
      "timestamp": 1468585800000,
      "actualState": "neutral",
      "actualFormatted": "0.2%",
      "forecastFormatted": "0.2%"
    },
    {
      "date": "2016-08-16T12:30:00.000Z",
      "actual": 0.1,
      "forecast": 0.2,
      "timestamp": 1471350600000,
      "actualState": "down",
      "actualFormatted": "0.1%",
      "forecastFormatted": "0.2%"
    },
    {
      "date": "2016-09-16T12:30:00.000Z",
      "actual": 0.3,
      "forecast": 0.2,
      "timestamp": 1474029000000,
      "actualState": "up",
      "actualFormatted": "0.3%",
      "forecastFormatted": "0.2%"
    },
    {
      "date": "2016-10-18T12:30:00.000Z",
      "actual": 0.1,
      "forecast": 0.2,
      "timestamp": 1476793800000,
      "actualState": "down",
      "actualFormatted": "0.1%",
      "forecastFormatted": "0.2%"
    },
    {
      "date": "2016-11-17T13:30:00.000Z",
      "actual": 0.1,
      "forecast": 0.2,
      "timestamp": 1479389400000,
      "actualState": "down",
      "actualFormatted": "0.1%",
      "forecastFormatted": "0.2%"
    },
    {
      "date": "2016-12-15T13:30:00.000Z",
      "actual": 0.2,
      "forecast": 0.2,
      "timestamp": 1481808600000,
      "actualState": "neutral",
      "actualFormatted": "0.2%",
      "forecastFormatted": "0.2%"
    }
  ],
  "total": 678,
  "country": "us",
  "provider": "investing",
  "lastPrint": "2026-08-12T12:30:00.000Z",
  "firstPrint": "1970-01-01T09:00:00.000Z",
  "eventAttrId": 56
}
```

---

### Financials

Income statement, balance sheet and cash flow for a listed company — quarterly and annual.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/financials`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Ticker or company name to resolve. Ignored when pairId is given |
| `pairId` | number | query | no | Internal instrument id, which skips symbol resolution |
| `period` | enum(quarterly|annual|both) | query | no | Which period length to return. Default both |
| `statement` | enum(all|income|balance|cashflow) | query | no | Which statement to return: income statement, balance sheet, cash flow, or all three. Default all |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/financials?query=AAPL&pairId=6408&period=both&statement=all" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/financials?query=AAPL&pairId=6408&period=both&statement=all", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/financials?query=AAPL&pairId=6408&period=both&statement=all",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 24,
  "pairId": 6408,
  "period": "both",
  "symbol": "AAPL",
  "summary": "Apple Inc. reported earnings results for the third quarter and nine months ended June 27, 2026. For the third quarter, the company reported revenue was USD 109,417 million compared to USD 94,036 million a year ago. Net income was USD 29,789 million compared to USD 23,434 million a year ago. Basic earnings per share from continuing operations was USD 2.03 compared to USD 1.57 a year ago. Diluted earnings per share from continuing operations was USD 2.02 compared to USD 1.57 a year ago.\rFor the nine months, revenue was USD 364,357 million compared to USD 313,695 million a year ago. Net income was USD 101,464 million compared to USD 84,544 million a year ago. Basic earnings per share from continuing operations was USD 6.91 compared to USD 5.64 a year ago. Diluted earnings per share from continuing operations was USD 6.88 compared to USD 5.62 a year ago.",
  "provider": "investing",
  "statement": "all",
  "statements": {
    "annual": {
      "income": [
        {
          "date": "Sep 27, 2025",
          "netIncome": 112010,
          "periodEnd": "2025-09-27",
          "timestamp": 1758931200,
          "grossProfit": 195201,
          "totalRevenue": 416161,
          "operationIncome": 133050
        },
        {
          "date": "Sep 28, 2024",
          "netIncome": 93736,
          "periodEnd": "2024-09-28",
          "timestamp": 1727481600,
          "grossProfit": 180683,
          "totalRevenue": 391035,
          "operationIncome": 123216
        },
        {
          "date": "Sep 30, 2023",
          "netIncome": 96995,
          "periodEnd": "2023-09-30",
          "timestamp": 1696032000,
          "grossProfit": 169148,
          "totalRevenue": 383285,
          "operationIncome": 114301
        },
        {
          "date": "Sep 24, 2022",
          "netIncome": 99803,
          "periodEnd": "2022-09-24",
          "timestamp": 1663977600,
          "grossProfit": 170782,
          "totalRevenue": 394328,
          "operationIncome": 119437
        }
      ],
      "balance": [
        {
          "date": "Sep 27, 2025",
          "periodEnd": "2025-09-27",
          "timestamp": 1758931200,
          "totalAssets": 359241,
          "totalEquity": 73733,
          "totalLiabilities": 285508
        },
        {
          "date": "Sep 28, 2024",
          "periodEnd": "2024-09-28",
          "timestamp": 1727481600,
          "totalAssets": 364980,
          "totalEquity": 56950,
          "totalLiabilities": 308030
        },
        {
          "date": "Sep 30, 2023",
          "periodEnd": "2023-09-30",
          "timestamp": 1696032000,
          "totalAssets": 352583,
          "totalEquity": 62146,
          "totalLiabilities": 290437
        },
        {
          "date": "Sep 24, 2022",
          "periodEnd": "2022-09-24",
          "timestamp": 1663977600,
          "totalAssets": 352755,
          "totalEquity": 50672,
          "totalLiabilities": 302083
        }
      ],
      "cashflow": [
        {
          "date": "Sep 27, 2025",
          "financing": -120686,
          "investing": 15195,
          "netChange": 5991,
          "operating": 111482,
          "periodEnd": "2025-09-27",
          "timestamp": 1758931200
        },
        {
          "date": "Sep 28, 2024",
          "financing": -121983,
          "investing": 2935,
          "netChange": -794,
          "operating": 118254,
          "periodEnd": "2024-09-28",
          "timestamp": 1727481600
        },
        {
          "date": "Sep 30, 2023",
          "financing": -108488,
          "investing": 3705,
          "netChange": 5760,
          "operating": 110543,
          "periodEnd": "2023-09-30",
          "timestamp": 1696032000
        },
        {
          "date": "Sep 24, 2022",
          "financing": -110749,
          "investing": -22354,
          "netChange": -10952,
          "operating": 122151,
          "periodEnd": "2022-09-24",
          "timestamp": 1663977600
        }
      ]
    },
    "quarterly": {
      "income": [
        {
          "date": "Jun 27, 2026",
          "netIncome": 29789,
          "periodEnd": "2026-06-27",
          "timestamp": 1782518400,
          "grossProfit": 54770,
          "totalRevenue": 109417,
          "operationIncome": 35695
        },
        {
          "date": "Mar 28, 2026",
          "netIncome": 29578,
          "periodEnd": "2026-03-28",
          "timestamp": 1774656000,
          "grossProfit": 54781,
          "totalRevenue": 111184,
          "operationIncome": 35885
        },
        {
          "date": "Dec 27, 2025",
          "netIncome": 42097,
          "periodEnd": "2025-12-27",
          "timestamp": 1766793600,
          "grossProfit": 69231,
          "totalRevenue": 143756,
          "operationIncome": 50852
        },
        {
          "date": "Sep 27, 2025",
          "netIncome": 27466,
          "periodEnd": "2025-09-27",
          "timestamp": 1758931200,
          "grossProfit": 48341,
          "totalRevenue": 102466,
          "operationIncome": 32427
        }
      ],
      "balance": [
        {
          "date": "Jun 27, 2026",
          "periodEnd": "2026-06-27",
          "timestamp": 1782518400,
          "totalAssets": 383266,
          "totalEquity": 107520,
          "totalLiabilities": 275746
        },
        {
          "date": "Mar 28, 2026",
          "periodEnd": "2026-03-28",
          "timestamp": 1774656000,
          "totalAssets": 371082,
          "totalEquity": 106491,
          "totalLiabilities": 264591
        },
        {
          "date": "Dec 27, 2025",
          "periodEnd": "2025-12-27",
          "timestamp": 1766793600,
          "totalAssets": 379297,
          "totalEquity": 88190,
          "totalLiabilities": 291107
        },
        {
          "date": "Sep 27, 2025",
          "periodEnd": "2025-09-27",
          "timestamp": 1758931200,
          "totalAssets": 359241,
          "totalEquity": 73733,
          "totalLiabilities": 285508
        }
      ],
      "cashflow": [
        {
          "date": "Jun 27, 2026",
          "financing": -32640,
          "investing": -7757,
          "netChange": -6028,
          "operating": 34369,
          "periodEnd": "2026-06-27",
          "timestamp": 1782518400
        },
        {
          "date": "Mar 28, 2026",
          "financing": -22279,
          "investing": -6168,
          "netChange": 255,
          "operating": 28702,
          "periodEnd": "2026-03-28",
          "timestamp": 1774656000
        },
        {
          "date": "Dec 27, 2025",
          "financing": -39656,
          "investing": -4886,
          "netChange": 9383,
          "operating": 53925,
          "periodEnd": "2025-12-27",
          "timestamp": 1766793600
        },
        {
          "date": "Sep 27, 2025",
          "financing": -27476,
          "investing": -2587,
          "netChange": -335,
          "operating": 29728,
          "periodEnd": "2025-09-27",
          "timestamp": 1758931200
        }
      ]
    }
  }
}
```

---

### Dividends Calendar

Who goes ex-dividend on which day, how much, and when it pays.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/dividends-calendar`
- **Cache TTL:** 900s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `country` | string | query | no | Listing country. Accepts US, EU, GB, JP, CN, DE, FR, CA, AU, CH, IT, ES, ID, IN, BR, RU, KR, HK, SG, NZ, MX, ZA, TR, SA. Default US |
| `dateFrom` | string | query | no | First ex-dividend date to include, YYYY-MM-DD. Defaults to today |
| `dateTo` | string | query | no | Last ex-dividend date to include, YYYY-MM-DD. Defaults to seven days after dateFrom. At most 31 days apart |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/dividends-calendar?country=US&dateFrom=2026-08-12&dateTo=2026-08-19" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/dividends-calendar?country=US&dateFrom=2026-08-12&dateTo=2026-08-19", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/dividends-calendar?country=US&dateFrom=2026-08-12&dateTo=2026-08-19",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 381,
  "items": [
    {
      "url": "https://www.investing.com/equities/target-dividends",
      "exDate": "2026-08-12",
      "symbol": "TGT",
      "company": "Target Corporation",
      "country": "United States",
      "payDate": "2026-09-01",
      "dividend": 1.16,
      "frequency": "Quarterly",
      "shortName": "Target",
      "payTimestamp": 1788220800,
      "yieldPercent": 3.05
    },
    {
      "url": "https://www.investing.com/equities/singapore-airlines-ltd-dividends",
      "exDate": "2026-08-12",
      "symbol": "SINGY",
      "company": "Singapore Airlines Ltd",
      "country": "United States",
      "payDate": "2026-09-17",
      "dividend": 0.276621,
      "frequency": "Semi-Annual",
      "shortName": "Singapore Airlines",
      "payTimestamp": 1789603200,
      "yieldPercent": 4.02
    },
    {
      "url": "https://www.investing.com/equities/singapore-airlines-ltd-dividends",
      "exDate": "2026-08-12",
      "symbol": "SINGY",
      "company": "Singapore Airlines Ltd",
      "country": "United States",
      "payDate": "2026-09-17",
      "dividend": 0.086613,
      "frequency": "Semi-Annual",
      "shortName": "Singapore Airlines",
      "payTimestamp": 1789603200,
      "yieldPercent": 4.02
    },
    {
      "url": "https://www.investing.com/equities/paccar-inc-dividends",
      "exDate": "2026-08-12",
      "symbol": "PCAR",
      "company": "PACCAR Inc",
      "country": "United States",
      "payDate": "2026-09-02",
      "dividend": 0.35,
      "frequency": "Quarterly",
      "shortName": "PACCAR",
      "payTimestamp": 1788307200,
      "yieldPercent": 1.06
    },
    {
      "url": "https://www.investing.com/equities/winmark-corp-dividends",
      "exDate": "2026-08-12",
      "symbol": "WINA",
      "company": "Winmark Corporation",
      "country": "United States",
      "payDate": "2026-09-01",
      "dividend": 1.02,
      "frequency": "Quarterly",
      "shortName": "Winmark",
      "payTimestamp": 1788220800,
      "yieldPercent": 1.1
    },
    {
      "url": "https://www.investing.com/equities/united-rentals-dividends",
      "exDate": "2026-08-12",
      "symbol": "URI",
      "company": "United Rentals Inc",
      "country": "United States",
      "payDate": "2026-08-26",
      "dividend": 1.97,
      "frequency": "Quarterly",
      "shortName": "United Rentals",
      "payTimestamp": 1787702400,
      "yieldPercent": 0.69
    }
  ],
  "total": 381,
  "dateTo": "2026-08-19",
  "country": "US",
  "dateFrom": "2026-08-12",
  "provider": "investing"
}
```

---

### FX Cross Rates

The cross-rate grid, flattened into one row per currency pair.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:investing/fx-cross-rates`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `base` | string | query | no | Keep only rows quoting this base currency, as a three-letter code. Omit for the whole grid |
| `quote` | string | query | no | Keep only the counter currency, as a three-letter code. Omit for every counter currency |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:investing/fx-cross-rates?base=USD&quote=JPY" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:investing/fx-cross-rates?base=USD&quote=JPY", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:investing/fx-cross-rates?base=USD&quote=JPY",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "base": "USD",
  "count": 1,
  "items": [
    {
      "base": "USD",
      "rate": 159.32,
      "quote": "JPY",
      "pairId": 3,
      "symbol": "USD/JPY"
    }
  ],
  "quote": "JPY",
  "total": 42,
  "provider": "investing",
  "currencies": [
    "AUD",
    "CAD",
    "CHF",
    "EUR",
    "GBP",
    "JPY"
  ]
}
```

---


_Generated: 2026-09-25T14:30:16.275Z_