> ## Documentation Index
> Fetch the complete documentation index at: https://www.diadata.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Commodities

> Returns the latest price of a commodity in USD.

## Path Parameter

<ParamField path="CommoditySymbol" type="string" required>
  Commodity symbol e.g. XAU-USD (Gold)
</ParamField>

<Accordion title="Available commodities">
  1. XAU/USD (Gold)
  2. XAGG/USD (Silver)
  3. XG/USD (Copper)
</Accordion>

<ResponseExample>
  ```json Sample Response theme={"system"}
  {
    "Ticker": "XAU-USD",
    "Name": "Gold Spot / US Dollar",
    "Price": 2925.88989,
    "Timestamp": "2025-02-17T20:00:00Z"
  }
  ```
</ResponseExample>

<Warning>
  As part of our migration to DIA's next-generation oracle infrastructure, Lumina, the hosted DIA REST API is being deprecated and will be discontinued on **20 December 2026**. This affects the REST endpoints under `https://api.diadata.org/v1`.

  If your protocol relies on these, please email [support@diadata.org](mailto:support@diadata.org) and confirm that you are using them. We will provide you with a migration path so you can continue accessing the same data through Lumina without interruption. Integrations that don't reach out may lose access after the deprecation date.
</Warning>