Skip to content
Prices
/
/
Get Recycling (Black Mass...

Prices API V3 - OpenAPI 3.0 (1.0.0)

API for retrieving critical mineral and energy transition prices across multiple markets with support for currency conversion, unit of measure conversion, and dynamic filtering based on market configuration.

Authentication

All endpoints (except /health) require Bearer token authentication.

Authorization

  • Prices endpoints: Require market-specific authorization

Business Rules

  • Payable Type Prices: Are percentages, no currency/unit conversion applied
  • Price Type Prices: Are monetary values, support currency/unit conversion
Download OpenAPI description
prices.json
prices.yaml
Overview
E-mail
api-support@benchmarkminerals.com
Languages
Servers
Mock server
https://api-docs.benchmarkminerals.com/_mock/apis/prices
Production server
https://api.benchmarkminerals.com/v3/prices

Health

Health check endpoints

Operations

Lithium

Lithium market prices

Operations

Manganese

Manganese market prices

Operations

Lithium Ion Battery

Lithium Ion Battery market prices

Operations

Cobalt

Cobalt market prices

Operations

Anodes

Anodes market prices

Operations

Cathodes

Cathodes market prices

Operations

Electrolyte

Electrolyte market prices

Operations

Natural Graphite

Natural Graphite market prices

Operations

Rare Earths

Rare Earths market prices

Operations

Synthetic Graphite

Synthetic Graphite market prices

Operations

Recycling

Recycling market prices

Operations

Get Recycling market prices

Request

Retrieve prices for the Recycling market with dynamic filtering.

Available filters for Recycling:

  • products, priceCategories, priceTypes (base filters)
  • incoterms, countries, regions, subProducts, feedstocks (market-specific)
  • codes (exclusive filter - when used, only dateFrom/dateTo allowed)
Security
bearerAuth and api_key(Required scopes:
prices:recycling
)
Bodyapplication/jsonrequired
filtersobject
optionsobject(PriceOptions)
curl -i -X POST \
  https://api-docs.benchmarkminerals.com/_mock/apis/prices/recycling \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "filters": {
      "dateFrom": "2024-01-01",
      "dateTo": "2024-12-31"
    },
    "options": {
      "includeSeries": true
    }
  }'

Responses

Successful response with Recycling prices

Bodyapplication/json
$metadataobject
dataArray of objects(PriceRecord)
Response
application/json
{
  "$metadata": {
    "market": "Recycling"
  },
  "data": [
    { … }
  ]
}

Get Recycling (Black Mass) market index data

Request

Retrieve price index data for the Recycling market. Returns index values with summary statistics and time series data.

Security
bearerAuth and api_key(Required scopes:
prices:recycling
)
Bodyapplication/jsonrequired
filtersobject
curl -i -X POST \
  https://api-docs.benchmarkminerals.com/_mock/apis/prices/recycling/index \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "filters": {
      "dateFrom": "2024-01-01",
      "dateTo": "2024-12-31"
    }
  }'

Responses

Successful response with Recycling index data

Bodyapplication/json
$metadataobject
dataArray of objects(IndexDataItem)
Response
application/json
{
  "$metadata": {
    "market": "Black Mass"
  },
  "data": [
    { … }
  ]
}

Nickel

Nickel market prices

Operations

Aluminium

Aluminium market prices

Operations

Binders And Additives

Binders and Additives market prices

Operations

Precursor

Precursor market prices

Operations

Solvent

Solvent market prices

Operations

Copper

Copper market prices

Operations