# Get Aluminium market prices

Retrieve prices for the Aluminium market with dynamic filtering.

Available filters for Aluminium:
- products, priceCategories, priceTypes (base filters)
- incoterms, countries, regions (market-specific)
- codes (exclusive filter - when used, only dateFrom/dateTo allowed)

Endpoint: POST /aluminium
Version: 1.0.0
Security: bearerAuth, api_key

## Request fields (application/json):

  - `filters` (object)

  - `filters.codes` (array)
    Exclusive filter - when provided, only dateFrom and dateTo are allowed.
Filter by specific price codes.
    Example: ["LI-0001","LI-0002"]

  - `filters.dateFrom` (string)
    Start date for price series (YYYY-MM-DD)
    Example: "2024-01-01"

  - `filters.dateTo` (string)
    End date for price series (YYYY-MM-DD)
    Example: "2024-12-31"

  - `filters.products` (array)
    Filter by product names
    Example: ["Lithium Carbonate"]

  - `filters.priceCategories` (array)
    Filter by price categories
    Example: ["Spot","Contract"]

  - `filters.priceTypes` (array)
    Filter by price types
    Example: ["Payable","Price"]

  - `filters.incoterms` (array)

  - `filters.countries` (array)

  - `filters.regions` (array)

  - `options` (object)

  - `options.includeSeries` (boolean)
    Include price series data

  - `options.includeSummary` (boolean)
    Include summary statistics

  - `options.currency` (string)
    ISO 4217 currency code for conversion
    Example: "USD"

  - `options.unitOfMeasure` (string)
    Unit of measure for conversion
    Example: "tonne"

## Response 200 fields (application/json):

  - `$metadata` (object)

  - `$metadata.market` (string)
    Market name

  - `data` (array)

  - `data.code` (string)
    Unique price code

  - `data.name` (string)
    Full price name

  - `data.shortName` (string)
    Short name

  - `data.specification` (array)
    Price specification items with structured data

  - `data.specification.name` (string)
    Specification attribute name
    Example: "Purity"

  - `data.specification.value` (string)
    Specification attribute value
    Example: "99.5%"

  - `data.specification.order` (integer)
    Display order for the specification
    Example: 1

  - `data.assessmentLaunchedAt` (string)
    Date when assessment was launched

  - `data.lastAssessedAt` (string)
    Date of last assessment

  - `data.product` (object)

  - `data.product.id` (string)

  - `data.product.name` (string)

  - `data.product.alias` (string)

  - `data.product.chemicalCode` (string)

  - `data.product.isSustainable` (boolean)

  - `data.priceCategory` (object)

  - `data.frequency` (object)

  - `data.frequency.shortName` (string)

  - `data.purity` (object)

  - `data.incoterm` (object)

  - `data.country` (object)

  - `data.region` (object)

  - `data.tradeType` (object)

  - `data.grade` (string)

  - `data.capacity` (object)

  - `data.thickness` (object)

  - `data.cellFormat` (object)

  - `data.meshSize` (object)

  - `data.service` (object)

  - `data.subProduct` (object)

  - `data.feedstock` (object)

  - `data.sulphur` (object)

  - `data.unitOfMeasure` (object)

  - `data.unitOfMeasure.symbol` (string)

  - `data.currency` (object)

  - `data.currency.iso` (string)

  - `data.priceType` (object)

  - `data.isIoscoAssured` (boolean)
    Indicates if the grade is IOSCO assured

  - `data.summary` (object)

  - `data.summary.latestPublication` (object)

  - `data.summary.latestPublication.date` (string)

  - `data.summary.latestPublication.valueHigh` (number,null)

  - `data.summary.latestPublication.valueLow` (number,null)

  - `data.summary.latestPublication.valueMid` (number)

  - `data.summary.previousPublication` (object)

  - `data.summary.changes` (object)

  - `data.summary.changes.unit` (string)

  - `data.summary.changes.latest` (number)

  - `data.summary.changes.daily` (number)

  - `data.summary.changes.weekly` (number)

  - `data.summary.changes.biWeekly` (number)

  - `data.summary.changes.monthly` (number)

  - `data.summary.changes.quarterly` (number)

  - `data.summary.changes.sixMonths` (number)

  - `data.summary.changes.yearToDate` (number)

  - `data.summary.changes.yearOnYear` (number)

  - `data.series` (array)

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.location` (string)
    Example: "body"

  - `errors.code` (string)
    Example: "invalid_type"

  - `errors.property` (string)
    Example: "filters.dateFrom"

  - `errors.message` (string)
    Example: "Expected string, received array"

## Response 401 fields (application/json):

  - `code` (string)
    Example: "AUTH-0001"

  - `message` (string)
    Example: "Token expired"

## Response 403 fields (application/json):

  - `code` (string)
    Example: "AUTH-0010"

  - `message` (string)
    Example: "Forbidden"