huangjinjiage.cn APIhuangjinjiage.cn ↗
Access real-time gold, silver, platinum, and oil prices from huangjinjiage.cn. Covers domestic Chinese, Hong Kong, international markets, and brand jewelry rates.
curl -X GET 'https://api.parse.bot/scraper/608a4f46-c87f-43bf-ad87-30196f433d92/get_city_oil_prices?city_pinyin=beijing' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches today's oil prices for any Chinese city or province by pinyin (e.g., beijing, guangdong, shanghai). Returns gasoline and diesel prices in yuan/liter.
| Param | Type | Description |
|---|---|---|
| city_pinyin | string | City or province name in pinyin (e.g., beijing, shanghai, guangdong, sichuan, chongqing). |
{
"type": "object",
"fields": {
"prices": "object with gasoline_89, gasoline_92, gasoline_95, gasoline_98, diesel_0, diesel_neg_10, diesel_neg_20, diesel_neg_35 (yuan/liter, '-' or empty if unavailable)",
"region": "string, the city_pinyin value"
},
"sample": {
"data": {
"prices": {
"diesel_0": "8.46",
"gasoline_89": "",
"gasoline_92": "8.72",
"gasoline_95": "9.28",
"gasoline_98": "10.78",
"diesel_neg_10": "8.97",
"diesel_neg_20": "9.40",
"diesel_neg_35": ""
},
"region": "beijing"
},
"status": "success"
}
}About the huangjinjiage.cn API
The huangjinjiage.cn API provides 8 endpoints covering real-time commodity prices across gold, silver, platinum, and oil markets in China and internationally. Endpoints like get_brand_gold_prices return per-gram jewelry prices from 12 major Chinese brands, while get_city_oil_prices delivers gasoline and diesel prices broken down by grade for any Chinese city or province using pinyin input. Response fields span everything from COMEX futures to Shanghai Gold Exchange T+D contracts.
Gold and Silver Price Coverage
The get_international_gold_prices endpoint returns five distinct objects: COMEX gold, London spot gold, COMEX silver, London spot silver, and the USD/CNY exchange rate. Each price object includes price, high, low, yesterday_close, change, and update_time, all denominated in USD/oz. The get_domestic_gold_prices endpoint covers Shanghai Gold Exchange instruments — gold_td, silver_td, and au9999 — with prices in CNY/gram (CNY/kg for silver T+D) and per-field timestamps reflecting when market data was last available.
Brand Jewelry and Recycling Prices
get_brand_gold_prices returns today's quoted prices from 12 named Chinese jewelry retailers including 周大福, 老凤祥, 中国黄金, and 菜百首饰. Each brand entry includes an array of product-type objects with product, price (yuan/gram), and time. The get_gold_recycling_prices endpoint separately tracks buyback prices for categories like 22k gold, 999 platinum, and palladium, returning type, price, and purity fields useful for scrap and recycling market monitoring. Hong Kong brand prices are available via get_hong_kong_gold_prices, which returns prices in both HKD/tael and HKD/gram for gold, platinum, and gold bar products.
Oil Price Data by Region and Grade
Oil coverage operates at two levels. get_national_oil_prices_overview returns an array of all Chinese provinces and cities, each with 92#, 95#, 98# gasoline and 0# diesel prices in yuan/liter. For city-level detail, get_city_oil_prices accepts a city_pinyin parameter (e.g., beijing, chongqing, sichuan) and returns eight fuel grades: gasoline_89, gasoline_92, gasoline_95, gasoline_98, diesel_0, diesel_neg_10, diesel_neg_20, and diesel_neg_35. The get_international_oil_prices endpoint covers Brent and WTI crude with USD/barrel pricing, daily change figures, and update timestamps.
- Display live gold jewelry purchase prices per gram for major Chinese retail brands in a consumer app
- Track Shanghai Gold Exchange T+D contract prices alongside London spot gold for arbitrage monitoring
- Build a regional fuel cost calculator using city-level gasoline and diesel grades from get_city_oil_prices
- Monitor gold and platinum recycling buyback rates for scrap metal procurement tools
- Compare COMEX and London spot silver prices in a commodity trading dashboard
- Show Hong Kong gold brand prices in HKD/tael for cross-border price comparison features
- Aggregate national oil price data across all Chinese provinces using get_national_oil_prices_overview
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does huangjinjiage.cn offer an official developer API?+
What does get_city_oil_prices return beyond 92# and 95# gasoline?+
region field echoes back the city_pinyin value you supplied.Does the API cover historical gold or oil prices over time?+
Is palladium price data available as a standalone endpoint?+
get_gold_recycling_prices (alongside gold, 22k gold, and platinum buyback prices), but there is no dedicated spot-price endpoint for palladium trading prices. You can fork this API on Parse and revise it to add a standalone palladium spot-price endpoint.When is the au9999 field in get_domestic_gold_prices absent?+
au9999 object is noted as present only when market data is available, meaning it may be absent outside Shanghai Gold Exchange trading hours or on non-trading days. The gold_td and silver_td objects include a change field and are consistently returned, but their values will reflect the last available session close when the market is closed.