---
title: "Multi-commodity market brief"
method: GET
path: "/v1/market-brief"
tags: ["Market Brief"]
---

# Multi-commodity market brief

`GET /v1/market-brief`

Compact multi-commodity snapshot for agents and MCP clients: latest price, 24h change,
and a 1-month forecast per commodity, plus optional spreads and macro context.
The `codes` parameter is REQUIRED (comma-separated commodity codes).

## Query parameters

- `codes` string, required
- `narrative` boolean

## Response `200`

Market brief

- object
  - `status` string
  - `data` object
    - `as_of` string, date-time
    - `codes` string[]
    - `commodities` object[]
      - `code` string
      - `name` string
      - `price` number, float
      - `currency` string
      - `unit` string
      - `change_24h_pct` number, float, nullable
      - `change_24h_abs` number, float, nullable
      - `as_of` string, date-time
      - `source` string
      - `stale` boolean
      - `forecast_1m` object, nullable
        - `point` number, float
        - `low` number, float
        - `high` number, float
        - `confidence` number, float
    - `spreads` object[]
    - `context` object, nullable — Present only when `narrative=true`.

## Other responses

- `400` — Missing/invalid `codes` parameter (`{"status":"fail","data":{"error":"VALIDATION_ERROR",...}}`).
- `401` — Unauthorized
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/revisions/5a5ce424cacc/schema)