Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,158Letters: 84Defects: 3,898counted 3 min ago
teppi

Server definition

Hash
sha256:e0448706e5e494ca8dd16a8357f56c22f049f207b15c4909caeb9a0843d956d8
What it is
What a remote MCP server returned when asked what it offers: 30 tools

The blob, as servednamed by its sha256

{ "instructions": "Primary-source commodities MCP. Start with catalog.list (free) to discover instrument codes, then price.latest / inventory.get / positioning.get for observations. Use trade.calculate for landed cost, margin, break-even or an FX shock over numbers you supply — nothing is sourced, and anything you omit comes back in `missing` rather than silently as zero. Use price.stats for how an instrument has behaved — volatility, change over a window, range — rather than pulling price.history and computing it yourself. Use snapshot.get for a sector bundle and decision.get for deterministic signal packs. calendar.get (free) lists EIA/USDA/CFTC release cadence; releases.next (paid) adds what each report last said and whether it surprised. cash.bids (paid) searches USDA AMS cash elevator bids and basis across every state grain report at once — a cash bid, not a futures settle and not the NASS price received. minerals.dossier (paid) gives mine production, reserves and export flows by country for nine minerals. 7 tools are FREE; the reference ones are worth calling first: trade.codes resolves a country to the M49 code the trade tools require (there is no other way to get one), minerals.list carries the curated mineral HS codes, and cash.reports lists the AMS grain reports and their freshness. Prefer the bundle tools over looping — price.bundle, stats.bundle and producer.prices.bundle each take up to 20 codes in one settlement. account.quota (free, needs an API key) reports credits left. AUTHENTICATION: paid tools need either a Pro credit key sent as the HTTP header `Authorization: Bearer cs_live_…` on this endpoint, or an x402 USDC payment on Base. The header is the practical route for an MCP client — the x402 challenge is an HTTP-level response a standard host cannot settle and retry. Without either, a paid tool returns isError with the reason and nothing is charged; call account.quota to confirm a key is being read.", "tools": [ { "description": "How many credits the calling Pro key has left in the current billing period, and which scopes it may read. FREE, and requires an API key in the Authorization header — x402 callers pay per request and have no quota to report. Use it to decide whether to spend on a bundle or a pack before calling one.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "account.quota", "outputSchema": { "properties": { "billing_period": { "type": "string" }, "credits_included": { "type": [ "integer", "null" ] }, "credits_remaining": { "type": [ "integer", "null" ] }, "credits_used": { "type": "integer" }, "plan": { "type": [ "string", "null" ] }, "scopes": { "description": "Empty means unrestricted", "items": { "type": "string" }, "type": "array" } }, "required": [ "credits_used", "billing_period", "scopes" ], "type": "object" } }, { "description": "FREE. List EIA, USDA, and CFTC release calendar entries with cadence, typical Eastern time, next_hint prose, and next_release_at ISO date (America/New_York). Free discovery tool — call before scheduling agents around inventory or WASDE prints.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "calendar.get", "outputSchema": { "properties": { "events": { "description": "Upcoming / recurring release events", "items": { "properties": { "cadence": { "description": "Release cadence", "type": "string" }, "id": { "description": "Event id", "type": "string" }, "name": { "description": "Event name", "type": "string" }, "next_hint": { "description": "Hint for the next expected release", "type": "string" }, "next_release_at": { "description": "ISO date YYYY-MM-DD in America/New_York for the next expected release", "type": [ "string", "null" ] }, "notes": { "description": "Additional notes", "type": "string" }, "source": { "description": "Publishing agency", "enum": [ "EIA", "USDA", "CFTC" ], "type": "string" }, "source_url": { "description": "The agency's own page for this release", "type": "string" }, "typical_time_et": { "description": "Typical release time in US/Eastern", "type": "string" } }, "required": [ "id", "name", "source", "cadence", "typical_time_et", "next_hint", "next_release_at", "notes", "source_url" ], "type": "object" }, "type": "array" } }, "required": [ "events" ], "type": "object" } }, { "description": "A country elevator's cash bid for physical grain, from USDA AMS daily cash grain bid reports, searched across every state report at once — which AMS itself cannot do, because MARS is report-centric with no commodity-wide search. Returns basis in CENTS per bushel against a named futures month, price in DOLLARS per bushel, location, grade, elevator class, freight and delivery. THIS IS NOT a futures settlement and NOT the NASS season-average price received that price.latest returns for ZC/ZW/ZS; all three are correct and all three differ. Values are ranges where the report published a range. Latest published print only — there is no stored history, so this cannot tell you whether basis is strengthening; read each row's basis_change, which is the agency's own answer. Wheat must name its class: CBOT soft red winter, KCBT hard red winter and MGE hard red spring traded 35 cents apart on the same page. Paid.", "inputSchema": { "additionalProperties": false, "properties": { "commodity": { "description": "Which grain. Required.", "enum": [ "corn", "soybeans", "wheat_srw", "wheat_hrw", "wheat_hrs", "wheat_hard_white", "sorghum" ], "type": "string" }, "elevator_class": { "description": "Narrow to one kind of buyer.", "enum": [ "country_elevator", "terminal_elevator", "mill_or_processor", "other" ], "type": "string" }, "include_stale": { "description": "Include reports that have not published recently. Excluded and named by default.", "type": "boolean" }, "limit": { "description": "Maximum rows.", "minimum": 1, "type": "integer" }, "month": { "description": "Futures month code (\"Z\") or contract (\"2026-12\") the basis is quoted against.", "type": "string" }, "state": { "description": "Two-letter state code, e.g. IA.", "type": "string" } }, "required": [ "commodity" ], "type": "object" }, "name": "cash.bids", "outputSchema": { "properties": { "bids": { "description": "Cash bid rows, widest basis first", "type": "array" }, "commodity": { "type": "string" }, "instrument": { "description": "Catalog instrument where one quotes this class; null is a real answer", "type": [ "string", "null" ] }, "notes": { "items": { "type": "string" }, "type": "array" }, "reports_searched": { "type": "integer" }, "stale_reports_excluded": { "items": { "type": "string" }, "type": "array" } }, "required": [ "commodity", "bids", "reports_searched", "notes" ], "type": "object" } }, { "description": "Which USDA AMS daily cash grain bid reports exist, which state and commodities each covers, and how fresh each is. FREE. Call before cash.bids to learn which states are covered and which reports have stopped publishing: liveness is current, stale (served and flagged), unlisted (AMS no longer lists it) or unknown. Three reports are published as covered-but-unparsed rather than omitted, because a visible gap beats a silent absence.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "cash.reports", "outputSchema": { "properties": { "report_count": { "type": "integer" }, "reports": { "description": "Per report: slug, state, commodities, as_of, liveness", "type": "array" } }, "required": [ "report_count", "reports" ], "type": "object" } }, { "description": "FREE. List every commodity instrument in the catalog with sector, unit, primary source, and freshness metadata. Call this first to discover valid codes before price.latest or inventory.get. Free discovery tool — no payment required.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "catalog.list", "outputSchema": { "properties": { "instruments": { "description": "Instrument registry rows", "items": { "properties": { "available": { "description": "False when the code is registered but has no resolvable source, so price.latest can only 404", "type": "boolean" }, "code": { "description": "Instrument code, e.g. CL", "type": "string" }, "cot_commodity_hint": { "description": "CFTC commodity hint when applicable", "type": "string" }, "freshness_class": { "description": "Expected freshness class", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Display name", "type": "string" }, "primary_series_id": { "description": "Primary source series id", "type": "string" }, "primary_source": { "description": "Primary source name, e.g. EIA or FRED", "type": "string" }, "sector": { "description": "Sector grouping", "enum": [ "energy", "metals", "ags", "fx" ], "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "venue": { "description": "Trading venue when known", "type": "string" } }, "required": [ "code", "name", "sector", "unit", "primary_series_id", "primary_source", "freshness_class", "license_tag", "available" ], "type": "object" }, "type": "array" } }, "required": [ "instruments" ], "type": "object" } }, { "description": "FREE. Resolve a human commodity name to an instrument code — 'cocoa' to CC, 'copper' to HG, 'palm oil' to PO. Use this instead of catalog.list when you already know the commodity by name and need the code to call price.latest or trade.flow. Returns nothing rather than a guess when no instrument matches. Free discovery tool — no payment required.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "description": "Maximum results (1-50, default 10)", "type": "integer" }, "q": { "description": "Commodity name, synonym, or instrument code, e.g. 'cocoa'", "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "catalog.search", "outputSchema": { "properties": { "query": { "description": "The query as interpreted", "type": "string" }, "results": { "description": "Matching instruments, most confident first", "items": { "properties": { "available": { "description": "False when the instrument has no resolvable source and price.latest can only fail", "type": "boolean" }, "code": { "description": "Instrument code to use in other tools", "type": "string" }, "match": { "description": "Why this row matched. 'code' and 'synonym' are exact and safe to act on; 'name' and 'partial' are substring suggestions worth confirming.", "enum": [ "code", "synonym", "name", "partial" ], "type": "string" }, "matched_on": { "description": "The registry string the query hit", "type": "string" }, "name": { "description": "Display name", "type": "string" }, "sector": { "description": "Sector grouping", "enum": [ "energy", "metals", "ags", "fx" ], "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" } }, "required": [ "code", "name", "sector", "unit", "available", "match", "matched_on" ], "type": "object" }, "type": "array" } }, "required": [ "query", "results" ], "type": "object" } }, { "description": "Build a deterministic decision pack for energy, metals, ags, or all sectors. Returns method, signals with direction/rationale, an embedded snapshot, and a disclaimer — no ML model, rule-based only.", "inputSchema": { "additionalProperties": false, "properties": { "sector": { "description": "Sector for the decision pack. Use all to bundle every sector.", "enum": [ "energy", "metals", "ags", "all" ], "type": "string" } }, "required": [ "sector" ], "type": "object" }, "name": "decision.get", "outputSchema": { "properties": { "disclaimer": { "description": "Non-advice / methodology disclaimer", "type": "string" }, "generated_at": { "description": "ISO timestamp when the pack was generated", "type": "string" }, "method": { "description": "Deterministic method identifier", "type": "string" }, "model_version": { "description": "Always null for rule-based packs; reserved field", "type": "string" }, "sector": { "description": "Present for single-sector packs", "enum": [ "energy", "metals", "ags" ], "type": "string" }, "sectors": { "description": "Present when sector=all", "type": "object" }, "signals": { "description": "Directional signals with rationale", "items": { "properties": { "direction": { "type": "string" }, "id": { "type": "string" }, "rationale": { "type": "string" } }, "required": [ "id", "direction", "rationale" ], "type": "object" }, "type": "array" }, "snapshot": { "properties": { "as_of": { "description": "Snapshot as-of timestamp", "type": "string" }, "cot": { "description": "COT positioning rows when relevant", "items": { "type": "object" }, "type": "array" }, "crack_321": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "crop_progress": { "description": "Crop progress payload when relevant", "type": "object" }, "crush": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "export_sales": { "description": "Export sales payload when relevant", "type": "object" }, "freshness_note": { "description": "Freshness summary note", "type": "string" }, "inventory": { "description": "Inventory points when relevant", "items": { "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "type": "array" }, "prices": { "description": "Latest prices for the sector", "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" }, "sector": { "description": "Sector covered by this snapshot", "enum": [ "energy", "metals", "ags" ], "type": "string" }, "wasde": { "description": "WASDE payload when relevant", "type": "object" } }, "required": [ "sector", "as_of", "prices", "freshness_note" ], "type": "object" } }, "required": [ "generated_at", "method" ], "type": "object" } }, { "description": "Fetch a fundamentals document: USDA WASDE, crop progress, export sales, or USGS mineral summaries. Choose kind based on the ags/metals question you are answering.", "inputSchema": { "additionalProperties": false, "properties": { "kind": { "description": "Fundamentals report kind. Example: wasde for World Agricultural Supply and Demand Estimates.", "enum": [ "wasde", "crop_progress", "export_sales", "usgs" ], "type": "string" } }, "required": [ "kind" ], "type": "object" }, "name": "fundamentals.get", "outputSchema": { "properties": { "as_of": { "description": "Report as-of date", "type": "string" }, "id": { "description": "Document id", "type": "string" }, "kind": { "description": "Report kind echoed from the request", "enum": [ "wasde", "crop_progress", "export_sales", "usgs" ], "type": "string" }, "observed_at": { "description": "ISO timestamp when retrieved", "type": "string" }, "payload": { "description": "Kind-specific payload (quality, note, license_tag, freshness_class, and report fields)", "type": "object" } }, "required": [ "id", "kind", "as_of", "observed_at", "payload" ], "type": "object" } }, { "description": "Return the latest FX rate observation for a pair or FRED FX series. Useful alongside commodity prices when converting cash values across currencies.", "inputSchema": { "additionalProperties": false, "properties": { "pair": { "description": "FX pair or series id. Example: EURUSD, USDCNY, DTWEXBGS.", "type": "string" } }, "required": [ "pair" ], "type": "object" }, "name": "fx.latest", "outputSchema": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" } }, { "description": "Fetch EIA weekly petroleum inventory levels. Omit series to list all latest inventory points, or pass a series key to get week-over-week change, vs-5y deviation, and a surprise label for that series.", "inputSchema": { "additionalProperties": false, "properties": { "series": { "description": "Optional EIA inventory series key. Omit to return all latest inventory rows. Example: crude_stocks.", "type": "string" } }, "type": "object" }, "name": "inventory.get", "outputSchema": { "properties": { "data": { "description": "All latest inventory points when series is omitted", "items": { "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "type": "array" }, "latest": { "description": "Latest point when a series key is provided", "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "surprise_label": { "description": "Surprise classification when series is provided", "type": "string" }, "vs_5y": { "description": "Deviation vs five-year average when series is provided", "type": "number" }, "wow_change": { "description": "Week-over-week change when series is provided", "type": "number" } }, "type": "object" } }, { "description": "Who mines a mineral, who holds its reserves, and who exports it — USGS Mineral Commodity Summaries production and reserves by country, joined to UN Comtrade export flows and realised unit values, with supply concentration and US net import reliance. REFUSES three things: no ratio between the supply side and the trade side, because USGS counts contained metal while HS counts the gross weight of a traded article and for lithium those differ by about five times; no price of any kind; no criticality or supply-risk score. EXPORTS ARE NOT PRODUCTION — for gold and silver the largest reporters refine and vault rather than mine, so the two halves rank different countries for good reasons. The HS code matches the USGS production basis, so copper, nickel and zinc point at ore and concentrate headings rather than the refined-metal headings their instruments use. Annual data. Paid.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "description": "Maximum country rows.", "minimum": 1, "type": "integer" }, "mineral": { "description": "Which mineral. Required.", "enum": [ "aluminum", "copper", "gold", "silver", "nickel", "zinc", "iron_ore", "cobalt", "lithium" ], "type": "string" }, "year": { "description": "Trade year for the Comtrade half. USGS years are fixed by the edition.", "type": "integer" } }, "required": [ "mineral" ], "type": "object" }, "name": "minerals.dossier", "outputSchema": { "properties": { "comparability": { "description": "Whether the two sides may be compared at all", "type": "object" }, "concentration": { "description": "Top-3 share and HHI per side, with formula and coverage", "type": "object" }, "countries": { "description": "Per-country supply and trade, largest producer first", "type": "array" }, "instrument": { "description": "Catalog instrument where one quotes this metal; null for cobalt and lithium", "type": [ "string", "null" ] }, "mineral": { "type": "string" }, "net_import_reliance": { "description": "US only, with the column it was read from", "type": "object" }, "notes": { "items": { "type": "string" }, "type": "array" }, "supply": { "description": "USGS production and reserves, in the mineral's own unit", "type": [ "object", "null" ] }, "trade": { "description": "Comtrade exports; null when the licence is unresolved", "type": [ "object", "null" ] } }, "required": [ "mineral", "countries", "concentration", "comparability", "notes" ], "type": "object" } }, { "description": "Which minerals the dossier covers, the HS code curated for each, and the caveats on comparing supply to trade. FREE. Worth calling before minerals.dossier for two reasons: the cobalt and lithium HS headings exist nowhere else in this API, since trade.codes lists headings only for catalog instruments and neither mineral has one; and the HS code here is chosen to match the USGS production basis, so copper, nickel and zinc point at ore headings rather than the refined-metal headings their instruments use. Also reports which minerals currently have US net import reliance and which column it was read from.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "minerals.list", "outputSchema": { "properties": { "edition": { "description": "USGS MCS edition stored", "type": [ "number", "null" ] }, "minerals": { "description": "Per mineral: instrument, HS code and level, bases, caveats", "type": "array" }, "not_mapped": { "description": "Minerals deliberately refused, with the reason", "type": "object" } }, "required": [ "minerals" ], "type": "object" } }, { "description": "Resolve a single observation by its id. Derived observations (crack, crush, basis) cite the observations they were computed from in inputs[]; this is how you dereference those ids to audit a derived value. Ids look like obs_<24 hex>.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "Observation id, e.g. from a derived observation's inputs[] array.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "observation.resolve", "outputSchema": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" } }, { "description": "Return the latest CFTC Commitments of Traders managed-money positioning for an instrument code. Includes long, short, net, and week-over-week net change with source URL.", "inputSchema": { "additionalProperties": false, "properties": { "code": { "description": "Instrument code from catalog.list. Example: CL, NG, GC, ZC.", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "positioning.get", "outputSchema": { "properties": { "commodity_name": { "description": "CFTC commodity name", "type": "string" }, "id": { "description": "COT row id", "type": "string" }, "instrument": { "description": "Instrument code", "type": "string" }, "mm_long": { "description": "Managed-money long contracts", "type": "number" }, "mm_net": { "description": "Managed-money net contracts", "type": "number" }, "mm_net_change": { "description": "Week-over-week change in managed-money net", "type": "number" }, "mm_short": { "description": "Managed-money short contracts", "type": "number" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "report_date": { "description": "CFTC report date", "type": "string" }, "source_url": { "description": "CFTC source URL", "type": "string" } }, "required": [ "id", "instrument", "report_date", "commodity_name", "mm_long", "mm_short", "mm_net", "mm_net_change", "source_url", "observed_at" ], "type": "object" } }, { "description": "The latest observation for up to 20 instruments in ONE call. A separate tool from price.latest rather than an optional argument on it, because the two are priced differently and nothing binds a payment to a request body — one multiplexed entry point would let a caller quote the single price and send the bundle. Use this instead of looping price.latest: it is one settlement and one round trip. Codes that do not resolve come back with an error field rather than being dropped, and codes past the cap are listed in dropped_codes. Paid; charged only if at least one code resolves.", "inputSchema": { "additionalProperties": false, "properties": { "codes": { "description": "Instrument codes, up to 20. Example: [\"CL\", \"BZ\", \"HG\"].", "items": { "type": "string" }, "minItems": 1, "type": "array" } }, "required": [ "codes" ], "type": "object" }, "name": "price.bundle", "outputSchema": { "properties": { "count": { "type": "integer" }, "dropped_codes": { "items": { "type": "string" }, "type": "array" }, "observations": { "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" } }, "required": [ "count", "observations" ], "type": "object" } }, { "description": "Return historical observations for an instrument code (up to 500 points). Use after price.latest when you need a short time series for the same code.", "inputSchema": { "additionalProperties": false, "properties": { "code": { "description": "Instrument code from catalog.list. Example: CL, GC, ZC.", "type": "string" }, "limit": { "description": "Number of historical points to return. Max 500, default 60.", "type": "number" } }, "required": [ "code" ], "type": "object" }, "name": "price.history", "outputSchema": { "properties": { "count": { "description": "Number of points returned", "type": "number" }, "data": { "description": "Historical observations, newest first or as stored", "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" }, "instrument": { "description": "Instrument code", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" } }, "required": [ "instrument", "series_id", "count", "data" ], "type": "object" } }, { "description": "Return the latest cash/fundies observation for one instrument code. Use catalog.list to discover codes such as CL, GC, or ZC. Response follows the shared observation contract with provenance and license tags.", "inputSchema": { "additionalProperties": false, "properties": { "code": { "description": "Instrument code from catalog.list. Example: CL, GC, ZC.", "type": "string" }, "currency": { "description": "Optional ISO currency to additionally express the price in, e.g. BRL. The observation itself stays in its catalog unit and remains the citable value; a `converted` block is added alongside it, citing the rate and its own as_of.", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "price.latest", "outputSchema": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" } }, { "description": "Realized volatility, change over window, and range for an instrument, computed over its stored history. Use this for 'how volatile is X' and 'how has X moved over the last year' — it answers both in one call, so prefer it over fetching price.history and computing yourself. Descriptive only: no signals or view, which live in decision.get.", "inputSchema": { "additionalProperties": false, "properties": { "code": { "description": "Instrument code from catalog.list. Example: CC, CL, GC.", "type": "string" }, "windows": { "description": "Windows to compute over, as a count and a unit. Example: [\"30d\", \"90d\", \"1y\"]. Defaults to those three.", "items": { "type": "string" }, "type": "array" } }, "required": [ "code" ], "type": "object" }, "name": "price.stats", "outputSchema": { "properties": { "as_of": { "description": "Economic date of the newest observation used", "type": "string" }, "change": { "description": "Change across each window, both endpoints dated", "items": { "properties": { "from": { "type": "number" }, "from_as_of": { "type": "string" }, "pct": { "type": [ "number", "null" ] }, "to": { "type": "number" }, "to_as_of": { "type": "string" }, "window": { "type": "string" } }, "required": [ "window", "from", "to", "from_as_of", "to_as_of" ], "type": "object" }, "type": "array" }, "input_series": { "description": "The window these figures were computed over. Dereference via price.history for the observations themselves.", "properties": { "from": { "type": "string" }, "n": { "type": "number" }, "series_id": { "type": "string" }, "to": { "type": "string" } }, "required": [ "series_id", "from", "to", "n" ], "type": "object" }, "instrument": { "description": "Instrument code", "type": "string" }, "license_tag": { "description": "Licence the derived figures may claim", "type": "string" }, "periods_per_year": { "description": "Observations per year implied by the series cadence; null when the cadence makes no promise and nothing can be annualized", "type": [ "number", "null" ] }, "range": { "description": "Min, max and mean over the retained history", "properties": { "max": { "type": "number" }, "mean": { "type": "number" }, "min": { "type": "number" } }, "required": [ "min", "max", "mean" ], "type": "object" }, "series_id": { "description": "Underlying series id", "type": "string" }, "unit": { "description": "Unit of the underlying price", "type": "string" }, "volatility": { "description": "Annualized realized volatility per window", "items": { "properties": { "annualized_pct": { "description": "Null when the window cannot support a figure", "type": [ "number", "null" ] }, "method": { "type": "string" }, "n": { "description": "Number of returns used", "type": "number" }, "reason": { "description": "Why no figure, when insufficient", "type": "string" }, "sufficient": { "type": "boolean" }, "window": { "type": "string" } }, "required": [ "window", "n", "annualized_pct", "sufficient" ], "type": "object" }, "type": "array" } }, "required": [ "instrument", "series_id", "volatility", "change", "range", "input_series" ], "type": "object" } }, { "description": "Farm-gate producer prices by country for one commodity and year, from FAOSTAT. Use for 'where is this cheap at source' and for comparing what growers are actually paid across countries. THIS IS NOT A BENCHMARK: a producer price is what the farmer received, and differs from price.latest and from the export unit value in trade.partners — all three can be correct and several-fold apart. Covers seven crops only (ZC ZW ZS ZR KC CC CT); sugar, palm and livestock are deliberately unmapped because FAOSTAT prices a different product for those. Annual, usually one to two years behind.", "inputSchema": { "additionalProperties": false, "properties": { "commodity": { "description": "Instrument code. Example: KC for coffee.", "enum": [ "ZC", "ZW", "ZS", "ZR", "KC", "CC", "CT" ], "type": "string" }, "year": { "description": "Four-digit year; defaults to the latest available.", "type": "number" } }, "required": [ "commodity" ], "type": "object" }, "name": "producer.prices", "outputSchema": { "properties": { "commodity": { "type": "string" }, "countries": { "description": "Countries, cheapest first", "items": { "properties": { "area": { "type": "string" }, "catalog_unit": { "type": [ "string", "null" ] }, "far_from_peers": { "description": "Outside the peer band, either direction. Means 'worth a second look', NOT 'bad data' — the band catches both micro specialty crops and genuinely cheap large producers. Do not discard rows on this flag.", "type": "boolean" }, "flag": { "description": "FAO flag: A official, E estimated, I imputed, X external", "type": "string" }, "m49": { "description": "M49 code — joins to trade.flow country codes", "type": "string" }, "usd_per_catalog_unit": { "description": "The same figure in the instrument's own unit, null where no honest mass conversion exists", "type": [ "number", "null" ] }, "usd_per_tonne": { "type": "number" }, "vs_median": { "description": "Multiple of the peer median", "type": [ "number", "null" ] } }, "type": "object" }, "type": "array" }, "country_count": { "type": "number" }, "faostat_item": { "description": "The FAOSTAT item actually priced", "type": "string" }, "license_tag": { "type": "string" }, "notes": { "description": "Read before presenting any figure from this tool.", "items": { "type": "string" }, "type": "array" }, "peer_band_multiple": { "description": "The multiple of the median beyond which far_from_peers is set", "type": "number" }, "peer_median_usd_per_tonne": { "type": [ "number", "null" ] }, "source": { "type": "object" }, "vs_median_available": { "description": "False when too few countries report for a median to mean anything", "type": "boolean" }, "year": { "type": "number" }, "years_available": { "items": { "type": "number" }, "type": "array" } }, "required": [ "commodity", "year", "countries", "notes" ], "type": "object" } }, { "description": "FAOSTAT farm-gate producer prices by country for up to 20 crops in ONE call. A separate tool from producer.prices, for the same pricing reason as price.bundle. This is what a grower was paid at the farm gate — NOT an export unit value and NOT the benchmark price.latest returns; all three are correct and differ. Paid; charged only if at least one crop resolves.", "inputSchema": { "additionalProperties": false, "properties": { "codes": { "description": "Crop instrument codes, up to 20. Example: [\"CC\", \"KC\"].", "items": { "type": "string" }, "minItems": 1, "type": "array" }, "year": { "description": "Year to summarise. Defaults to the latest stored.", "type": "integer" } }, "required": [ "codes" ], "type": "object" }, "name": "producer.prices.bundle", "outputSchema": { "properties": { "commodities": { "type": "array" }, "count": { "type": "integer" }, "dropped_codes": { "items": { "type": "string" }, "type": "array" } }, "required": [ "count", "commodities" ], "type": "object" } }, { "description": "The release calendar joined to what each report last said: expected_at with a real Eastern offset, the last print's values, week-on-week change, the 5-year comparison, and a surprise label. Use this instead of calendar.get when you need the numbers as well as the timing — calendar.get answers only *when*. `last` is null when nothing is stored yet and surprise_label is null when no 5-year band exists; neither is ever guessed. Paid.", "inputSchema": { "additionalProperties": false, "properties": { "release_id": { "description": "One release id, as published by calendar.get", "enum": [ "eia-wpsr", "eia-ng", "cftc-cot", "usda-wasde", "usda-crop", "usda-esr" ], "type": "string" }, "window_days": { "description": "Keep only releases expected within this many days. Releases with no known date are excluded by a window.", "minimum": 0, "type": "integer" } }, "type": "object" }, "name": "releases.next", "outputSchema": { "properties": { "releases": { "description": "Releases, soonest first", "items": { "properties": { "cadence": { "description": "Release cadence", "type": "string" }, "expected_at": { "description": "Full timestamp with Eastern offset, or null when no clock time is published for this release", "type": [ "string", "null" ] }, "expected_date": { "description": "ISO date of the next expected release", "type": [ "string", "null" ] }, "last": { "description": "The last stored print, or null when nothing is stored for this release", "type": [ "object", "null" ] }, "name": { "description": "Release name", "type": "string" }, "notes": { "description": "Additional notes", "type": "string" }, "release_id": { "description": "Release id", "type": "string" }, "source": { "description": "Publishing agency", "enum": [ "EIA", "USDA", "CFTC" ], "type": "string" }, "source_url": { "description": "The agency's own page", "type": "string" } }, "required": [ "release_id", "name", "source", "cadence", "expected_date", "expected_at", "source_url", "notes", "last" ], "type": "object" }, "type": "array" } }, "required": [ "releases" ], "type": "object" } }, { "description": "Build a sector snapshot bundling prices, inventories, spreads, and related fundies for energy, metals, ags, or all sectors. Prefer this over calling many single-observation tools when you need a full sector picture.", "inputSchema": { "additionalProperties": false, "properties": { "sector": { "description": "Sector to snapshot. Use all to receive energy, metals, and ags together.", "enum": [ "energy", "metals", "ags", "all" ], "type": "string" } }, "required": [ "sector" ], "type": "object" }, "name": "snapshot.get", "outputSchema": { "properties": { "as_of": { "description": "Snapshot as-of timestamp", "type": "string" }, "cot": { "description": "COT rows when relevant", "items": { "type": "object" }, "type": "array" }, "crack_321": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "crop_progress": { "description": "Crop progress when relevant", "type": "object" }, "crush": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "export_sales": { "description": "Export sales when relevant", "type": "object" }, "freshness_note": { "description": "Freshness summary", "type": "string" }, "inventory": { "description": "Inventory rows when relevant", "items": { "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "type": "array" }, "prices": { "description": "Latest prices for the sector", "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" }, "sector": { "description": "Present for single-sector responses", "enum": [ "energy", "metals", "ags" ], "type": "string" }, "sectors": { "description": "Present when sector=all", "properties": { "ags": { "properties": { "as_of": { "description": "Snapshot as-of timestamp", "type": "string" }, "cot": { "description": "COT positioning rows when relevant", "items": { "type": "object" }, "type": "array" }, "crack_321": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "crop_progress": { "description": "Crop progress payload when relevant", "type": "object" }, "crush": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "export_sales": { "description": "Export sales payload when relevant", "type": "object" }, "freshness_note": { "description": "Freshness summary note", "type": "string" }, "inventory": { "description": "Inventory points when relevant", "items": { "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "type": "array" }, "prices": { "description": "Latest prices for the sector", "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" }, "sector": { "description": "Sector covered by this snapshot", "enum": [ "energy", "metals", "ags" ], "type": "string" }, "wasde": { "description": "WASDE payload when relevant", "type": "object" } }, "required": [ "sector", "as_of", "prices", "freshness_note" ], "type": "object" }, "energy": { "properties": { "as_of": { "description": "Snapshot as-of timestamp", "type": "string" }, "cot": { "description": "COT positioning rows when relevant", "items": { "type": "object" }, "type": "array" }, "crack_321": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "crop_progress": { "description": "Crop progress payload when relevant", "type": "object" }, "crush": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "export_sales": { "description": "Export sales payload when relevant", "type": "object" }, "freshness_note": { "description": "Freshness summary note", "type": "string" }, "inventory": { "description": "Inventory points when relevant", "items": { "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "type": "array" }, "prices": { "description": "Latest prices for the sector", "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" }, "sector": { "description": "Sector covered by this snapshot", "enum": [ "energy", "metals", "ags" ], "type": "string" }, "wasde": { "description": "WASDE payload when relevant", "type": "object" } }, "required": [ "sector", "as_of", "prices", "freshness_note" ], "type": "object" }, "metals": { "properties": { "as_of": { "description": "Snapshot as-of timestamp", "type": "string" }, "cot": { "description": "COT positioning rows when relevant", "items": { "type": "object" }, "type": "array" }, "crack_321": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "crop_progress": { "description": "Crop progress payload when relevant", "type": "object" }, "crush": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "export_sales": { "description": "Export sales payload when relevant", "type": "object" }, "freshness_note": { "description": "Freshness summary note", "type": "string" }, "inventory": { "description": "Inventory points when relevant", "items": { "properties": { "as_of": { "description": "Report week as-of date", "type": "string" }, "avg_5y": { "description": "Five-year average when known", "type": "number" }, "id": { "description": "Inventory point id", "type": "string" }, "name": { "description": "Series display name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "prior_week": { "description": "Prior-week level when known", "type": "number" }, "series_id": { "description": "EIA series id", "type": "string" }, "series_key": { "description": "Internal series key", "type": "string" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Latest inventory level", "type": "number" }, "vs_5y": { "description": "Deviation vs five-year average", "type": "number" }, "wow_change": { "description": "Week-over-week change", "type": "number" } }, "required": [ "id", "series_key", "series_id", "name", "value", "unit", "as_of", "observed_at" ], "type": "object" }, "type": "array" }, "prices": { "description": "Latest prices for the sector", "items": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "required": [ "instrument", "name", "value", "unit", "as_of", "observed_at", "freshness_class", "quality", "derived", "source", "license_tag", "provenance", "series_id" ], "type": "object" }, "type": "array" }, "sector": { "description": "Sector covered by this snapshot", "enum": [ "energy", "metals", "ags" ], "type": "string" }, "wasde": { "description": "WASDE payload when relevant", "type": "object" } }, "required": [ "sector", "as_of", "prices", "freshness_note" ], "type": "object" } }, "type": "object" }, "wasde": { "description": "WASDE payload when relevant", "type": "object" } }, "required": [ "as_of" ], "type": "object" } }, { "description": "For one commodity and year, compare countries as a source: what the grower was paid (FAOSTAT farm gate) against what it left the country for (UN Comtrade export unit value), plus the share reaching the grower. Ranked cheapest first on a named observable field — there is NO opportunity score, because the weights would be invented. Supply freight_usd / duty_rate_pct to add a landed cost; absent costs are never defaulted, they are listed in `missing`. Annual data: this supports structural comparison, not an arbitrage claim. Covers the seven crops FAOSTAT prices.", "inputSchema": { "additionalProperties": false, "properties": { "commodity": { "description": "Instrument code. Example: CC for cocoa.", "enum": [ "ZC", "ZW", "ZS", "ZR", "KC", "CC", "CT" ], "type": "string" }, "currency": { "description": "Optional ISO currency for an additional converted view.", "type": "string" }, "duty_rate_pct": { "description": "Caller-supplied duty rate, percent.", "type": "number" }, "freight_usd": { "description": "Caller-supplied freight per tonne.", "type": "number" }, "handling_usd": { "type": "number" }, "incoterm": { "enum": [ "EXW", "FOB", "CFR", "CIF" ], "type": "string" }, "insurance_usd": { "type": "number" }, "port_usd": { "type": "number" }, "year": { "description": "Four-digit year; defaults to the latest available.", "type": "number" } }, "required": [ "commodity" ], "type": "object" }, "name": "sourcing.compare", "outputSchema": { "properties": { "available": { "description": "False when fewer than two countries could be compared. Served free in that case.", "type": "boolean" }, "commodity": { "type": "string" }, "countries": { "description": "Cheapest first on the ranked field", "items": { "properties": { "country": { "properties": { "m49": { "type": "string" }, "name": { "type": "string" } }, "type": "object" }, "export_unit_value_usd_per_tonne": { "type": [ "number", "null" ] }, "far_from_peers": { "description": "Outside the peer band either way. Worth a look, not a verdict.", "type": "boolean" }, "farm_gate_usd_per_tonne": { "type": [ "number", "null" ] }, "farm_share_pct": { "description": "Farm gate over export unit value. A supply-chain signal, not a margin anyone earned.", "type": [ "number", "null" ] }, "landed_cost_usd_per_tonne": { "type": [ "number", "null" ] }, "reason": { "description": "Why a row is incomplete, when it is", "type": "string" }, "sufficient": { "type": "boolean" }, "vs_peer_median_pct": { "type": [ "number", "null" ] } }, "type": "object" }, "type": "array" }, "license_tag": { "type": "string" }, "missing": { "description": "Cost fields not supplied, hence excluded", "items": { "type": "string" }, "type": "array" }, "notes": { "description": "Read before presenting any figure from this tool.", "items": { "type": "string" }, "type": "array" }, "partial": { "type": "boolean" }, "ranked_by": { "description": "The observable field the list is sorted by", "type": "string" }, "sources_used": { "items": { "type": "string" }, "type": "array" }, "unavailable": { "description": "Sources that could not contribute, each with the reason", "items": { "properties": { "reason": { "type": "string" }, "source": { "type": "string" } }, "type": "object" }, "type": "array" }, "year": { "type": "number" }, "years_available": { "items": { "type": "number" }, "type": "array" } }, "required": [ "commodity", "year", "countries", "available", "notes" ], "type": "object" } }, { "description": "Compute a derived spread observation: 3-2-1 crack, soybean crush, or WTI-Brent basis (paid). type=calendar is a free Phase-2 stub that returns available=false until licensed curves exist. Prefer crack/crush/basis for live derived values with formula and inputs.", "inputSchema": { "additionalProperties": false, "properties": { "root": { "description": "Optional root symbol for calendar spreads. Example: CL. Ignored for crack/crush/basis.", "type": "string" }, "type": { "description": "Spread type to compute. Example: crack for 3-2-1 gasoline/distillate crack.", "enum": [ "crack", "crush", "basis", "calendar" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "name": "spread.get", "outputSchema": { "properties": { "as_of": { "description": "As-of date for the observation", "type": "string" }, "available": { "description": "False when the spread cannot be computed", "type": "boolean" }, "cite": { "description": "One-line citation for agents", "type": "string" }, "derived": { "description": "True when value is derived", "type": "boolean" }, "formula": { "description": "Derivation formula when derived", "type": "string" }, "freshness_class": { "description": "Freshness class for the series", "type": "string" }, "id": { "description": "Stable observation id", "type": "string" }, "inputs": { "description": "Input series ids when derived", "items": { "type": "string" }, "type": "array" }, "instrument": { "description": "Instrument code, e.g. CL", "type": "string" }, "legs_quality": { "description": "Per-leg quality when inputs are mixed", "items": { "properties": { "instrument": { "type": "string" }, "quality": { "type": "string" } }, "required": [ "instrument", "quality" ], "type": "object" }, "type": "array" }, "license_tag": { "description": "License / redistribution tag", "type": "string" }, "name": { "description": "Human-readable instrument name", "type": "string" }, "note": { "description": "Explanation when unavailable or partially degraded", "type": "string" }, "observed_at": { "description": "ISO timestamp when observed", "type": "string" }, "pct_change": { "description": "Percent change vs prior print", "type": "number" }, "prior": { "description": "Previous print value when history exists", "type": "number" }, "provenance": { "description": "Retrieval / cache provenance", "properties": { "cache_hit": { "type": "boolean" }, "cache_ttl_s": { "type": "number" }, "retrieved_at": { "type": "string" } }, "required": [ "retrieved_at", "cache_hit", "cache_ttl_s" ], "type": "object" }, "quality": { "description": "Data quality label", "type": "string" }, "raw_hash": { "description": "Hash of raw source payload", "type": "string" }, "root": { "description": "Calendar root when type=calendar", "type": "string" }, "series_id": { "description": "Underlying series id", "type": "string" }, "short_history": { "description": "Newest-first short history (≤8 points)", "items": { "properties": { "as_of": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "type": "array" }, "source": { "description": "Primary source provenance", "properties": { "name": { "type": "string" }, "series_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "name", "series_id", "url" ], "type": "object" }, "unit": { "description": "Unit of measure", "type": "string" }, "value": { "description": "Observed numeric value", "type": "number" } }, "type": "object" } }, { "description": "Volatility, change and range for up to 20 instruments in ONE call. A separate tool from price.stats, for the same pricing reason as price.bundle. Returns the same derived statistics over the full retained history per instrument, with per-instrument errors rather than a whole-call failure when one has no history. Paid; charged only if at least one instrument resolves.", "inputSchema": { "additionalProperties": false, "properties": { "codes": { "description": "Instrument codes, up to 20.", "items": { "type": "string" }, "minItems": 1, "type": "array" }, "windows": { "description": "Lookback windows, e.g. [\"30d\", \"90d\", \"1y\"]. Defaults to those three.", "items": { "type": "string" }, "type": "array" } }, "required": [ "codes" ], "type": "object" }, "name": "stats.bundle", "outputSchema": { "properties": { "count": { "type": "integer" }, "dropped_codes": { "items": { "type": "string" }, "type": "array" }, "stats": { "type": "array" } }, "required": [ "count", "stats" ], "type": "object" } }, { "description": "Deterministic trade arithmetic over numbers you supply: landed cost, trade margin, break-even price, or the effect of a USD move. Nothing is sourced — there is no free source for duty rates, freight or insurance, so an input you omit is excluded from the total and reported in `missing`, never defaulted to zero. Use price.latest first if you want a benchmark price to pass as unit_price.", "inputSchema": { "additionalProperties": true, "properties": { "amount": { "description": "fx_impact: amount held in the foreign currency.", "type": "number" }, "buy_price": { "description": "trade_margin, break_even: purchase price per unit.", "type": "number" }, "calculation": { "description": "Which calculation to run. Example: landed_cost.", "enum": [ "landed_cost", "trade_margin", "break_even", "fx_impact" ], "type": "string" }, "costs_usd": { "description": "trade_margin, break_even: other costs.", "type": "number" }, "duty_rate_pct": { "description": "landed_cost: your import duty rate, percent. Example: 8.", "type": "number" }, "freight_usd": { "description": "landed_cost: your freight cost. Omit and it is reported missing, not assumed zero.", "type": "number" }, "fx_rate": { "description": "landed_cost: units of quote_currency per USD. fx_impact: the rate to shock.", "type": "number" }, "handling_usd": { "description": "landed_cost: handling charges.", "type": "number" }, "incoterm": { "description": "landed_cost: decides which costs your price already carries, so it shapes `missing`. CIF already includes freight and insurance. Example: CIF.", "enum": [ "EXW", "FOB", "CFR", "CIF" ], "type": "string" }, "insurance_usd": { "description": "landed_cost: your insurance cost.", "type": "number" }, "port_usd": { "description": "landed_cost: port charges.", "type": "number" }, "price_unit": { "description": "landed_cost: unit of unit_price. Example: USD/metric ton.", "type": "string" }, "quantity": { "description": "Quantity. Example: 100.", "type": "number" }, "quantity_unit": { "description": "landed_cost: unit of quantity. Example: metric ton.", "type": "string" }, "quote_currency": { "description": "landed_cost: currency for the total. Needs fx_rate — no rate is sourced. Example: GHS.", "type": "string" }, "rate_unit": { "description": "fx_impact: direction of fx_rate, read not inferred. Example: GHS/USD means cedi per dollar.", "type": "string" }, "sell_price": { "description": "trade_margin: sale price per unit.", "type": "number" }, "unit_price": { "description": "landed_cost: price per unit. Example: 1133.13.", "type": "number" }, "usd_move_pct": { "description": "fx_impact: percent the USD strengthens. Example: 5.", "type": "number" } }, "required": [ "calculation" ], "type": "object" }, "name": "trade.calculate", "outputSchema": { "properties": { "assumptions": { "description": "Caller-supplied inputs, echoed", "items": { "type": "object" }, "type": "array" }, "calculation": { "description": "Which calculation ran", "type": "string" }, "components": { "description": "Each part of the build-up, with where its number came from", "items": { "properties": { "amount": { "type": "number" }, "formula": { "type": "string" }, "label": { "type": "string" }, "source": { "description": "caller_supplied, or observation:<id>", "type": "string" } }, "required": [ "label", "amount", "source" ], "type": "object" }, "type": "array" }, "disclaimer": { "type": "string" }, "formula": { "description": "How it was computed", "type": "string" }, "missing": { "description": "Inputs not supplied. Their components are excluded from the total, not defaulted.", "items": { "type": "string" }, "type": "array" }, "notes": { "description": "Caveats, including unmodelled distinctions", "items": { "type": "string" }, "type": "array" }, "partial": { "description": "True when anything is missing", "type": "boolean" }, "unit": { "description": "Unit of the result", "type": "string" }, "value": { "description": "The result", "type": "number" } }, "required": [ "calculation", "value", "unit", "components", "missing", "partial" ], "type": "object" } }, { "description": "Resolve a country to the UN M49 code the trade tools require, and list the HS headings this catalog maps. FREE. Call this BEFORE trade.flow, trade.partners or trade.ranking: those take a reporter code and there is no other way to discover one. Accepts ISO3, ISO2, a numeric M49 or an exact country name. Historical entities are excluded by default — twelve ISO3 codes resolve to more than one UN Comtrade entry and the expired one is never preferred, so IND gives India rather than pre-1974 India.", "inputSchema": { "additionalProperties": false, "properties": { "country": { "description": "ISO3, ISO2, numeric M49 or exact name to resolve. Omit to list HS headings only.", "type": "string" } }, "type": "object" }, "name": "trade.codes", "outputSchema": { "properties": { "commodities": { "description": "Instrument code to HS heading", "type": "array" }, "note": { "type": "string" }, "resolved": { "description": "The matched country, when one was asked for", "type": [ "object", "null" ] } }, "required": [ "commodities" ], "type": "object" } }, { "description": "Import or export volume and value between two countries for one commodity and year, from UN Comtrade. Use for 'how much X did A sell to B'. Pass countries as ISO alpha-3 (IND, GHA) and partner=WLD for the world total. Call trade.codes-equivalent discovery via /v1/trade/codes for valid values. Annual data; the response says whether the rows reconcile with the upstream's own total.", "inputSchema": { "additionalProperties": false, "properties": { "commodity": { "description": "Instrument code with an HS heading. Example: ZR for rice.", "type": "string" }, "flow": { "description": "Direction from the reporter's view. Example: export.", "enum": [ "import", "export" ], "type": "string" }, "partner": { "description": "Partner country, or WLD for the world total. Example: GHA.", "type": "string" }, "reporter": { "description": "Reporting country, ISO alpha-3 preferred. Example: IND.", "type": "string" }, "year": { "description": "Four-digit year. Example: 2023.", "type": "number" } }, "required": [ "commodity", "reporter", "year" ], "type": "object" }, "name": "trade.flow", "outputSchema": { "properties": { "commodity": { "type": "string" }, "complete": { "description": "Whether returned rows reconcile with the upstream's World total; null when there is nothing to compare", "type": [ "boolean", "null" ] }, "flow": { "type": "string" }, "found": { "description": "False when the upstream has no data for this cell", "type": "boolean" }, "hs_code": { "description": "Harmonised System heading queried", "type": "string" }, "license_tag": { "type": "string" }, "net_weight_kg": { "type": [ "number", "null" ] }, "partner": { "properties": { "code": { "type": "number" }, "name": { "type": "string" } }, "type": "object" }, "primary_value_usd": { "type": [ "number", "null" ] }, "reporter": { "properties": { "code": { "type": "number" }, "name": { "type": "string" } }, "type": "object" }, "shortfall_usd": { "type": [ "number", "null" ] }, "source": { "description": "series_id is the canonical query; url re-runs it", "type": "object" }, "year": { "type": "number" } }, "required": [ "commodity", "reporter", "partner", "year", "found" ], "type": "object" } }, { "description": "Every country one reporter traded a commodity with in a year, ranked by value, each with the implied unit value it paid or received. Use for 'where does Ghana sell its cocoa and at what price to each buyer' and for comparing prices across markets. Pass the reporter as ISO alpha-3 (GHA, IND). Annual data. Completeness is verifiable for this shape: the response says whether the partner rows reconcile with the upstream's own World total.", "inputSchema": { "additionalProperties": false, "properties": { "commodity": { "description": "Instrument code with an HS heading. Example: CC for cocoa.", "type": "string" }, "flow": { "description": "Direction from the reporter's view.", "enum": [ "import", "export" ], "type": "string" }, "limit": { "description": "Maximum rows returned, 1-200 (default 25).", "type": "number" }, "reporter": { "description": "Reporting country, ISO alpha-3 preferred. Example: GHA.", "type": "string" }, "year": { "description": "Four-digit year. Example: 2023.", "type": "number" } }, "required": [ "commodity", "reporter", "year" ], "type": "object" }, "name": "trade.partners", "outputSchema": { "properties": { "commodity": { "type": "string" }, "complete": { "description": "Whether the partner rows reconcile with the upstream's World total", "type": [ "boolean", "null" ] }, "flow": { "type": "string" }, "license_tag": { "type": "string" }, "notes": { "description": "Caveats the numbers cannot carry. Read these before presenting a unit value.", "items": { "type": "string" }, "type": "array" }, "partner_count": { "description": "Partners the upstream returned, before any limit", "type": "number" }, "partners": { "description": "Partners, highest value first", "items": { "properties": { "catalog_unit": { "type": [ "string", "null" ] }, "net_weight_kg": { "type": [ "number", "null" ] }, "partner": { "properties": { "code": { "type": "number" }, "name": { "type": "string" } }, "type": "object" }, "primary_value_usd": { "type": [ "number", "null" ] }, "unit_value_catalog": { "description": "The same figure in the instrument's own catalog unit, or null when there is no honest mass conversion (crude, gas and the grains price by volume or count).", "type": [ "number", "null" ] }, "unit_value_usd_per_kg": { "description": "Average realised price implied by this row (value / net weight). NOT a benchmark or spot price — it reflects the grades and terms that actually traded, and will differ from price.latest. Comparable across the rows of one response only.", "type": [ "number", "null" ] } }, "type": "object" }, "type": "array" }, "reporter": { "properties": { "code": { "type": "number" }, "name": { "type": "string" } }, "type": "object" }, "returned": { "type": "number" }, "shortfall_usd": { "type": [ "number", "null" ] }, "source": { "type": "object" }, "world_total_usd": { "type": [ "number", "null" ] }, "year": { "type": "number" } }, "required": [ "commodity", "reporter", "year", "partners", "notes" ], "type": "object" } }, { "description": "Largest exporting or importing countries for a commodity in a year, ranked by value, each with the implied unit value it realised. Use for 'who are the biggest cocoa exporters' and 'which sourcing market is cheapest'. EXPORTS ARE NOT PRODUCTION: a country can be a large exporter of something it does not grow — the Netherlands ranks sixth in cocoa exports and grows none. Completeness cannot be verified for this shape, so `complete` is always null.", "inputSchema": { "additionalProperties": false, "properties": { "commodity": { "description": "Instrument code with an HS heading. Example: CC for cocoa.", "type": "string" }, "flow": { "description": "export ranks exporters, import ranks importers.", "enum": [ "import", "export" ], "type": "string" }, "limit": { "description": "Maximum rows returned, 1-200 (default 25).", "type": "number" }, "year": { "description": "Four-digit year. Example: 2023.", "type": "number" } }, "required": [ "commodity", "year" ], "type": "object" }, "name": "trade.ranking", "outputSchema": { "properties": { "commodity": { "type": "string" }, "complete": { "description": "Always null here: the upstream publishes no aggregate over all reporters to reconcile against", "type": [ "boolean", "null" ] }, "flow": { "type": "string" }, "license_tag": { "type": "string" }, "notes": { "description": "Caveats the numbers cannot carry. Read these before presenting a unit value.", "items": { "type": "string" }, "type": "array" }, "reporter_count": { "description": "Reporters the upstream returned, before any limit", "type": "number" }, "reporters": { "description": "Countries, highest value first. Ranked by this service, not by the upstream, which returns rows ordered by country code.", "items": { "properties": { "catalog_unit": { "type": [ "string", "null" ] }, "net_weight_kg": { "type": [ "number", "null" ] }, "primary_value_usd": { "type": [ "number", "null" ] }, "reporter": { "properties": { "code": { "type": "number" }, "name": { "type": "string" } }, "type": "object" }, "unit_value_catalog": { "description": "The same figure in the instrument's own catalog unit, or null when there is no honest mass conversion (crude, gas and the grains price by volume or count).", "type": [ "number", "null" ] }, "unit_value_usd_per_kg": { "description": "Average realised price implied by this row (value / net weight). NOT a benchmark or spot price — it reflects the grades and terms that actually traded, and will differ from price.latest. Comparable across the rows of one response only.", "type": [ "number", "null" ] } }, "type": "object" }, "type": "array" }, "returned": { "type": "number" }, "source": { "type": "object" }, "year": { "type": "number" } }, "required": [ "commodity", "year", "reporters", "notes" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:e0448706e5e494ca8dd16a8357f56c22f049f207b15c4909caeb9a0843d956d8 | sha256sum