GFEX API lithium, silicon and platinum data from Guangzhou

Registered warehouse receipts from the Guangzhou Futures Exchange for lithium carbonate, industrial silicon and polysilicon, per warehouse and per day. It is Chinese battery and solar supply-chain inventory that the exchange publishes only in Chinese. GFEX platinum and palladium settlements and premiums come with it.

Lithium carbonate receipts since December 2023, industrial silicon since June 2023 and polysilicon since April 2025
Per warehouse by default, or the exchange-wide daily totals with type=totals
GFEX platinum and palladium settlement prices and their premium over Western pricing
Included from Ultimate ($249 a month)

See plans and pricing Get a free key Read the docs

GET /v1/gfex/receipts?symbol=LC&type=totals

curl -H "Authorization: Bearer mc_live_YOUR_KEY" \
  "https://api.metalcharts.org/v1/gfex/receipts?symbol=LC&type=totals"

The exchange-wide daily total of registered lithium carbonate receipts. Drop type=totals for the per-warehouse breakdown on the latest date, or pass date for a specific day.

2023

Receipts history from

100+

Warehouses tracked

Contracts covered

Ultimate

Plan that includes it

Endpoints

GFEX API endpoints

Every endpoint below needs Ultimate ($249 a month) or higher. Requests use the same key and bearer header as the rest of the API.

Endpoint	Returns	From
GET/v1/gfex/receipts	Registered warehouse receipts per warehouse and per day, or daily totals with type=totals	Ultimate
GET/v1/gfex/receipts/coverage	Which symbols are covered, how many warehouses each spans and the date range held	Ultimate
GET/v1/gfex/settlement	GFEX platinum and palladium settlement price history	Ultimate
GET/v1/gfex/premium	GFEX platinum and palladium premium over Western pricing	Ultimate

Response

What /v1/gfex/receipts returns

Field names exactly as the API sends them, from the published OpenAPI specification.

Field	Meaning
symbol	At the top of the response: LC (lithium carbonate), SI (industrial silicon), PS (polysilicon), XPT or XPD
date	The trading day
warehouse	The exchange's own warehouse name, passed through unaltered so it matches exchange notices
registered, cancelled	Receipts registered and cancelled that day
quantity, change	Receipts held at the close, and the change from the previous day
total	At the top of the response: the exchange-wide figure for the day

Code

Call it from Python or JavaScript

No SDK to install: an HTTPS GET with your key in the Authorization header.

Python

import requests

resp = requests.get(
    "https://api.metalcharts.org/v1/gfex/receipts?symbol=LC&type=totals",
    headers={"Authorization": "Bearer mc_live_YOUR_KEY"},
    timeout=10,
)
resp.raise_for_status()
print(resp.json()["data"])

JavaScript

const resp = await fetch("https://api.metalcharts.org/v1/gfex/receipts?symbol=LC&type=totals", {
  headers: { Authorization: "Bearer mc_live_YOUR_KEY" },
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const { data } = await resp.json();
console.log(data);

FAQ

GFEX API questions

Which GFEX contracts have warehouse receipts?

Lithium carbonate (LC) since December 2023, industrial silicon (SI) since June 2023, polysilicon (PS) since April 2025, and platinum (XPT) and palladium (XPD) since May 2026. /v1/gfex/receipts/coverage lists the symbols, the warehouses each spans and the dates held.

Are the warehouse names translated?

No. They are the exchange's own names, passed through unaltered, because they are identifiers you match against GFEX notices.

Can I get one number per day instead of every warehouse?

Yes. type=totals returns the exchange-wide daily series. Without it the response is the per-warehouse breakdown for the latest date, or for the date you pass.

On metalcharts.org

See the same data as charts

More data

Other exchange data, same API

Start with Ultimate

GFEX data is included from Ultimate ($249 a month). Every plan, Free included, can call the live price endpoints.

See plans and pricing See the full API