Primary Source Commodities
Primary-source commodities data for AI agents — EIA, FRED, CFTC, USDA, USGS via x402 on Base.
使うべきか
品質と安全性
B
検出事項（11）
- LOWTool 'catalog.list' doesn't follow camelCase/snake_casecatalog.list 内
- LOWTool 'price.latest' doesn't follow camelCase/snake_caseprice.latest 内
- LOWTool 'inventory.get' doesn't follow camelCase/snake_caseinventory.get 内
- LOWTool 'positioning.get' doesn't follow camelCase/snake_casepositioning.get 内
- LOWTool 'spread.get' doesn't follow camelCase/snake_casespread.get 内
- LOWTool 'price.history' doesn't follow camelCase/snake_caseprice.history 内
- LOWTool 'fx.latest' doesn't follow camelCase/snake_casefx.latest 内
- LOWTool 'fundamentals.get' doesn't follow camelCase/snake_casefundamentals.get 内
- LOWTool 'snapshot.get' doesn't follow camelCase/snake_casesnapshot.get 内
- LOWTool 'calendar.get' doesn't follow camelCase/snake_casecalendar.get 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~11,831トークン数（ツール定義）
~13.5 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 9.24%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"commodities-sh": {
"url": "https://api.commodities.sh/api/mcp"
}
}
}リモートエンドポイント
https://api.commodities.sh/api/mcpstreamable-httpできること
ツール一覧
ツール（11）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢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.
入力スキーマ
{
"type": "object",
"properties": {},
"additionalProperties": false
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, GC, ZC."
}
},
"required": [
"code"
],
"additionalProperties": false
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"series": {
"type": "string",
"description": "Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks."
}
},
"additionalProperties": false
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Instrument code from catalog.list. Example: CL, NG, GC, ZC."
}
},
"required": [
"code"
],
"additionalProperties": false
}出力スキーマ
{
"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.
入力スキーマ
{
"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
}出力スキーマ
{
"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.
入力スキーマ
{
"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
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {
"pair": {
"type": "string",
"description": "FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS."
}
},
"required": [
"pair"
],
"additionalProperties": false
}出力スキーマ
{
"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.
入力スキーマ
{
"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
}出力スキーマ
{
"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.
入力スキーマ
{
"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
}出力スキーマ
{
"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.
入力スキーマ
{
"type": "object",
"properties": {},
"additionalProperties": false
}出力スキーマ
{
"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.
入力スキーマ
{
"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
}出力スキーマ
{
"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"
]
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 11 件
検証済みバージョンは記録されていませんツール 11 件