Skip to main content
GET
/
openapi
/
v1
/
commodities
/
featured
Featured commodities
curl --request GET \
  --url https://api.hayinsights.com/openapi/v1/commodities/featured \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "statusCode": 200,
  "data": [
    {
      "id": "gold",
      "name": "Gold",
      "unit": "USD/oz",
      "lastClose": 4189.22,
      "currency": "USD",
      "change1dPct": 0.02,
      "changeValue": 0.77,
      "trendline": [
        4258.86,
        4188.45,
        4189.22
      ]
    },
    {
      "id": "wti-crude",
      "name": "WTI Crude Oil",
      "unit": "USD/bbl",
      "lastClose": 76.55,
      "currency": "USD",
      "change1dPct": -0.33,
      "changeValue": -0.25,
      "trendline": [
        76.6,
        76.8,
        76.55
      ]
    }
  ],
  "meta": {
    "timestamp": "2026-06-19T08:50:00.811Z"
  }
}

Authorizations

X-API-Key
string
header
required

Your HayInsights API key (prefixed apk_). Create and manage keys in the HayInsights dashboard (Account → API keys).

Send it in the X-API-Key header on every request to /openapi/v1/*. Which data domains you may access and your request quota are both governed by the subscription plan attached to the key — see the Plans & features and Rate limits guides.

Response

List of featured commodities.

Standard success envelope shared by every endpoint. Each operation's response wrapper extends this (via allOf) and adds a typed data property.

success
boolean
required

Always true for a successful response.

Example:

true

statusCode
integer
required

Mirrors the HTTP status code.

Example:

200

data
object[]
required
meta
object

Response metadata. Always present; timestamp is the server time the response was generated.