{"uid":"cap_WAY0xDyv3ddEdtGscAo9G","slug":"orbbit-commodity-metric-values-time-series-e11a27c6","name":"Orbbit Commodity Metric Values Time Series","description":"Get the values over time for the series you choose, each described in the same four layers.","url":"https://data-api.orbbit.co/v1/commodities/metric-values?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XieaQUGifx4fZmib04zWm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical time-series values for commodity metrics, organized in four descriptive layers, over a specified date range.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Historical commodity price research","prompt":"Get me the full history of gold price metric values going back to 1990 — I need annual data for the entire available range."},{"title":"Multi-commodity trend comparison","prompt":"Fetch the weekly metric values for wheat, corn, and soybeans from 2018-01-01 to 2023-12-31 so I can compare their price movements side by side."},{"title":"Recent commodity snapshot","prompt":"What are the daily metric values for Brent crude oil over the past year up to today? Use the series IDs for Brent from the commodities list."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:43.366Z","isFirstParty":false,"canonicalSlug":"orbbit-commodity-metric-values-time-series-e11a27c6"}