# Orbbit Commodity Metric Values Time Series

> Orbbit Commodity Metric Values Time Series is a paid API for AI agents from data-api.orbbit.co, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Retrieves historical time-series values for commodity metrics, organized in four descriptive layers, over a specified date range.

## Facts

- Endpoint: GET https://data-api.orbbit.co/v1/commodities/metric-values?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orbbit-commodity-metric-values-time-series-e11a27c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WAY0xDyv3ddEdtGscAo9G

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability orbbit-commodity-metric-values-time-series-e11a27c6
```

Example prompt: Pull the monthly metric values for crude oil and natural gas from January 2015 through December 2023 — use their series IDs from the commodities list.

## When to prefer this

Use this endpoint when you need historical time-series values for commodities over a flexible date range, especially when you have series IDs or metric names from the Orbbit commodities catalog. It is the right choice when you need multi-series data (up to 100 at once), support for various frequencies (daily through annual), and structured four-layer metric output. Prefer it over generic market data APIs when you specifically need Orbbit's commodity-centric data model.

## Known failure modes

- Exceeds 100 total series limit when combining ids and metric_names — returns error
- Invalid or unrecognized series IDs or metric names — returns empty or error response
- Malformed date format (not YYYY-MM-DD) — returns validation error
- No data available for the requested date range — returns empty series
- Missing required query params results in default range behavior which may not match expectations

## How this service works

Get the values over time for the series you choose, each described in the same four layers.

## Output

Returns a structured collection of time-series data for each requested commodity series, with values organized across four descriptive layers per series. Each data point includes a date and corresponding metric value, covering the requested date range at the appropriate frequency (daily, weekly, biweekly, monthly, or annual).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "ids": {
       "type": "string",
       "description": "Comma-separated series ids from GET /v1/commodities; with metric_names, at most 100 series in all"
      },
      "end_date": {
       "type": "string",
       "description": "YYYY-MM-DD, inclusive. Absent means up to each series' newest value; without start_date, the default range is counted back from this date"
      },
      "start_date": {
       "type": "string",
       "description": "YYYY-MM-DD, inclusive. Absent means each series starts 1 year (daily, weekly, biweekly), 5 years (monthly) or 10 years (annual) before end_date, or before its newest value; pass an early date such as 1990-01-01 for full history"
      },
      "metric_names": {
       "type": "string",
       "description": "Comma-separated metric names from GET /v1/commodities; with ids, at most 100 series in all"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orbbit-commodity-metric-values-time-series-e11a27c6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data-api.orbbit.co](https://www.zero.xyz/host/data-api.orbbit.co/llms.txt)