# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/huangjinjiage/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/huangjinjiage/get-brand-gold-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-city-oil-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-domestic-gold-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-gold-recycling-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-hong-kong-gold-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-international-gold-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-international-oil-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/huangjinjiage/get-national-oil-prices-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.