---
title: "Shanghai gold price history"
method: GET
path: "/v1/shanghai/gold/history"
tags: ["Regional"]
---

# Shanghai gold price history

`GET /v1/shanghai/gold/history`

## Request

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

Historical Shanghai gold price series. Gold carries no VAT, so `shanghaiExVat` and `premiumPercentExVat` equal the raw values. Requires the Pro plan or higher.

## Query parameters

- `range` string
- `series` string
- `start` string
- `end` string

## Response `200`

Success.

- object
  - `success` boolean, required
  - `data` object[], required
    - `date` string, date
    - `premium` number
    - `premiumPercent` number
    - `premiumPercentExVat` number
    - `shanghai` number
    - `shanghaiExVat` number
    - `western` number
  - `vatInclusive` boolean
  - `count` number
  - `source` string
  - `series` string
  - `range` object
    - `minDate` string, date
    - `maxDate` string, date
    - `totalRecords` number
  - `requestedRange` object
    - `start` string, date
    - `end` string, date

## 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)