---
title: "Get latest values for all commodity indicators"
method: GET
path: "/v1/commodities/latest"
tags: ["commodities"]
---

# Get latest values for all commodity indicators

`GET /v1/commodities/latest`

## Request

- Base URL: `https://api.fxmacrodata.com`
- URL: `https://api.fxmacrodata.com/v1/commodities/latest`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer

## Query parameters

- `api_key` string: Your Individual or Business API key

## Response `200`

Successful Response

- CommoditiesLatestResponse
  - `currency` string, nullable
  - `source` string, nullable
  - `as_of` string, nullable: Newest observation date across available indicators; this does not certify that every indicator is current.
  - `is_stale` boolean, nullable
  - `stale_indicators` string[], nullable
  - `freshness` CommodityLatestFreshness
    - `status` string, nullable: Aggregate freshness: current, partial, or failed. Inspect each indicator's date and quality for its own freshness.
    - `configured_count` integer, nullable
    - `available_count` integer, nullable
    - `oldest_available_date` string, nullable
    - `newest_available_date` string, nullable
    - `stale_indicators` string[], nullable
    - `unavailable_indicators` string[], nullable
    - `source_failure_indicators` string[], nullable
    - `unknown_freshness_indicators` string[], nullable
  - `count` integer, nullable
  - `data` CommodityLatestItem[], nullable
    - `indicator` string, nullable
    - `unit` string, nullable
    - `frequency` string, nullable
    - `has_official_forecast` boolean, nullable
    - `last_updated` string, nullable
    - `observation_date` string, nullable: Official observation date of latest; an alias of latest.date.
    - `latest_available_date` string, nullable
    - `is_stale` boolean, nullable
    - `data_lag_days` integer, nullable
    - `ingest_status` CommodityIngestStatus
      - `state` string, nullable
      - `last_attempt_at` string, nullable
      - `last_success_at` string, nullable
      - `latest_available_date` string, nullable
      - `data_lag_days` integer, nullable
      - `is_stale` boolean, nullable
      - `error_code` string, nullable
    - `data_quality` DataQuality
      - `source_freshness` string, nullable
      - `source_monitoring_complete` boolean, nullable
      - `known_source_gap` boolean, nullable
      - `source_checked_at` integer, nullable
      - `source_check_expires_at` integer, nullable
      - `latest_published_period` string, nullable
      - `source_permission_status` string, nullable
      - `commodity_coverage` CommodityCoverage
        - `scope` string, required
        - `requested_start` string, nullable
        - `requested_end` string, nullable
        - `available_start` string, nullable
        - `available_end` string, nullable
        - `input_row_count` integer, required
        - `row_count` integer, required
        - `distinct_date_count` integer, required
        - `duplicate_date_row_count` integer, required
        - `excluded_weekend_row_count` integer, required
        - `invalid_date_row_count` integer, required
        - `expected_weekday_label_count` integer, required
        - `missing_weekday_label_count` integer, required
        - `largest_missing_weekday_run` integer, required
        - `largest_calendar_gap_days` integer, required
        - `missing_weekday_ranges` CommodityMissingWeekdayRange[], required
          - `start_date` string, required
          - `end_date` string, required
          - `weekday_count` integer, required
        - `longest_continuous_weekday_segment` CommodityCoverageSegment, required
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `row_count` integer, required
        - `latest_continuous_weekday_segment` CommodityCoverageSegment, required
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `row_count` integer, required
        - `sparse_history` boolean, required
        - `coverage_basis` string, required
        - `continuous_coverage_verified` boolean
        - `reference_only` boolean
        - `executable_quotes` boolean
        - `provenance_version` integer, required
        - `repaired_excluded_weekend_row_count` integer
        - `repaired_invalid_date_row_count` integer
      - `stored_history_coverage` CommodityCoverage
        - `scope` string, required
        - `requested_start` string, nullable
        - `requested_end` string, nullable
        - `available_start` string, nullable
        - `available_end` string, nullable
        - `input_row_count` integer, required
        - `row_count` integer, required
        - `distinct_date_count` integer, required
        - `duplicate_date_row_count` integer, required
        - `excluded_weekend_row_count` integer, required
        - `invalid_date_row_count` integer, required
        - `expected_weekday_label_count` integer, required
        - `missing_weekday_label_count` integer, required
        - `largest_missing_weekday_run` integer, required
        - `largest_calendar_gap_days` integer, required
        - `missing_weekday_ranges` CommodityMissingWeekdayRange[], required
          - `start_date` string, required
          - `end_date` string, required
          - `weekday_count` integer, required
        - `longest_continuous_weekday_segment` CommodityCoverageSegment, required
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `row_count` integer, required
        - `latest_continuous_weekday_segment` CommodityCoverageSegment, required
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `row_count` integer, required
        - `sparse_history` boolean, required
        - `coverage_basis` string, required
        - `continuous_coverage_verified` boolean
        - `reference_only` boolean
        - `executable_quotes` boolean
        - `provenance_version` integer, required
        - `repaired_excluded_weekend_row_count` integer
        - `repaired_invalid_date_row_count` integer
      - `point_in_time_basis` string, nullable
      - `is_official` boolean, required
      - `is_proxy` boolean, required
      - `is_fallback` boolean, required
      - `is_stale` boolean, required
      - `has_announcement_datetime` boolean, required
      - `point_in_time_safe` boolean, required: Whether the returned values have verified availability and vintage evidence; estimated release times do not qualify.
      - `unverified_vintage_count` integer
      - `unknown_publication_time_count` integer
      - `latest_available_date` string, nullable
      - `last_updated` string, nullable
      - `data_lag_days` integer, nullable
      - `source_name` string, nullable
      - `source_type` 'official' | 'public' | 'fallback' | 'derived', required
      - `is_derived` boolean
      - `row_count` integer
      - `announcement_datetime_count` integer
      - `missing_announcement_datetime_count` integer
      - `has_assumed_release_times` boolean: True when at least one row in the quality scope carries a publication timestamp derived from the publication lag measured on that series' own confirmed releases, because no official release calendar reaches the period.
      - `assumed_release_time_count` integer: Number of rows in the quality scope whose publication timestamp was derived rather than captured. Compare against row_count to size the derived portion of the requested window.
      - `bounded_release_time_count` integer: Legacy rows carrying an upper-bound estimate flag; this does not certify replay safety.
      - `unbounded_release_time_count` integer: Assumed timestamps without proven availability bounds.
      - `quality_scope` string
      - `stale_after_days` integer, nullable
      - `requested_window_has_data` boolean, nullable
      - `requested_window_latest_date` string, nullable
      - `requested_window_includes_latest_available` boolean, nullable
      - `page_includes_latest_available` boolean, nullable
      - `returned_latest_available_before_window` boolean, nullable
      - `staleness_days` integer, nullable
      - `reason` string, nullable
      - `datetime_field` string, nullable
      - `datetime_precision` string, nullable
      - `datetime_semantics` string, nullable
      - `source_legs` object[], nullable
      - `historical_point_in_time` PointInTimeCompleteness: Coverage of source-confirmed publication timestamps for a dataset.
        - `row_count` integer, required
        - `announcement_datetime_count` integer, required
        - `missing_announcement_datetime_count` integer, required
        - `assumed_release_time_count` integer
        - `bounded_release_time_count` integer
        - `unbounded_release_time_count` integer
        - `unverified_vintage_count` integer
        - `unknown_publication_time_count` integer
        - `point_in_time_safe` boolean, required
    - `latest` CommodityObservation
      - `source_permission_status` string, nullable
      - `date` string, nullable
      - `val` number, nullable
      - `announcement_datetime` integer, nullable
      - `source` string, nullable
      - `source_url` string, nullable
      - `source_type` string, nullable
      - `source_chart_timestamp` integer, nullable
      - `source_chart_timestamp_ms` integer, nullable
      - `source_chart_period` string, nullable
      - `quote_time_status` string, nullable
      - `sampling_method` string, nullable
      - `publication_time_status` string, nullable
      - `point_in_time_safe` boolean, nullable
      - `provenance_version` integer, nullable
      - `is_official` boolean, nullable
      - `source_series_id` string, nullable
      - `announcement_date` string, nullable
      - `announcement_timezone` string, nullable
      - `time_announced` boolean, nullable
      - `release_time_status` string, nullable
      - `release_date_status` string, nullable
      - `source_value` number, nullable
      - `source_unit` string, nullable
      - `conversion_rate` number, nullable
      - `conversion_unit` string, nullable
      - `conversion_source` string, nullable
      - `fallback_for_source` string, nullable
      - `cross_check_source` string, nullable
      - `cross_check_series_id` string, nullable
      - `cross_check_val` number, nullable
      - `cross_check_divergence_pct` number, nullable
      - `cross_check_divergent` boolean, nullable
    - `previous` CommodityObservation
      - `source_permission_status` string, nullable
      - `date` string, nullable
      - `val` number, nullable
      - `announcement_datetime` integer, nullable
      - `source` string, nullable
      - `source_url` string, nullable
      - `source_type` string, nullable
      - `source_chart_timestamp` integer, nullable
      - `source_chart_timestamp_ms` integer, nullable
      - `source_chart_period` string, nullable
      - `quote_time_status` string, nullable
      - `sampling_method` string, nullable
      - `publication_time_status` string, nullable
      - `point_in_time_safe` boolean, nullable
      - `provenance_version` integer, nullable
      - `is_official` boolean, nullable
      - `source_series_id` string, nullable
      - `announcement_date` string, nullable
      - `announcement_timezone` string, nullable
      - `time_announced` boolean, nullable
      - `release_time_status` string, nullable
      - `release_date_status` string, nullable
      - `source_value` number, nullable
      - `source_unit` string, nullable
      - `conversion_rate` number, nullable
      - `conversion_unit` string, nullable
      - `conversion_source` string, nullable
      - `fallback_for_source` string, nullable
      - `cross_check_source` string, nullable
      - `cross_check_series_id` string, nullable
      - `cross_check_val` number, nullable
      - `cross_check_divergence_pct` number, nullable
      - `cross_check_divergent` boolean, nullable
    - `pct_diff_prev` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api.md) · [All operations](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fxmacrodata/apis/fx-macrodata-api/revisions/fadaa543b154?raw)