# Investing.com API: Get commodity prices

> Gets current quoted prices for energy, metals, and agricultural commodities from Investing.com's real-time futures page, optionally for one commodity. Some quotes may be delayed or indicative; units are null when the contract specification is missing.

Unofficial. Not affiliated with or endorsed by Investing.com.

- Page: https://fous.com/methods/investing.com/get-commodity-prices
- Method: `investing.com/get_commodity_prices`, version 1
- Website: investing.com
- Returns: commodity, group, contract month, last price, currency, unit, change, change percent, day high/low, price time, page link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `commodity` | string | no |  | Commodity name, such as Brent oil or gold. Leave blank for all major commodities on the page. Default "". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "commodity_prices": [
    {
      "unit": "USD per barrel",
      "group": "energy",
      "change": 1.46,
      "day_low": 97.87,
      "currency": "USD",
      "day_high": 99.6,
      "commodity": "Brent Oil",
      "page_link": "https://www.investing.com/commodities/brent-oil",
      "last_price": 99.29,
      "price_time": "2026-09-29T03:00:15+00:00",
      "change_percent": 1.49,
      "contract_month": "Dec 26"
    },
    {
      "unit": "USD per barrel",
      "group": "energy",
      "change": 1.22,
      "day_low": 93.02,
      "currency": "USD",
      "day_high": 94.01,
      "commodity": "Crude Oil WTI",
      "page_link": "https://www.investing.com/commodities/crude-oil",
      "last_price": 93.82,
      "price_time": "2026-09-29T03:00:11+00:00",
      "change_percent": 1.32,
      "contract_month": "Nov 26"
    },
    {
      "unit": null,
      "group": "energy",
      "change": -1.787,
      "day_low": 71.65,
      "currency": null,
      "day_high": 71.775,
      "commodity": "Dutch TTF Natural Gas",
      "page_link": "https://www.investing.com/commodities/ice-dutch-ttf-gas-c1-futures",
      "last_price": 71.65,
      "price_time": "2026-09-29T02:02:14+00:00",
      "change_percent": -2.43,
      "contract_month": "Oct 26"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"investing.com/get_commodity_prices","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's Brent crude trading at right now, and how much has it moved today?
- Pull current futures quotes for all the major energy, metals, and agricultural commodities from investing.com
- Give me the latest gold futures price, including the contract month and today's high and low
- How are coffee and cocoa prices doing today? I need percent change and last price.
- Check investing.com for the current natural gas futures quote and the time it was last updated

## Input schema

```json
{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "default": "",
      "description": "Commodity name, such as Brent oil or gold. Leave blank for all major commodities on the page."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "commodity_prices"
  ],
  "properties": {
    "commodity_prices": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "commodity",
          "group",
          "contract_month",
          "last_price",
          "currency",
          "unit",
          "change",
          "change_percent",
          "day_high",
          "day_low",
          "price_time",
          "page_link"
        ],
        "properties": {
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Price denomination per physical unit."
          },
          "group": {
            "type": "string",
            "description": "Energy, metals, or agriculture."
          },
          "change": {
            "type": [
              "number",
              "null"
            ],
            "description": "Change in the quoted price units."
          },
          "day_low": {
            "type": [
              "number",
              "null"
            ],
            "description": "Lowest quoted price today."
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Three-letter currency code for the quoted price."
          },
          "day_high": {
            "type": [
              "number",
              "null"
            ],
            "description": "Highest quoted price today."
          },
          "commodity": {
            "type": "string",
            "description": "Commodity name as displayed on the page."
          },
          "page_link": {
            "type": "string",
            "description": "Investing.com page for this commodity."
          },
          "last_price": {
            "type": [
              "number",
              "null"
            ],
            "description": "Last quoted price in the stated currency and unit."
          },
          "price_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Last price update time as ISO 8601 with offset."
          },
          "change_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Percentage change in percentage points."
          },
          "contract_month": {
            "type": [
              "string",
              "null"
            ],
            "description": "Displayed futures contract month, if shown."
          }
        },
        "additionalProperties": false
      },
      "description": "Commodity prices grouped by category."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Investing.com API: Get government bond yields](https://fous.com/methods/investing.com/get-bond-yields.md): Gets current government bond yields from Investing.com's world government bonds table, optionally filtered by country and maturity term.
- [Investing.com API: Get economic calendar](https://fous.com/methods/investing.com/get-economic-calendar.md): Lists scheduled and recent economic releases from the Investing.com economic calendar for a date range (up to 31 days, default this week), countries and importance, with actual, forecast and previous values as displayed, in the requested time zone.
- [Trading Economics API: Get commodity prices](https://fous.com/methods/tradingeconomics.com/get-commodity-prices.md): Gets current commodity prices and price movements from the Trading Economics commodities page, in the page's group order; filter by a commodity name, slug, symbol or group (e.g. copper, energy), or leave blank for all groups including Electricity.
- [Macrotrends API: Get long-term price history](https://fous.com/methods/macrotrends.net/get-long-term-price-history.md): Gets decades of yearly commodity or stock-index price history from Macrotrends: yearly average, open, high, low, close, annual change and inflation-adjusted value for gold, silver, crude oil, natural gas, copper, Dow Jones, S&P 500 and Nasdaq. The current year may be incomplete.
- [Kitco API: Get precious metal prices](https://fous.com/methods/kitco.com/get-precious-metal-prices.md): Gets Kitco spot bid, ask, daily change and range for gold, silver, platinum or palladium. Non-USD prices use Kitco's current exchange rate, so converted daily changes are not adjusted for exchange-rate moves since the prior close.
- [Google API: Get quote](https://fous.com/methods/google.com/get-quote.md): Gets the current quoted price and key figures for a stock, fund, index, or cryptocurrency on Google Finance, by name or ticker. Prices may be delayed, and figures Google does not show are null.
- [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed.
- [Twelve Data API: Get quote](https://fous.com/methods/twelvedata.com/get-quote.md): Gets the latest stock, ETF, forex or crypto quote for a symbol from Twelve Data. Some instruments do not report currency or volume; the demo key covers only a few symbols.
- [All Investing.com methods](https://fous.com/methods/investing.com.md)
