Primary Source Commodities
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
Should I use this
Quality & Safety
B
Findings (11)
- LOWTool 'catalog.list' doesn't follow camelCase/snake_casein catalog.list
- LOWTool 'price.latest' doesn't follow camelCase/snake_casein price.latest
- LOWTool 'inventory.get' doesn't follow camelCase/snake_casein inventory.get
- LOWTool 'positioning.get' doesn't follow camelCase/snake_casein positioning.get
- LOWTool 'spread.get' doesn't follow camelCase/snake_casein spread.get
- LOWTool 'price.history' doesn't follow camelCase/snake_casein price.history
- LOWTool 'fx.latest' doesn't follow camelCase/snake_casein fx.latest
- LOWTool 'fundamentals.get' doesn't follow camelCase/snake_casein fundamentals.get
- LOWTool 'snapshot.get' doesn't follow camelCase/snake_casein snapshot.get
- LOWTool 'calendar.get' doesn't follow camelCase/snake_casein calendar.get
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~11,831Tokens (tool definitions)
~13.5 KBTypical response size
Significant attention impact (9.24% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"commodities-sh": {
"url": "https://api.commodities.sh/api/mcp"
}
}
}Remote endpoints
https://api.commodities.sh/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢catalog.list
List every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata. Call this first to discover valid codes before price.latest or inventory.get. Free discovery tool — no payment required.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"instruments": {
"type": "array",
"description": "Instrument registry rows",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Display name"
},
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags",
"fx"
],
"description": "Sector grouping"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"venue": {
"type": "string",
"description": "Trading venue when known"
},
"primary_series_id": {
"type": "string",
"description": "Primary source series id"
},
"primary_source": {
"type": "string",
"description": "Primary source name, e.g. EIA or FRED"
},
"freshness_class": {
"type": "string",
"description": "Expected freshness class"
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"cot_commodity_hint": {
"type": "string",
"description": "CFTC commodity hint when applicable"
}
},
"required": [
"code",
"name",
"sector",
"unit",
"primary_series_id",
"primary_source",
"freshness_class",
"license_tag"
]
}
}
},
"required": [
"instruments"
]
}🟢price.latest(code)
Return the latest cash/fundies observation for one instrument code. Use catalog.list to discover codes such as CL, GC, or ZC. Response follows the shared observation contract with provenance and license tags.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, GC, ZC."
}
},
"required": [
"code"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
}🟢inventory.get(series)
Fetch EIA weekly petroleum inventory levels. Omit series to list all latest inventory points, or pass a series key to get week-over-week change, vs-5y deviation, and a surprise label for that series.
Input Schema
{
"type": "object",
"properties": {
"series": {
"type": "string",
"description": "Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
]
},
"description": "All latest inventory points when series is omitted"
},
"latest": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"description": "Latest point when a series key is provided"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change when series is provided"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average when series is provided"
},
"surprise_label": {
"type": "string",
"description": "Surprise classification when series is provided"
}
}
}🟢positioning.get(code)
Return the latest CFTC Commitments of Traders managed-money positioning for an instrument code. Includes long, short, net, and week-over-week net change with source URL.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, NG, GC, ZC."
}
},
"required": [
"code"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "COT row id"
},
"instrument": {
"type": "string",
"description": "Instrument code"
},
"report_date": {
"type": "string",
"description": "CFTC report date"
},
"commodity_name": {
"type": "string",
"description": "CFTC commodity name"
},
"mm_long": {
"type": "number",
"description": "Managed-money long contracts"
},
"mm_short": {
"type": "number",
"description": "Managed-money short contracts"
},
"mm_net": {
"type": "number",
"description": "Managed-money net contracts"
},
"mm_net_change": {
"type": "number",
"description": "Week-over-week change in managed-money net"
},
"source_url": {
"type": "string",
"description": "CFTC source URL"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"instrument",
"report_date",
"commodity_name",
"mm_long",
"mm_short",
"mm_net",
"mm_net_change",
"source_url",
"observed_at"
]
}🟢spread.get(type, root)
Compute a derived spread observation: 3-2-1 crack, soybean crush, WTI-Brent basis, or calendar (calendar requires licensed curve data and may return available=false). Prefer crack/crush/basis for live derived values with formula and inputs.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"crack",
"crush",
"basis",
"calendar"
],
"description": "Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack."
},
"root": {
"type": "string",
"description": "Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis."
}
},
"required": [
"type"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
},
"available": {
"type": "boolean",
"description": "False when the spread cannot be computed"
},
"note": {
"type": "string",
"description": "Explanation when unavailable or partially degraded"
},
"root": {
"type": "string",
"description": "Calendar root when type=calendar"
},
"legs_quality": {
"type": "array",
"description": "Per-leg quality when inputs are mixed",
"items": {
"type": "object",
"properties": {
"instrument": {
"type": "string"
},
"quality": {
"type": "string"
}
},
"required": [
"instrument",
"quality"
]
}
}
}
}🟢price.history(code, limit)
Return historical observations for an instrument code (up to 500 points). Use after price.latest when you need a short time series for the same code.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, GC, ZC."
},
"limit": {
"type": "number",
"description": "Number of historical points to return. Max 500, default 60."
}
},
"required": [
"code"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"instrument": {
"type": "string",
"description": "Instrument code"
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"count": {
"type": "number",
"description": "Number of points returned"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"description": "Historical observations, newest first or as stored"
}
},
"required": [
"instrument",
"series_id",
"count",
"data"
]
}🟢fx.latest(pair)
Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.
Input Schema
{
"type": "object",
"properties": {
"pair": {
"type": "string",
"description": "FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS."
}
},
"required": [
"pair"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
}🟢fundamentals.get(kind)
Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries. Choose kind based on the ags/metals question you are answering.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"wasde",
"crop_progress",
"export_sales",
"usgs"
],
"description": "Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates."
}
},
"required": [
"kind"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Document id"
},
"kind": {
"type": "string",
"enum": [
"wasde",
"crop_progress",
"export_sales",
"usgs"
],
"description": "Report kind echoed from the request"
},
"as_of": {
"type": "string",
"description": "Report as-of date"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when retrieved"
},
"payload": {
"type": "object",
"description": "Kind-specific payload (quality, note, license_tag, freshness_class, and report fields)"
}
},
"required": [
"id",
"kind",
"as_of",
"observed_at",
"payload"
]
}🟢snapshot.get(sector)
Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors. Prefer this over calling many single-observation tools when you need a full sector picture.
Input Schema
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags",
"all"
],
"description": "Sector to snapshot. Use all to receive energy, metals, and ags together."
}
},
"required": [
"sector"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags"
],
"description": "Present for single-sector responses"
},
"as_of": {
"type": "string",
"description": "Snapshot as-of timestamp"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"description": "Latest prices for the sector"
},
"freshness_note": {
"type": "string",
"description": "Freshness summary"
},
"inventory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
]
},
"description": "Inventory rows when relevant"
},
"crack_321": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"cot": {
"type": "array",
"items": {
"type": "object"
},
"description": "COT rows when relevant"
},
"wasde": {
"type": "object",
"description": "WASDE payload when relevant"
},
"crop_progress": {
"type": "object",
"description": "Crop progress when relevant"
},
"export_sales": {
"type": "object",
"description": "Export sales when relevant"
},
"crush": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"sectors": {
"type": "object",
"description": "Present when sector=all",
"properties": {
"energy": {
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags"
],
"description": "Sector covered by this snapshot"
},
"as_of": {
"type": "string",
"description": "Snapshot as-of timestamp"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"description": "Latest prices for the sector"
},
"freshness_note": {
"type": "string",
"description": "Freshness summary note"
},
"inventory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
]
},
"description": "Inventory points when relevant"
},
"crack_321": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"cot": {
"type": "array",
"items": {
"type": "object"
},
"description": "COT positioning rows when relevant"
},
"wasde": {
"type": "object",
"description": "WASDE payload when relevant"
},
"crop_progress": {
"type": "object",
"description": "Crop progress payload when relevant"
},
"export_sales": {
"type": "object",
"description": "Export sales payload when relevant"
},
"crush": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
]
},
"metals": {
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags"
],
"description": "Sector covered by this snapshot"
},
"as_of": {
"type": "string",
"description": "Snapshot as-of timestamp"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"description": "Latest prices for the sector"
},
"freshness_note": {
"type": "string",
"description": "Freshness summary note"
},
"inventory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
]
},
"description": "Inventory points when relevant"
},
"crack_321": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"cot": {
"type": "array",
"items": {
"type": "object"
},
"description": "COT positioning rows when relevant"
},
"wasde": {
"type": "object",
"description": "WASDE payload when relevant"
},
"crop_progress": {
"type": "object",
"description": "Crop progress payload when relevant"
},
"export_sales": {
"type": "object",
"description": "Export sales payload when relevant"
},
"crush": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
]
},
"ags": {
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags"
],
"description": "Sector covered by this snapshot"
},
"as_of": {
"type": "string",
"description": "Snapshot as-of timestamp"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"description": "Latest prices for the sector"
},
"freshness_note": {
"type": "string",
"description": "Freshness summary note"
},
"inventory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
]
},
"description": "Inventory points when relevant"
},
"crack_321": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"cot": {
"type": "array",
"items": {
"type": "object"
},
"description": "COT positioning rows when relevant"
},
"wasde": {
"type": "object",
"description": "WASDE payload when relevant"
},
"crop_progress": {
"type": "object",
"description": "Crop progress payload when relevant"
},
"export_sales": {
"type": "object",
"description": "Export sales payload when relevant"
},
"crush": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
]
}
}
}
},
"required": [
"as_of"
]
}🟢calendar.get
List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, and next-hint notes. Free discovery tool — call before scheduling agents around inventory or WASDE prints.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"events": {
"type": "array",
"description": "Upcoming / recurring release events",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Event id"
},
"name": {
"type": "string",
"description": "Event name"
},
"source": {
"type": "string",
"enum": [
"EIA",
"USDA",
"CFTC"
],
"description": "Publishing agency"
},
"cadence": {
"type": "string",
"description": "Release cadence"
},
"typical_time_et": {
"type": "string",
"description": "Typical release time in US/Eastern"
},
"next_hint": {
"type": "string",
"description": "Hint for the next expected release"
},
"notes": {
"type": "string",
"description": "Additional notes"
}
},
"required": [
"id",
"name",
"source",
"cadence",
"typical_time_et",
"next_hint",
"notes"
]
}
}
},
"required": [
"events"
]
}🟢decision.get(sector)
Build a deterministic decision pack for energy, metals, ags, or all sectors. Returns method, signals with direction/rationale, an embedded snapshot, and a disclaimer — no ML model, rule-based only.
Input Schema
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags",
"all"
],
"description": "Sector for the decision pack. Use all to bundle every sector."
}
},
"required": [
"sector"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags"
],
"description": "Present for single-sector packs"
},
"generated_at": {
"type": "string",
"description": "ISO timestamp when the pack was generated"
},
"method": {
"type": "string",
"description": "Deterministic method identifier"
},
"model_version": {
"type": "string",
"description": "Always null for rule-based packs; reserved field"
},
"signals": {
"type": "array",
"description": "Directional signals with rationale",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"direction": {
"type": "string"
},
"rationale": {
"type": "string"
}
},
"required": [
"id",
"direction",
"rationale"
]
}
},
"snapshot": {
"type": "object",
"properties": {
"sector": {
"type": "string",
"enum": [
"energy",
"metals",
"ags"
],
"description": "Sector covered by this snapshot"
},
"as_of": {
"type": "string",
"description": "Snapshot as-of timestamp"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"description": "Latest prices for the sector"
},
"freshness_note": {
"type": "string",
"description": "Freshness summary note"
},
"inventory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Inventory point id"
},
"series_key": {
"type": "string",
"description": "Internal series key"
},
"series_id": {
"type": "string",
"description": "EIA series id"
},
"name": {
"type": "string",
"description": "Series display name"
},
"value": {
"type": "number",
"description": "Latest inventory level"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "Report week as-of date"
},
"prior_week": {
"type": "number",
"description": "Prior-week level when known"
},
"wow_change": {
"type": "number",
"description": "Week-over-week change"
},
"avg_5y": {
"type": "number",
"description": "Five-year average when known"
},
"vs_5y": {
"type": "number",
"description": "Deviation vs five-year average"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
]
},
"description": "Inventory points when relevant"
},
"crack_321": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
},
"cot": {
"type": "array",
"items": {
"type": "object"
},
"description": "COT positioning rows when relevant"
},
"wasde": {
"type": "object",
"description": "WASDE payload when relevant"
},
"crop_progress": {
"type": "object",
"description": "Crop progress payload when relevant"
},
"export_sales": {
"type": "object",
"description": "Export sales payload when relevant"
},
"crush": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Stable observation id"
},
"instrument": {
"type": "string",
"description": "Instrument code, e.g. CL"
},
"name": {
"type": "string",
"description": "Human-readable instrument name"
},
"value": {
"type": "number",
"description": "Observed numeric value"
},
"unit": {
"type": "string",
"description": "Unit of measure"
},
"as_of": {
"type": "string",
"description": "As-of date for the observation"
},
"observed_at": {
"type": "string",
"description": "ISO timestamp when observed"
},
"freshness_class": {
"type": "string",
"description": "Freshness class for the series"
},
"quality": {
"type": "string",
"description": "Data quality label"
},
"derived": {
"type": "boolean",
"description": "True when value is derived"
},
"formula": {
"type": "string",
"description": "Derivation formula when derived"
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input series ids when derived"
},
"source": {
"type": "object",
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
]
},
"license_tag": {
"type": "string",
"description": "License / redistribution tag"
},
"provenance": {
"type": "object",
"description": "Retrieval / cache provenance",
"properties": {
"retrieved_at": {
"type": "string"
},
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
]
},
"series_id": {
"type": "string",
"description": "Underlying series id"
},
"raw_hash": {
"type": "string",
"description": "Hash of raw source payload"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
]
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
]
},
"disclaimer": {
"type": "string",
"description": "Non-advice / methodology disclaimer"
},
"sectors": {
"type": "object",
"description": "Present when sector=all"
}
},
"required": [
"generated_at",
"method"
]
}Community
Evidence
Recent observations
verifiedversion not recorded11 tools
verifiedversion not recorded11 tools