Commodity Price API

By FinanceFlowAPI · Last reviewed November 11, 2026

← All financial data endpoints

Why Use FinanceFlowAPI’s Commodity Price API?

Tracking commodity prices usually means integrating a different exchange feed or data vendor for metals, energy and agriculture separately, each with its own format. The Commodity Price API, a commodity data API for metals, energy and agriculture, normalizes 102 commodities across every major category into one schema and one authentication method, so you can add a new market to your product without a new integration.

• One JSON schema for every commodity: no per-source parsing.
• 102 commodities verified live against production, from gold and crude oil to freight indices.
• A dedicated catalog endpoint to discover the exact commodity names available, instead of guessing spellings.
• Same account, API key and billing as the rest of FinanceFlowAPI: Bonds, Currency, Economic Calendar and Economic Indicators data.

Key Capabilities

• Current price plus five change metrics. Every response includes daily_change, weekly_change_percent, monthly_change_percent, ytd_change_percent and yearly_change_percent alongside the current price, so you get trend context without a second call.
• Query by exact commodity name. Request precisely the market you need, e.g. gold, crude oil, brent.
• Built-in discovery. commodity-catalog lists every commodity name available, so you never have to guess spelling.
• Broad category coverage: precious metals, energy, industrial metals & materials, agriculture and commodity indices in one API.

Gold, Oil & Other Popular Commodity Prices via API

Gold and crude oil are two of the most frequently requested markets on the Commodity Price API, and both use the exact same commodity-spot endpoint as every other commodity, just change the name parameter:

• Gold price API: GET /commodity-spot?api_key=YOUR_API_KEY&name=gold
• Oil price API: crude oil (WTI) via name=crude oil, or Brent via name=brent
• Silver price API: name=silver
• Natural gas price API: name=natural gas

Each of these returns the same response shape as any other commodity: current price, and daily/weekly/monthly/YTD/yearly change. See Response Schema below for the full field list.

Data Coverage & Trust

Data Methodology

Commodity Price API data is aggregated from market and exchange data sources and normalized into one consistent schema (commodity_name, current_price, and five change fields) for every supported commodity, so your integration doesn’t need a different parser per source. Sourced from aggregated third-party market and statistical data providers; the specific vendor and full per-commodity methodology are not published.

Request Example

GET https://financeflowapi.com/api/v1/commodity-spot?api_key=YOUR_API_KEY&name=gold

Response Example

{
  "success": true,
  "code": 200,
  "message": "OK",
  "meta": {
    "timestamp": 1787480152,
    "request_id": "6a8ac858320ea"
  },
  "data": {
    "commodity_name": "gold",
    "current_price": 4607.35,
    "daily_change": "91.57",
    "daily_change_percent": "2.03%",
    "weekly_change_percent": "5.30%",
    "monthly_change_percent": "11.54%",
    "ytd_change_percent": "6.66%",
    "yearly_change_percent": "36.59%",
    "last_updated": "2026-08-21"
  }
}

API Parameters

commodity-spot returns the current price for one commodity:

commodity-catalog lists the available commodity names:

Response Schema

The data object for commodity-spot:

Each item in data for commodity-catalog:

HTTP Status & Errors

Code Examples

curl "https://financeflowapi.com/api/v1/commodity-spot?api_key=YOUR_API_KEY&name=gold"

import requests

url = "https://financeflowapi.com/api/v1/commodity-spot"
params = {
    "api_key": "YOUR_API_KEY",
    "name": "gold"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

const params = new URLSearchParams({
  api_key: "YOUR_API_KEY",
  name: "gold"
});

fetch(`https://financeflowapi.com/api/v1/commodity-spot?${params}`)
  .then(res => res.json())
  .then(data => console.log(data));

<?php
$params = http_build_query([
    'api_key' => 'YOUR_API_KEY',
    'name'    => 'gold',
]);

$response = file_get_contents("https://financeflowapi.com/api/v1/commodity-spot?{$params}");
$data = json_decode($response, true);

print_r($data);

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    params := url.Values{}
    params.Add("api_key", "YOUR_API_KEY")
    params.Add("name", "gold")

    resp, err := http.Get("https://financeflowapi.com/api/v1/commodity-spot?" + params.Encode())
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    var data map[string]interface{}
    json.Unmarshal(body, &data)

    fmt.Println(data)
}

Use Cases

• Trading platforms. Power buy/sell signals and pricing widgets with live gold, oil and metals data.
• Portfolio & risk dashboards. Track commodity exposure alongside Bonds API and equities data.
• Inflation & macro research. Correlate commodity price moves with Economic Indicators API data like CPI and PPI.
• Price alert bots. Trigger notifications when a commodity’s daily_change_percent crosses a threshold.

Who Is This API For?

• Algorithmic and discretionary traders who need live pricing for gold, oil and other markets
• Fintech apps and dashboards that need commodity price context alongside other asset classes
• Publishers and content platforms that need sourced commodity price data
• Procurement and hedging tools monitoring input costs for manufacturing and agriculture businesses

Limitations

• No historical time-series on this endpoint. commodity-spot returns only the current price plus period-over-period % changes, not a date-range history. A separate commodity-history endpoint exists in the API (see the full API documentation) but is not yet covered by its own dedicated landing page.
• name must match the catalog spelling exactly; there is no free-text or fuzzy search.
• Endpoint access and your per-minute rate limit depend on your subscription plan.

Related APIs

• Economic Indicators API. See how commodity prices relate to inflation and other macro indicators.
• Government Bonds API. Track commodity exposure alongside fixed-income data.

Full API documentation →