---
title: "Latest Shanghai prices and premiums"
method: GET
path: "/v1/shanghai/"
tags: ["Regional"]
---

# Latest Shanghai prices and premiums

`GET /v1/shanghai/`

## Request

- Base URL: `https://api.metalcharts.org`
- URL: `https://api.metalcharts.org/v1/shanghai/`
- Auth: none declared

Latest Shanghai Gold Exchange spot prices and premium to Western pricing. `price` is USD per troy ounce, `priceCNY` is in the exchange's native unit (CNY/kg for silver, CNY/g for gold), and `exchangeRate` is USD/CNY. Shanghai silver prices (SGE and SHFE) include China's VAT and are returned as quoted; `priceExVat`, `priceCNYExVat` and `premiumPercentExVat` strip it at `vatRate`, and `vatInclusive` says whether a price carries VAT. Gold carries none, so its ex-VAT fields equal the raw ones.

## Query parameters

- `symbols` string
- `type` string
- `series` string

## Response `200`

Success.

- object
  - `success` boolean, required
  - `data` object, required
    - `XAU` object
      - `symbol` string
      - `exchange` string
      - `marketType` string
      - `price` number
      - `priceCNY` number
      - `timestamp` string, date-time
      - `exchangeRate` number
      - `source` string
      - `vatInclusive` boolean
      - `vatRate` number
      - `priceExVat` number
      - `priceCNYExVat` number
      - `premiumPercent` number
      - `premiumPercentExVat` number
    - `XAG` object
      - `symbol` string
      - `exchange` string
      - `marketType` string
      - `price` number
      - `priceCNY` number
      - `timestamp` string, date-time
      - `exchangeRate` number
      - `source` string
      - `vatInclusive` boolean
      - `vatRate` number
      - `priceExVat` number
      - `priceCNYExVat` number
      - `premiumPercent` number
      - `premiumPercentExVat` number
  - `count` number
  - `source` string
  - `series` string
  - `cacheAge` number
  - `isStale` boolean
  - `timestamp` string, date-time

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/metalcharts/apis/metalcharts-api.md) · [All operations](https://skmtc.dev/metalcharts/apis/metalcharts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metalcharts/apis/metalcharts-api/revisions/53d6a0af0479?raw)