# Spdr Gold — Zapi reference > The custodian's daily bar list — every gold bar in the trust, published as a PDF. **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/spdr-gold - 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 --- ## Spdr Gold **Category:** finance · **Slug:** `spdr-gold` **Detail page:** https://zpi.web.id/api/finance/spdr-gold The custodian's daily bar list — every gold bar in the trust, published as a PDF. **Tags:** finance, spdr-gold ### Bar List The custodian's daily bar list — every gold bar in the trust, published as a PDF. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:spdr-gold/bar-list` - **Cache TTL:** 3600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `product` | enum(gld|gldm|o87|gsd|9840|2840|82840|1326) | query | no | Listing code. Default gld. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:spdr-gold/bar-list?product=gld" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:spdr-gold/bar-list?product=gld", { 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:spdr-gold/bar-list?product=gld", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "url": "https://api.spdrgoldshares.com/api/v1/barlist?underlying=gld", "bytes": 697486, "ticker": "GLD", "dataset": "bar-list", "product": "gld", "filename": "GLD_HSBC_Barlist.pdf", "provider": "spdr-gold", "custodian": "HSBC", "updatedAt": "2026-08-20T16:41:05.000Z", "contentType": "application/pdf" } ``` --- ### Products The eight SPDR gold listings, from the fund site's own product index. Every - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:spdr-gold/products` - **Cache TTL:** 86400s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `query` | string | query | no | Filter by name, ticker or exchange, case-insensitive. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:spdr-gold/products?query=hong%20kong" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:spdr-gold/products?query=hong%20kong", { 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:spdr-gold/products?query=hong%20kong", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 3, "items": [ { "url": "https://www.spdrgoldshares.com/hong-kong/9840", "name": "Hong Kong 9840", "region": "HONG_KONG", "ticker": "9840", "product": "9840", "exchange": "HKeX", "description": "As an asset class, gold is unique. The economic factors that determine the price of gold are different from the economic forces that determine the price of many other asset classes, such as equities, bonds, or real estate. Gold offers investors an attractive opportunity to diversify their portfolios. SPDR Gold Shares offers investors an innovative, relatively cost efficient and secure way to acces" }, { "url": "https://www.spdrgoldshares.com/hong-kong/2840", "name": "Hong Kong 2840", "region": "HONG_KONG", "ticker": "2840", "product": "2840", "exchange": "HKeX", "description": "As an asset class, gold is unique. The economic factors that determine the price of gold are different from the economic forces that determine the price of many other asset classes, such as equities, bonds, or real estate. Gold offers investors an attractive opportunity to diversify their portfolios. SPDR Gold Shares offers investors an innovative, relatively cost efficient and secure way to acces" }, { "url": "https://www.spdrgoldshares.com/hong-kong/82840", "name": "Hong Kong 82840", "region": "HONG_KONG", "ticker": "82840", "product": "82840", "exchange": "HKeX", "description": "As an asset class, gold is unique. The economic factors that determine the price of gold are different from the economic forces that determine the price of many other asset classes, such as equities, bonds, or real estate. Gold offers investors an attractive opportunity to diversify their portfolios. SPDR Gold Shares offers investors an innovative, relatively cost efficient and secure way to acces" } ], "query": "hong kong", "dataset": "products", "provider": "spdr-gold" } ``` --- ### Performance Cumulative performance of the trust against the LBMA Gold Price, on NAV or on - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:spdr-gold/performance` - **Cache TTL:** 3600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `product` | enum(gld|gldm|o87|gsd|9840|2840|82840|1326) | query | no | Listing code. Default gld. | | `exchange` | enum(NYSE|SGX|HKeX|TSE) | query | no | Exchange for the listing. Defaults to the one that listing trades on. | | `basis` | enum(nav|close) | query | no | Measure returns from NAV per share or from the market close. Default nav. | | `lang` | enum(en|zh|ja) | query | no | Response language. Default en. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:spdr-gold/performance?product=gld&exchange=NYSE&basis=nav&lang=en" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:spdr-gold/performance?product=gld&exchange=NYSE&basis=nav&lang=en", { 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:spdr-gold/performance?product=gld&exchange=NYSE&basis=nav&lang=en", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "asOf": "07/31/2026", "basis": "nav", "count": 7, "items": [ { "period": "YTD", "trustPercent": -6.746725, "benchmarkPercent": -7.811713 }, { "period": "1MONTH", "trustPercent": -0.020102, "benchmarkPercent": 0.013661 }, { "period": "3MONTHS", "trustPercent": -12.770604, "benchmarkPercent": -12.680668 }, { "period": "6MONTHS", "trustPercent": -19.338008, "benchmarkPercent": -19.174604 }, { "period": "1YEAR", "trustPercent": 21.584008, "benchmarkPercent": 22.060718 }, { "period": "5YEAR", "trustPercent": 16.666645, "benchmarkPercent": 17.128293 }, { "period": "SINCE_INCEPTION", "trustPercent": 10.27258, "benchmarkPercent": 10.711371 } ], "ticker": "GLD", "dataset": "performance", "product": "gld", "exchange": "NYSE", "provider": "spdr-gold", "benchmark": "LBMA Gold Price" } ``` --- ### Holdings Daily The daily holdings archive — one row per trading day back to the trust's first, - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:spdr-gold/holdings-daily` - **Cache TTL:** 3600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `product` | enum(gld|gldm|o87|gsd|9840|2840|82840|1326) | query | no | Listing code. Default gld — the NYSE listing whose archive runs back to 18 Nov 2004. | | `exchange` | enum(NYSE|SGX|HKeX|TSE) | query | no | Exchange for the listing. Defaults to the one that listing trades on. | | `from` | string | query | no | Earliest trading date to return, YYYY-MM-DD. | | `to` | string | query | no | Latest trading date to return, YYYY-MM-DD. | | `order` | enum(desc|asc) | query | no | Newest first (desc) or oldest first (asc). Default desc. | | `page` | number | query | no | Page of rows. Default 1. | | `limit` | number | query | no | Rows per page. Default 100, max 2000. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:spdr-gold/holdings-daily?product=gld&exchange=NYSE&from=2026-01-01&to=2026-08-20&order=desc&page=1&limit=100" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:spdr-gold/holdings-daily?product=gld&exchange=NYSE&from=2026-01-01&to=2026-08-20&order=desc&page=1&limit=100", { 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:spdr-gold/holdings-daily?product=gld&exchange=NYSE&from=2026-01-01&to=2026-08-20&order=desc&page=1&limit=100", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "to": "2026-08-20", "from": "2004-11-18", "page": 1, "unit": { "tonnes": "tonnes", "totalNav": "USD", "totalOunces": "troy ounces" }, "count": 100, "items": [ { "date": "2026-08-20", "tonnes": 1038.93, "holiday": false, "midPoint": 415.29, "totalNav": 149711988403.89, "navPerShare": 411.183709, "shareVolume": 13900941, "totalOunces": 33402755.16, "closingPrice": 415.26, "ouncesPerShare": 0.091722, "indicativePrice": 415.184, "premiumDiscount": 0.0255 }, { "date": "2026-08-19", "tonnes": 1034.65, "holiday": false, "midPoint": 413.84, "totalNav": 148356696692.68, "navPerShare": 409.146985, "shareVolume": 17480674, "totalOunces": 33265172.64, "closingPrice": 413.84, "ouncesPerShare": 0.091723, "indicativePrice": 413.677, "premiumDiscount": 0.0394 }, { "date": "2026-08-18", "tonnes": 1025.24, "holiday": false, "midPoint": 398.55, "totalNav": 145122668317.61, "navPerShare": 403.903892, "shareVolume": 10660893, "totalOunces": 32962488.06, "closingPrice": 398.55, "ouncesPerShare": 0.091723, "indicativePrice": 398.613, "premiumDiscount": -0.0158 }, { "date": "2026-08-17", "tonnes": 1030.66, "holiday": false, "midPoint": 405.43, "totalNav": 145967899101.56, "navPerShare": 404.119322, "shareVolume": 9604102, "totalOunces": 33136762.48, "closingPrice": 405.49, "ouncesPerShare": 0.091724, "indicativePrice": 405.356, "premiumDiscount": 0.0183 }, { "date": "2026-08-14", "tonnes": 1023.53, "holiday": false, "midPoint": 401.42, "totalNav": 144465452932.74, "navPerShare": 402.74729, "shareVolume": 6749803, "totalOunces": 32907451.51, "closingPrice": 401.48, "ouncesPerShare": 0.091727, "indicativePrice": 401.304, "premiumDiscount": 0.0289 }, { "date": "2026-08-13", "tonnes": 1023.24, "holiday": false, "midPoint": 398.93, "totalNav": 143844461429.95, "navPerShare": 401.12789, "shareVolume": 8695241, "totalOunces": 32898278.77, "closingPrice": 398.96, "ouncesPerShare": 0.091728, "indicativePrice": 398.793, "premiumDiscount": 0.0344 }, { "date": "2026-08-12", "tonnes": 1025.81, "holiday": false, "midPoint": 404.86, "totalNav": 145976478648.44, "navPerShare": 406.054183, "shareVolume": 10383090, "totalOunces": 32980834.25, "closingPrice": 404.92, "ouncesPerShare": 0.091729, "indicativePrice": 404.798, "premiumDiscount": 0.0153 }, { "date": "2026-08-11", "tonnes": 1022.67, "holiday": false, "midPoint": 400.92, "totalNav": 144107712877.1, "navPerShare": 402.086252, "shareVolume": 7439138, "totalOunces": 32879931.86, "closingPrice": 400.96, "ouncesPerShare": 0.09173, "indicativePrice": 400.851, "premiumDiscount": 0.0172 } ], "order": "desc", "total": 5675, "ticker": "GLD", "dataset": "holdings-daily", "hasMore": true, "product": "gld", "exchange": "NYSE", "nextPage": 2, "provider": "spdr-gold" } ``` --- ### Fund Data SPDR Gold Shares live datapoints — NAV, spot, and the tonnage held in trust. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/finance:spdr-gold/fund-data` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `product` | enum(gld|gldm|o87|gsd|9840|2840|82840|1326) | query | yes | Listing code. gld/gldm on NYSE, o87/gsd on SGX, 9840/2840/82840 on HKeX, 1326 on TSE. | | `exchange` | enum(NYSE|SGX|HKeX|TSE) | query | no | Exchange for the listing. Defaults to the one that listing trades on. | | `lang` | enum(en|zh|ja) | query | no | Response language. Default en. | **cURL:** ```bash curl "https://api.zpi.web.id/v1/finance:spdr-gold/fund-data?product=gld&exchange=NYSE&lang=en" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/finance:spdr-gold/fund-data?product=gld&exchange=NYSE&lang=en", { 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:spdr-gold/fund-data?product=gld&exchange=NYSE&lang=en", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "asOf": "August 20, 2026", "lang": "en", "name": "SPDR Gold Shares", "count": 23, "items": [ { "id": "closeUsd", "date": "August 20, 2026", "value": "US$ 415.26", "numeric": 415.26, "currency": "USD", "direction": 0, "published": true, "upstreamId": "close_usd" }, { "id": "currentIopvUsd", "date": null, "value": "US$ 414.88", "numeric": 414.88, "currency": "USD", "direction": 1, "published": true, "upstreamId": "current_iopv_usd" }, { "id": "dailyVolume", "date": "August 20, 2026", "value": "13,900,941", "numeric": 13900941, "currency": null, "direction": 1, "published": true, "upstreamId": "daily_volume" }, { "id": "delayedIopvUsd", "date": null, "value": "US$ 415.40", "numeric": 415.4, "currency": "USD", "direction": -1, "published": true, "upstreamId": "delayed_iopv_usd" }, { "id": "metalEntitlement", "date": "August 20, 2026", "value": "0.091722", "numeric": 0.091722, "currency": null, "direction": null, "published": true, "upstreamId": "metal_entitlement" }, { "id": "midPointUsd", "date": "August 19, 2026", "value": "US$ 413.84", "numeric": 413.84, "currency": "USD", "direction": 1, "published": true, "upstreamId": "mid_point_usd" }, { "id": "monthlySalesPerShare", "date": "Aug 2026", "value": "US$ 0.12535", "numeric": 0.12535, "currency": "USD", "direction": null, "published": true, "upstreamId": "monthly_sales_per_share" }, { "id": "navShareUsd", "date": "August 20, 2026", "value": "US$ 411.18", "numeric": 411.18, "currency": "USD", "direction": -1, "published": true, "upstreamId": "nav_share_usd" } ], "ticker": "GLD", "dataset": "fund-data", "product": "gld", "exchange": "NYSE", "provider": "spdr-gold" } ``` --- _Generated: 2026-08-21T07:42:54.223Z_