# Lbma — Zapi reference

> The running average the auction operator publishes per metal and session.

**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/lbma
- 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

---

## Lbma

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

The running average the auction operator publishes per metal and session.

**Tags:** finance, lbma

### Average

The running average the auction operator publishes per metal and session.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:lbma/average`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `metal` | enum(gold|silver|platinum|palladium) | query | no | Keep a single metal. Omit for all four |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:lbma/average?metal=gold" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:lbma/average?metal=gold", {
  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:lbma/average?metal=gold",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 2,
  "items": [
    {
      "metal": "gold",
      "price": 4570.92,
      "fixing": "am"
    },
    {
      "metal": "gold",
      "price": 4572.355,
      "fixing": "pm"
    }
  ],
  "metal": "gold",
  "dataset": "average",
  "currency": "usd",
  "provider": "lbma"
}
```

---

### Prices

LBMA daily benchmark fixings — the auction prices themselves, back to 1968.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:lbma/prices`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `metal` | enum(gold|silver|platinum|palladium) | query | no | Metal to read. Default gold |
| `fixing` | enum(am|pm) | query | no | Auction session. Default am. Silver has a single daily auction and rejects this |
| `currency` | enum(usd|gbp|eur) | query | no | Quote currency. Default usd. EUR is null before 1999 |
| `window` | enum(full|limited) | query | no | full is the whole series, limited is the last ~14 fixings. Default full |
| `from` | string | query | no | Earliest date to keep, YYYY-MM-DD |
| `to` | string | query | no | Latest date to keep, YYYY-MM-DD |
| `order` | enum(desc|asc) | query | no | desc is newest first. Default desc |
| `page` | number | query | no | Page number, 1-based. Default 1 |
| `limit` | number | query | no | Rows per page. Default 50, max 500 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:lbma/prices?metal=gold&fixing=am&currency=usd&window=full&from=2026-01-01&to=2026-08-19&order=desc&page=1&limit=50" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:lbma/prices?metal=gold&fixing=am&currency=usd&window=full&from=2026-01-01&to=2026-08-19&order=desc&page=1&limit=50", {
  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:lbma/prices?metal=gold&fixing=am&currency=usd&window=full&from=2026-01-01&to=2026-08-19&order=desc&page=1&limit=50",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": null,
  "page": 1,
  "count": 50,
  "items": [
    {
      "date": "2026-08-20",
      "price": 4487.6
    },
    {
      "date": "2026-08-19",
      "price": 4355.75
    },
    {
      "date": "2026-08-18",
      "price": 4388.75
    },
    {
      "date": "2026-08-17",
      "price": 4393.6
    },
    {
      "date": "2026-08-14",
      "price": 4349.9
    },
    {
      "date": "2026-08-13",
      "price": 4380.45
    },
    {
      "date": "2026-08-12",
      "price": 4413.2
    },
    {
      "date": "2026-08-11",
      "price": 4372.2
    }
  ],
  "metal": "gold",
  "order": "desc",
  "total": 14818,
  "fixing": "am",
  "window": "full",
  "dataset": "prices",
  "hasMore": true,
  "currency": "usd",
  "nextPage": 2,
  "provider": "lbma"
}
```

---

### Today

