# Trading Economics API: Get commodity prices

> 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.

Unofficial. Not affiliated with or endorsed by Trading Economics.

- Page: https://fous.com/methods/tradingeconomics.com/get-commodity-prices
- Method: `tradingeconomics.com/get_commodity_prices`, version 1
- Website: tradingeconomics.com
- Returns: commodity, group, price, unit, daily change, daily/weekly/monthly/YTD/yearly percent, price date, page URL
- 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 or group to return, for example "copper", "crude oil", "wheat", or "metals". Leave blank for all groups. Default "". |

## Output

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

```json
{}
```

Its output:

```json
{
  "commodities": [
    {
      "unit": "USD per barrel",
      "group": "Energy",
      "price": 93.978,
      "page_url": "https://tradingeconomics.com/commodity/crude-oil",
      "commodity": "Crude Oil",
      "price_date": "2026-09-29",
      "daily_change": 1.3778,
      "daily_percent": 1.49,
      "weekly_percent": 3.8199,
      "yearly_percent": 50.6779,
      "monthly_percent": 9.5823,
      "year_to_date_percent": 63.6674
    },
    {
      "unit": "USD per barrel",
      "group": "Energy",
      "price": 106.942,
      "page_url": "https://tradingeconomics.com/commodity/brent-crude-oil",
      "commodity": "Brent",
      "price_date": "2026-09-29",
      "daily_change": 1.6624,
      "daily_percent": 1.58,
      "weekly_percent": 7.7505,
      "yearly_percent": 61.9603,
      "monthly_percent": 18.1815,
      "year_to_date_percent": 75.7476
    },
    {
      "unit": "USD per million British thermal units",
      "group": "Energy",
      "price": 3.1377,
      "page_url": "https://tradingeconomics.com/commodity/natural-gas",
      "commodity": "Natural gas",
      "price_date": "2026-09-29",
      "daily_change": 0.0317,
      "daily_percent": 1.02,
      "weekly_percent": 5.8246,
      "yearly_percent": -5.0045,
      "monthly_percent": 6.9063,
      "year_to_date_percent": -14.8752
    }
  ]
}
```

## 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":"tradingeconomics.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 the current price of copper and how much has it moved this week and year-to-date?
- Pull the latest energy commodity prices from tradingeconomics.com, including Brent, WTI and natural gas with their daily percent changes
- Show me today's wheat price per bushel along with its monthly and yearly performance
- I need a full snapshot of all commodity groups on Trading Economics right now, electricity included
- How are gold, silver and the other metals doing today? Give me prices, units and daily changes.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "default": "",
      "description": "Commodity name or group to return, for example \"copper\", \"crude oil\", \"wheat\", or \"metals\". Leave blank for all groups."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "commodities"
  ],
  "properties": {
    "commodities": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "commodity",
          "group",
          "price",
          "unit",
          "daily_change",
          "daily_percent",
          "weekly_percent",
          "monthly_percent",
          "year_to_date_percent",
          "yearly_percent",
          "price_date",
          "page_url"
        ],
        "properties": {
          "unit": {
            "type": [
              "string",
              "null"
            ]
          },
          "group": {
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "page_url": {
            "type": "string",
            "format": "uri"
          },
          "commodity": {
            "type": "string"
          },
          "price_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "daily_change": {
            "type": [
              "number",
              "null"
            ]
          },
          "daily_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "weekly_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "yearly_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "monthly_percent": {
            "type": [
              "number",
              "null"
            ]
          },
          "year_to_date_percent": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Trading Economics API: Get country economic overview](https://fous.com/methods/tradingeconomics.com/get-country-overview.md): Returns seven key economic indicators for a country from its public Trading Economics overview: GDP growth rate, inflation rate, interest rate, unemployment rate, government debt to GDP, currency and stock market. Indicators absent from the overview are null; the US dollar index is not reported as a USD exchange rate.
- [Trading Economics API: List countries by indicator](https://fous.com/methods/tradingeconomics.com/list-countries-by-indicator.md): Compares the latest reported value of an economic indicator across countries in a region, highest first. World includes all listed countries; Australia uses the Oceania region.
- [Investing.com API: Get commodity prices](https://fous.com/methods/investing.com/get-commodity-prices.md): 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.
- [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.
- [EIA API: Get electricity prices](https://fous.com/methods/eia.gov/get-electricity-prices.md): Gets a state's latest monthly electricity price for a customer type from EIA. It also returns the year-over-year change, the year-to-date average and the matching US average.
- [Binance API: Get coin price](https://fous.com/methods/binance.com/get-coin-price.md): Gets a Binance spot pair's latest price and rolling 24-hour trading statistics from a coin name or symbol. Only currently trading pairs are available.
- [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap.
- [All Trading Economics methods](https://fous.com/methods/tradingeconomics.com.md)
