---
title: "Sector snapshot"
method: GET
path: "/v1/snapshot/{sector}"
---

# Sector snapshot

`GET /v1/snapshot/{sector}`

## Request

- Base URL: `https://api.commodities.sh`
- URL: `https://api.commodities.sh/v1/snapshot/{sector}`
- Auth: none declared

energy|metals|ags snapshot

## Path parameters

- `sector` string, required

## Response `200`

Observation or bundle JSON

- Observation
  - `instrument` string, required
  - `value` number, required
  - `unit` string, required
  - `as_of` string, date, required
  - `observed_at` string, date-time
  - `freshness_class` 'eod' | 'weekly' | 'monthly' | 'decree' | 'intraday' | 'delayed', required
  - `quality` 'official' | 'indicative' | 'derived' | 'delayed'
  - `derived` boolean, required
  - `source` object, required
    - `name` string
    - `series_id` string
    - `url` string
  - `license_tag` string, required
  - `provenance` object
    - `retrieved_at` string, date-time
    - `cache_hit` boolean
    - `cache_ttl_s` number

## Other responses

- `402`: Payment Required (x402)

---

[API](https://skmtc.dev/commodities/apis/commodities-sh.md) · [All operations](https://skmtc.dev/commodities/apis/commodities-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/commodities/apis/commodities-sh/revisions/df6736dfcf3c?raw)