Server definition
- Hash
- sha256:97a97b93dc925483fd3bb2af12f6bdb1cf4b23d61ec242ea445de6a8428cec8f
- What it is
- What a remote MCP server returned when asked what it offers: 11 tools
The blob, as servednamed by its sha256
{
"instructions": "Primary-source commodities MCP. Start with catalog.list (free) to discover instrument codes, then price.latest / inventory.get / positioning.get for observations. Use snapshot.get for a sector bundle and decision.get for deterministic signal packs. calendar.get (free) lists EIA/USDA/CFTC release cadence. Paid tools settle via x402 USDC on Base.",
"tools": [
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "calendar.get",
"outputSchema": {
"properties": {
"events": {
"description": "Upcoming / recurring release events",
"items": {
"properties": {
"cadence": {
"description": "Release cadence",
"type": "string"
},
"id": {
"description": "Event id",
"type": "string"
},
"name": {
"description": "Event name",
"type": "string"
},
"next_hint": {
"description": "Hint for the next expected release",
"type": "string"
},
"notes": {
"description": "Additional notes",
"type": "string"
},
"source": {
"description": "Publishing agency",
"enum": [
"EIA",
"USDA",
"CFTC"
],
"type": "string"
},
"typical_time_et": {
"description": "Typical release time in US/Eastern",
"type": "string"
}
},
"required": [
"id",
"name",
"source",
"cadence",
"typical_time_et",
"next_hint",
"notes"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"events"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "catalog.list",
"outputSchema": {
"properties": {
"instruments": {
"description": "Instrument registry rows",
"items": {
"properties": {
"code": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"cot_commodity_hint": {
"description": "CFTC commodity hint when applicable",
"type": "string"
},
"freshness_class": {
"description": "Expected freshness class",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Display name",
"type": "string"
},
"primary_series_id": {
"description": "Primary source series id",
"type": "string"
},
"primary_source": {
"description": "Primary source name, e.g. EIA or FRED",
"type": "string"
},
"sector": {
"description": "Sector grouping",
"enum": [
"energy",
"metals",
"ags",
"fx"
],
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"venue": {
"description": "Trading venue when known",
"type": "string"
}
},
"required": [
"code",
"name",
"sector",
"unit",
"primary_series_id",
"primary_source",
"freshness_class",
"license_tag"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"instruments"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"sector": {
"description": "Sector for the decision pack. Use all to bundle every sector.",
"enum": [
"energy",
"metals",
"ags",
"all"
],
"type": "string"
}
},
"required": [
"sector"
],
"type": "object"
},
"name": "decision.get",
"outputSchema": {
"properties": {
"disclaimer": {
"description": "Non-advice / methodology disclaimer",
"type": "string"
},
"generated_at": {
"description": "ISO timestamp when the pack was generated",
"type": "string"
},
"method": {
"description": "Deterministic method identifier",
"type": "string"
},
"model_version": {
"description": "Always null for rule-based packs; reserved field",
"type": "string"
},
"sector": {
"description": "Present for single-sector packs",
"enum": [
"energy",
"metals",
"ags"
],
"type": "string"
},
"sectors": {
"description": "Present when sector=all",
"type": "object"
},
"signals": {
"description": "Directional signals with rationale",
"items": {
"properties": {
"direction": {
"type": "string"
},
"id": {
"type": "string"
},
"rationale": {
"type": "string"
}
},
"required": [
"id",
"direction",
"rationale"
],
"type": "object"
},
"type": "array"
},
"snapshot": {
"properties": {
"as_of": {
"description": "Snapshot as-of timestamp",
"type": "string"
},
"cot": {
"description": "COT positioning rows when relevant",
"items": {
"type": "object"
},
"type": "array"
},
"crack_321": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"crop_progress": {
"description": "Crop progress payload when relevant",
"type": "object"
},
"crush": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"export_sales": {
"description": "Export sales payload when relevant",
"type": "object"
},
"freshness_note": {
"description": "Freshness summary note",
"type": "string"
},
"inventory": {
"description": "Inventory points when relevant",
"items": {
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"type": "array"
},
"prices": {
"description": "Latest prices for the sector",
"items": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"type": "array"
},
"sector": {
"description": "Sector covered by this snapshot",
"enum": [
"energy",
"metals",
"ags"
],
"type": "string"
},
"wasde": {
"description": "WASDE payload when relevant",
"type": "object"
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
],
"type": "object"
}
},
"required": [
"generated_at",
"method"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"kind": {
"description": "Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates.",
"enum": [
"wasde",
"crop_progress",
"export_sales",
"usgs"
],
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"name": "fundamentals.get",
"outputSchema": {
"properties": {
"as_of": {
"description": "Report as-of date",
"type": "string"
},
"id": {
"description": "Document id",
"type": "string"
},
"kind": {
"description": "Report kind echoed from the request",
"enum": [
"wasde",
"crop_progress",
"export_sales",
"usgs"
],
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when retrieved",
"type": "string"
},
"payload": {
"description": "Kind-specific payload (quality, note, license_tag, freshness_class, and report fields)",
"type": "object"
}
},
"required": [
"id",
"kind",
"as_of",
"observed_at",
"payload"
],
"type": "object"
}
},
{
"description": "Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"pair": {
"description": "FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS.",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "fx.latest",
"outputSchema": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"series": {
"description": "Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks.",
"type": "string"
}
},
"type": "object"
},
"name": "inventory.get",
"outputSchema": {
"properties": {
"data": {
"description": "All latest inventory points when series is omitted",
"items": {
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"type": "array"
},
"latest": {
"description": "Latest point when a series key is provided",
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"surprise_label": {
"description": "Surprise classification when series is provided",
"type": "string"
},
"vs_5y": {
"description": "Deviation vs five-year average when series is provided",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change when series is provided",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"code": {
"description": "Instrument code from catalog.list. Example: CL, NG, GC, ZC.",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "positioning.get",
"outputSchema": {
"properties": {
"commodity_name": {
"description": "CFTC commodity name",
"type": "string"
},
"id": {
"description": "COT row id",
"type": "string"
},
"instrument": {
"description": "Instrument code",
"type": "string"
},
"mm_long": {
"description": "Managed-money long contracts",
"type": "number"
},
"mm_net": {
"description": "Managed-money net contracts",
"type": "number"
},
"mm_net_change": {
"description": "Week-over-week change in managed-money net",
"type": "number"
},
"mm_short": {
"description": "Managed-money short contracts",
"type": "number"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"report_date": {
"description": "CFTC report date",
"type": "string"
},
"source_url": {
"description": "CFTC source URL",
"type": "string"
}
},
"required": [
"id",
"instrument",
"report_date",
"commodity_name",
"mm_long",
"mm_short",
"mm_net",
"mm_net_change",
"source_url",
"observed_at"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"code": {
"description": "Instrument code from catalog.list. Example: CL, GC, ZC.",
"type": "string"
},
"limit": {
"description": "Number of historical points to return. Max 500, default 60.",
"type": "number"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "price.history",
"outputSchema": {
"properties": {
"count": {
"description": "Number of points returned",
"type": "number"
},
"data": {
"description": "Historical observations, newest first or as stored",
"items": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"type": "array"
},
"instrument": {
"description": "Instrument code",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
}
},
"required": [
"instrument",
"series_id",
"count",
"data"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"code": {
"description": "Instrument code from catalog.list. Example: CL, GC, ZC.",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "price.latest",
"outputSchema": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"sector": {
"description": "Sector to snapshot. Use all to receive energy, metals, and ags together.",
"enum": [
"energy",
"metals",
"ags",
"all"
],
"type": "string"
}
},
"required": [
"sector"
],
"type": "object"
},
"name": "snapshot.get",
"outputSchema": {
"properties": {
"as_of": {
"description": "Snapshot as-of timestamp",
"type": "string"
},
"cot": {
"description": "COT rows when relevant",
"items": {
"type": "object"
},
"type": "array"
},
"crack_321": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"crop_progress": {
"description": "Crop progress when relevant",
"type": "object"
},
"crush": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"export_sales": {
"description": "Export sales when relevant",
"type": "object"
},
"freshness_note": {
"description": "Freshness summary",
"type": "string"
},
"inventory": {
"description": "Inventory rows when relevant",
"items": {
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"type": "array"
},
"prices": {
"description": "Latest prices for the sector",
"items": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"type": "array"
},
"sector": {
"description": "Present for single-sector responses",
"enum": [
"energy",
"metals",
"ags"
],
"type": "string"
},
"sectors": {
"description": "Present when sector=all",
"properties": {
"ags": {
"properties": {
"as_of": {
"description": "Snapshot as-of timestamp",
"type": "string"
},
"cot": {
"description": "COT positioning rows when relevant",
"items": {
"type": "object"
},
"type": "array"
},
"crack_321": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"crop_progress": {
"description": "Crop progress payload when relevant",
"type": "object"
},
"crush": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"export_sales": {
"description": "Export sales payload when relevant",
"type": "object"
},
"freshness_note": {
"description": "Freshness summary note",
"type": "string"
},
"inventory": {
"description": "Inventory points when relevant",
"items": {
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"type": "array"
},
"prices": {
"description": "Latest prices for the sector",
"items": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"type": "array"
},
"sector": {
"description": "Sector covered by this snapshot",
"enum": [
"energy",
"metals",
"ags"
],
"type": "string"
},
"wasde": {
"description": "WASDE payload when relevant",
"type": "object"
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
],
"type": "object"
},
"energy": {
"properties": {
"as_of": {
"description": "Snapshot as-of timestamp",
"type": "string"
},
"cot": {
"description": "COT positioning rows when relevant",
"items": {
"type": "object"
},
"type": "array"
},
"crack_321": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"crop_progress": {
"description": "Crop progress payload when relevant",
"type": "object"
},
"crush": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"export_sales": {
"description": "Export sales payload when relevant",
"type": "object"
},
"freshness_note": {
"description": "Freshness summary note",
"type": "string"
},
"inventory": {
"description": "Inventory points when relevant",
"items": {
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"type": "array"
},
"prices": {
"description": "Latest prices for the sector",
"items": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"type": "array"
},
"sector": {
"description": "Sector covered by this snapshot",
"enum": [
"energy",
"metals",
"ags"
],
"type": "string"
},
"wasde": {
"description": "WASDE payload when relevant",
"type": "object"
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
],
"type": "object"
},
"metals": {
"properties": {
"as_of": {
"description": "Snapshot as-of timestamp",
"type": "string"
},
"cot": {
"description": "COT positioning rows when relevant",
"items": {
"type": "object"
},
"type": "array"
},
"crack_321": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"crop_progress": {
"description": "Crop progress payload when relevant",
"type": "object"
},
"crush": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"export_sales": {
"description": "Export sales payload when relevant",
"type": "object"
},
"freshness_note": {
"description": "Freshness summary note",
"type": "string"
},
"inventory": {
"description": "Inventory points when relevant",
"items": {
"properties": {
"as_of": {
"description": "Report week as-of date",
"type": "string"
},
"avg_5y": {
"description": "Five-year average when known",
"type": "number"
},
"id": {
"description": "Inventory point id",
"type": "string"
},
"name": {
"description": "Series display name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"prior_week": {
"description": "Prior-week level when known",
"type": "number"
},
"series_id": {
"description": "EIA series id",
"type": "string"
},
"series_key": {
"description": "Internal series key",
"type": "string"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Latest inventory level",
"type": "number"
},
"vs_5y": {
"description": "Deviation vs five-year average",
"type": "number"
},
"wow_change": {
"description": "Week-over-week change",
"type": "number"
}
},
"required": [
"id",
"series_key",
"series_id",
"name",
"value",
"unit",
"as_of",
"observed_at"
],
"type": "object"
},
"type": "array"
},
"prices": {
"description": "Latest prices for the sector",
"items": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"required": [
"instrument",
"name",
"value",
"unit",
"as_of",
"observed_at",
"freshness_class",
"quality",
"derived",
"source",
"license_tag",
"provenance",
"series_id"
],
"type": "object"
},
"type": "array"
},
"sector": {
"description": "Sector covered by this snapshot",
"enum": [
"energy",
"metals",
"ags"
],
"type": "string"
},
"wasde": {
"description": "WASDE payload when relevant",
"type": "object"
}
},
"required": [
"sector",
"as_of",
"prices",
"freshness_note"
],
"type": "object"
}
},
"type": "object"
},
"wasde": {
"description": "WASDE payload when relevant",
"type": "object"
}
},
"required": [
"as_of"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"root": {
"description": "Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis.",
"type": "string"
},
"type": {
"description": "Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack.",
"enum": [
"crack",
"crush",
"basis",
"calendar"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"name": "spread.get",
"outputSchema": {
"properties": {
"as_of": {
"description": "As-of date for the observation",
"type": "string"
},
"available": {
"description": "False when the spread cannot be computed",
"type": "boolean"
},
"derived": {
"description": "True when value is derived",
"type": "boolean"
},
"formula": {
"description": "Derivation formula when derived",
"type": "string"
},
"freshness_class": {
"description": "Freshness class for the series",
"type": "string"
},
"id": {
"description": "Stable observation id",
"type": "string"
},
"inputs": {
"description": "Input series ids when derived",
"items": {
"type": "string"
},
"type": "array"
},
"instrument": {
"description": "Instrument code, e.g. CL",
"type": "string"
},
"legs_quality": {
"description": "Per-leg quality when inputs are mixed",
"items": {
"properties": {
"instrument": {
"type": "string"
},
"quality": {
"type": "string"
}
},
"required": [
"instrument",
"quality"
],
"type": "object"
},
"type": "array"
},
"license_tag": {
"description": "License / redistribution tag",
"type": "string"
},
"name": {
"description": "Human-readable instrument name",
"type": "string"
},
"note": {
"description": "Explanation when unavailable or partially degraded",
"type": "string"
},
"observed_at": {
"description": "ISO timestamp when observed",
"type": "string"
},
"provenance": {
"description": "Retrieval / cache provenance",
"properties": {
"cache_hit": {
"type": "boolean"
},
"cache_ttl_s": {
"type": "number"
},
"retrieved_at": {
"type": "string"
}
},
"required": [
"retrieved_at",
"cache_hit",
"cache_ttl_s"
],
"type": "object"
},
"quality": {
"description": "Data quality label",
"type": "string"
},
"raw_hash": {
"description": "Hash of raw source payload",
"type": "string"
},
"root": {
"description": "Calendar root when type=calendar",
"type": "string"
},
"series_id": {
"description": "Underlying series id",
"type": "string"
},
"source": {
"description": "Primary source provenance",
"properties": {
"name": {
"type": "string"
},
"series_id": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"series_id",
"url"
],
"type": "object"
},
"unit": {
"description": "Unit of measure",
"type": "string"
},
"value": {
"description": "Observed numeric value",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:97a97b93dc925483fd3bb2af12f6bdb1cf4b23d61ec242ea445de6a8428cec8f | sha256sum