The latest published fixing for all four metals in USD, GBP and EUR.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `metal` | enum(gold|silver|platinum|palladium) | query | no | Keep a single metal. Omit for all four |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:lbma/today?metal=gold" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:lbma/today?metal=gold", {
  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:lbma/today?metal=gold",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 2,
  "items": [
    {
      "eur": 3833.76,
      "gbp": 3288.96,
      "usd": 4487.6,
      "metal": "gold",
      "fixing": "am",
      "timestamp": "20/08 11:00:00"
    },
    {
      "eur": 3839.65,
      "gbp": 3287.8,
      "usd": 4482.95,
      "metal": "gold",
      "fixing": "pm",
      "timestamp": "20/08 11:00:00"
    }
  ],
  "metal": "gold",
  "dataset": "today",
  "provider": "lbma"
}
```

---

### Vault Holdings

London vault tonnage, monthly since July 2016 — gold and silver held in the

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:lbma/vault-holdings`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `from` | string | query | no | Earliest month to keep, YYYY-MM or YYYY-MM-DD |
| `to` | string | query | no | Latest month to keep, YYYY-MM or YYYY-MM-DD |
| `order` | enum(desc|asc) | query | no | desc is newest first. Default desc |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:lbma/vault-holdings?from=2024-01&to=2026-08&order=desc" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:lbma/vault-holdings?from=2024-01&to=2026-08&order=desc", {
  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:lbma/vault-holdings?from=2024-01&to=2026-08&order=desc",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": "2024-01",
  "unit": "thousand troy ounces",
  "count": 31,
  "items": [
    {
      "date": "2026-07-02",
      "gold": 306527,
      "silver": 907059
    },
    {
      "date": "2026-06-02",
      "gold": 304285,
      "silver": 902843
    },
    {
      "date": "2026-05-02",
      "gold": 301968,
      "silver": 887725
    },
    {
      "date": "2026-04-02",
      "gold": 301320,
      "silver": 882655
    },
    {
      "date": "2026-03-02",
      "gold": 300260,
      "silver": 883743
    },
    {
      "date": "2026-02-02",
      "gold": 296096,
      "silver": 870170
    },
    {
      "date": "2026-01-02",
      "gold": 294440,
      "silver": 891511
    },
    {
      "date": "2025-12-02",
      "gold": 292777,
      "silver": 894357
    }
  ],
  "order": "desc",
  "dataset": "vault-holdings",
  "provider": "lbma"
}
```

---

### Clearing

London clearing statistics, monthly since October 1996 — the volume, transfer

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:lbma/clearing`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `from` | string | query | no | Earliest month to keep, YYYY-MM or YYYY-MM-DD |
| `to` | string | query | no | Latest month to keep, YYYY-MM or YYYY-MM-DD |
| `order` | enum(desc|asc) | query | no | desc is newest first. Default desc |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:lbma/clearing?from=2024-01&to=2026-08&order=desc" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:lbma/clearing?from=2024-01&to=2026-08&order=desc", {
  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:lbma/clearing?from=2024-01&to=2026-08&order=desc",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": "2024-01",
  "count": 30,
  "items": [
    {
      "date": "2026-06-02",
      "goldTransfers": 7227,
      "goldVolumeMoz": 16.7,
      "goldValueUsdBn": 70.9,
      "silverTransfers": 2114,
      "silverVolumeMoz": 192.8,
      "silverValueUsdBn": 12.9
    },
    {
      "date": "2026-05-02",
      "goldTransfers": 6464,
      "goldVolumeMoz": 16.1,
      "goldValueUsdBn": 73.7,
      "silverTransfers": 2312,
      "silverVolumeMoz": 194.9,
      "silverValueUsdBn": 15.2
    },
    {
      "date": "2026-04-02",
      "goldTransfers": 6902,
      "goldVolumeMoz": 15.7,
      "goldValueUsdBn": 74.2,
      "silverTransfers": 1935,
      "silverVolumeMoz": 189.4,
      "silverValueUsdBn": 14.3
    },
    {
      "date": "2026-03-02",
      "goldTransfers": 8679,
      "goldVolumeMoz": 17.9,
      "goldValueUsdBn": 87,
      "silverTransfers": 2695,
      "silverVolumeMoz": 218,
      "silverValueUsdBn": 17.1
    },
    {
      "date": "2026-02-02",
      "goldTransfers": 8578,
      "goldVolumeMoz": 17.7,
      "goldValueUsdBn": 88.7,
      "silverTransfers": 3506,
      "silverVolumeMoz": 200.6,
      "silverValueUsdBn": 16.6
    },
    {
      "date": "2026-01-02",
      "goldTransfers": 7341,
      "goldVolumeMoz": 18.2,
      "goldValueUsdBn": 86.1,
      "silverTransfers": 4575,
      "silverVolumeMoz": 287.1,
      "silverValueUsdBn": 26.4
    },
    {
      "date": "2025-12-02",
      "goldTransfers": 5676,
      "goldVolumeMoz": 16.5,
      "goldValueUsdBn": 70.9,
      "silverTransfers": 3320,
      "silverVolumeMoz": 242,
      "silverValueUsdBn": 15.6
    },
    {
      "date": "2025-11-02",
      "goldTransfers": 6581,
      "goldVolumeMoz": 15.4,
      "goldValueUsdBn": 63.1,
      "silverTransfers": 2459,
      "silverVolumeMoz": 213.3,
      "silverValueUsdBn": 10.8
    }
  ],
  "order": "desc",
  "dataset": "clearing",
  "provider": "lbma"
}
```

---


_Generated: 2026-08-21T07:34:08.102Z_