---
title: "Get historical benchmark prices for requested metals"
method: GET
path: "/api/v1/Metals/benchmark/history"
tags: ["Metals"]
---

# Get historical benchmark prices for requested metals

`GET /api/v1/Metals/benchmark/history`

Historical OHLC data for the specified period and interval size

The combination of the interval parameter and start and end dates can result in results
being truncated to conform to result size limits. See comments on interval parameter for details on valid interval values.

The historicalfx flag is used to determine whether to apply today's fx rates to a historical period, or to apply the historical rates from that same time frame.

## Query parameters

- `metals` string, required
- `start` string, date-time, required
- `end` string, date-time
- `interval` string
- `historicalfx` boolean
- `currency` string
- `unitofmeasure` 'mg' | 'g' | 'kg' | 'gr' | 'toz' | 'ct' | 'dwt'
- `format` 'json' | 'xml'

## Response `200`

OK

- IntervalCollectionResponse[]
  - `requestedSymbol` string, nullable
  - `requestedCurrency` string, nullable
  - `requestedUnitOfMeasure` string, nullable
  - `success` boolean
  - `error` string, nullable
  - `data` IntervalCollection
    - `symbol` string, nullable
    - `name` string, nullable
    - `baseCurrency` string, nullable
    - `intervals` Interval[], nullable
      - `start` string, date-time
      - `end` string, date-time
      - `open` number, double, nullable
      - `high` number, double, nullable
      - `low` number, double, nullable
      - `last` number, double, nullable
      - `change` number, double, nullable
      - `changePercent` number, double, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/nfusionsolutions/apis/nfusion-solutions-market-data-api.md) · [All operations](https://skmtc.dev/nfusionsolutions/apis/nfusion-solutions-market-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nfusionsolutions/nfusion-solutions-market-data-api/revisions/e29982cd1e0a/schema)