Primary Source Commodities
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
Sollte ich dies verwenden
Qualität und Sicherheit
B
Befunde (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
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~11,831Tokens (Tool-Definitionen)
~13.5 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (9.24% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"commodities-sh": {
"url": "https://api.commodities.sh/api/mcp"
}
}
}Remote-Endpunkte
https://api.commodities.sh/api/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Ausgabe-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.
Eingabe-Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, GC, ZC."
}
},
"required": [
"code"
],
"additionalProperties": false
}Ausgabe-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.
Eingabe-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
}Ausgabe-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.
Eingabe-Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, NG, GC, ZC."
}
},
"required": [
"code"
],
"additionalProperties": false
}Ausgabe-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.
Eingabe-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
}Ausgabe-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.
Eingabe-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
}Ausgabe-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.
Eingabe-Schema
{
"type": "object",
"properties": {
"pair": {
"type": "string",
"description": "FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS."
}
},
"required": [
"pair"
],
"additionalProperties": false
}Ausgabe-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.
Eingabe-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
}Ausgabe-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.
Eingabe-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
}Ausgabe-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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Ausgabe-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.
Eingabe-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
}Ausgabe-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
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet11 Tools
verifiziertVersion nicht aufgezeichnet11 Tools
verifiziertVersion nicht aufgezeichnet11 Tools