MetalsLookup

Metals envelope (LIQ-1048). Default GET serves stored canonicalEnrichment.metals + .weight. force_refresh=true acquires via the engine and persists.

  • asset_id
    Type: string
    required
  • identifier
    Type: string
    required
  • lane
    Type: string | null
    required

    Resolve lane (metals for this API).

  • schema_version
    Type: string
    required
  • as_of
    Type: string | nullFormat: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • assurance_markers
    Type: array of string | null
  • cache_hit
    Type: boolean | null

    true when the default GET served stored canonical metals/weight.

  • compositions
    Type: object | null

    Grouped primary + secondary composition (same rows as the lists above).

    Properties: 2
  • data_match
    Type: boolean | null
  • device_weight_kg
    Type: number | null
  • downgraded_from
    Type: object | null
    Properties: 2
  • grounding
    Type: string | null
  • iq_level
    Type: string | null

    IQ on the stored (or just-acquired) canonical metals/weight document.

  • listing_id
    Type: string | null
  • listing_slug
    Type: string | null
  • materials
    Type: array of object | null

    IQ1 composition rows (key, mass_fraction, mass_kg).

    Properties: 3
  • materials_value_usd
    Type: number | null
  • message
    Type: string | null
  • no_match_reason
    Type: string | null

    NOT_ENRICHED when default GET finds no stored metals/weight. After acquire, contractual miss reasons from the engine.

  • numeric_score
    Type: number | null
  • primary_components
    Type: array of MetalCompositionComponent | null

    Primary (macro) composition rows (material + percentage).

    Properties: 3
  • primary_fraction
    Type: number | null

    IQ1 dominant mass fraction (0–1) when stored.

  • recovered_pct
    Type: number | null
  • retrieved_at
    Type: string | nullFormat: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • secondary_components
    Type: array of MetalCompositionComponent | null
    Properties: 3
  • source_slug
    Type: string | null
  • total_input_kg
    Type: number | null
  • total_recovered_kg
    Type: number | null
  • vendor_raw

    Present when vendor_raw=true. Same shape as carbon vendor_raw.

    Present when vendor_raw=true. Same shape as carbon vendor_raw.

    • domain
      Type: string
      required
    • payload
      Type: object
      required
      Properties: 1
    • retrieved_at
      Type: stringFormat: date-time
      required

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • source
      Type: string
      required