# Huangjinjiage — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track real-time and historical prices for gold, silver, platinum, palladium, and oil across China and international markets. Monitor domestic oil prices by region, compare international commodity prices, and access current gold recycling rates and brand-specific pricing.

**Category:** Finance & Markets | **Website:** [huangjinjiage.cn/](https://huangjinjiage.cn/) | **Docs:** [parse.bot/marketplace/14e650c5-ac1e-4165-bdb0-d756b0351381/huangjinjiage-cn-api](https://parse.bot/marketplace/14e650c5-ac1e-4165-bdb0-d756b0351381/huangjinjiage-cn-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_brand_gold_prices

Fetches today's gold jewelry brand prices for major Chinese brands including 周大福, 周生生, 六福珠宝, 谢瑞麟, 金至尊, 潮宏基, 老凤祥, 老庙黄金, 菜百首饰, 周六福, 中国黄金, 周大生. Returns each brand's product prices in yuan/gram.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_brand_gold_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_city_oil_prices

Fetches today's oil prices for a specific Chinese city or province by pinyin. Returns all available gasoline grades (89#, 92#, 95#, 98#) and diesel grades (0#, -10#, -20#, -35#) in yuan/liter. Empty string indicates price unavailable for that grade.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_pinyin` | string | No | City or province name in pinyin (e.g., beijing, shanghai, guangdong, sichuan, chongqing, dongguan). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_city_oil_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_pinyin":"<string>"}'
```

### get_domestic_gold_prices

Fetches domestic Chinese gold prices including Shanghai Gold T+D, Silver T+D, and AU9999 when available. Prices are in CNY/gram for gold and CNY/kg for silver.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_domestic_gold_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_gold_recycling_prices

Fetches today's gold, platinum, palladium, and silver recycling/buyback prices in yuan/gram. Covers various purities including 24k gold, 22k, 18k, 14k, 999 platinum, 999 palladium, and 999 silver.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_gold_recycling_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hong_kong_gold_prices

Fetches Hong Kong gold prices for major brands (HKD/tael and HKD/gram), including gold, platinum, and gold bar prices. Covers brands such as 周大福, 周生生, 谢瑞麟, 金至尊, 六福珠宝, and 老凤祥.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_hong_kong_gold_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_international_gold_prices

Fetches international gold and silver spot prices and COMEX futures in USD/oz, plus the USD/CNY exchange rate. Returns a snapshot with London spot gold/silver, COMEX gold/silver futures, and current exchange rate.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_international_gold_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_international_oil_prices

Fetches international crude oil prices (Brent and WTI) in USD/barrel with real-time updates. Returns the latest price, change from yesterday's close, and update timestamp for each contract.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_international_oil_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_national_oil_prices_overview

Fetches the national oil price overview table for all provinces and cities in China. Returns an array of region entries with 92#, 95#, 98# gasoline and 0# diesel prices in yuan/liter.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huangjinjiage-cn-api-14e650c5/get_national_oil_prices_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```