# Prices API V3 - OpenAPI 3.0 API for retrieving commodity 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 Version: 1.0.0 ## Servers Production server ``` https://api.benchmarkminerals.com/v3/prices ``` ## Security ### bearerAuth JWT Bearer token authentication Type: http Scheme: bearer Bearer Format: JWT ### api_key API Key authentication with scope-based authorization. Available scopes: - prices:lithium - Access to Lithium market prices - prices:manganese - Access to Manganese market prices - prices:lithium-ion-battery - Access to Lithium Ion Battery market prices - prices:cobalt - Access to Cobalt market prices - prices:anodes - Access to Anodes market prices - prices:cathodes - Access to Cathodes market prices - prices:electrolyte - Access to Electrolyte market prices - prices:natural-graphite - Access to Natural Graphite market prices - prices:rare-earths - Access to Rare Earths market prices - prices:synthetic-graphite - Access to Synthetic Graphite market prices - prices:recycling - Access to Recycling market prices - prices:nickel - Access to Nickel market prices - prices:aluminium - Access to Aluminium market prices - prices:binders-and-additives - Access to Binders and Additives market prices - prices:precursor - Access to Precursor market prices - prices:solvent - Access to Solvent market prices - prices:copper - Access to Copper market prices Type: apiKey In: header Name: x-api-key ## Download OpenAPI description [Prices API V3 - OpenAPI 3.0](https://api-docs.benchmarkminerals.com/_bundle/apis/@v3/prices.yaml) ## Health Health check endpoints ### Health check - [GET /health](https://api-docs.benchmarkminerals.com/apis/prices/health/gethealth.md): Returns the health status of the API. This endpoint does not require authentication. ## Lithium Lithium market prices ### Get Lithium market prices - [POST /lithium](https://api-docs.benchmarkminerals.com/apis/prices/lithium/getlithiumprices.md): Retrieve prices for the Lithium market with dynamic filtering. Available filters for Lithium: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions, tradeTypes, grades (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Manganese Manganese market prices ### Get Manganese market prices - [POST /manganese](https://api-docs.benchmarkminerals.com/apis/prices/manganese/getmanganeseprices.md): Retrieve prices for the Manganese market with dynamic filtering. Available filters for Manganese: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions, tradeTypes (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Lithium Ion Battery Lithium Ion Battery market prices ### Get Lithium Ion Battery market prices - [POST /lithium-ion-battery](https://api-docs.benchmarkminerals.com/apis/prices/lithium-ion-battery/getlithiumionbatteryprices.md): Retrieve prices for the Lithium Ion Battery market with dynamic filtering. Available filters for Lithium Ion Battery: - products, priceCategories, priceTypes (base filters) - capacities, cellFormats, incoterms, countries, regions, tradeTypes (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Cobalt Cobalt market prices ### Get Cobalt market prices - [POST /cobalt](https://api-docs.benchmarkminerals.com/apis/prices/cobalt/getcobaltprices.md): Retrieve prices for the Cobalt market with dynamic filtering. Available filters for Cobalt: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Anodes Anodes market prices ### Get Anodes market prices - [POST /anodes](https://api-docs.benchmarkminerals.com/apis/prices/anodes/getanodesprices.md): Retrieve prices for the Anodes market with dynamic filtering. Available filters for Anodes: - products, priceCategories, priceTypes (base filters) - capacities, purities, incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Cathodes Cathodes market prices ### Get Cathodes market prices - [POST /cathodes](https://api-docs.benchmarkminerals.com/apis/prices/cathodes/getcathodesprices.md): Retrieve prices for the Cathodes market with dynamic filtering. Available filters for Cathodes: - products, priceCategories, priceTypes (base filters) - capacities, incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Electrolyte Electrolyte market prices ### Get Electrolyte market prices - [POST /electrolyte](https://api-docs.benchmarkminerals.com/apis/prices/electrolyte/getelectrolyteprices.md): Retrieve prices for the Electrolyte market with dynamic filtering. Available filters for Electrolyte: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Natural Graphite Natural Graphite market prices ### Get Natural Graphite market prices - [POST /natural-graphite](https://api-docs.benchmarkminerals.com/apis/prices/natural-graphite/getnaturalgraphiteprices.md): Retrieve prices for the Natural Graphite market with dynamic filtering. Available filters for Natural Graphite: - products, priceCategories, priceTypes (base filters) - meshSizes, purities, incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Rare Earths Rare Earths market prices ### Get Rare Earths market prices - [POST /rare-earths](https://api-docs.benchmarkminerals.com/apis/prices/rare-earths/getrareearthsprices.md): Retrieve prices for the Rare Earths market with dynamic filtering. Available filters for Rare Earths: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Synthetic Graphite Synthetic Graphite market prices ### Get Synthetic Graphite market prices - [POST /synthetic-graphite](https://api-docs.benchmarkminerals.com/apis/prices/synthetic-graphite/getsyntheticgraphiteprices.md): Retrieve prices for the Synthetic Graphite market with dynamic filtering. Available filters for Synthetic Graphite: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions, services (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Recycling Recycling market prices ### Get Recycling market prices - [POST /recycling](https://api-docs.benchmarkminerals.com/apis/prices/recycling/getrecyclingprices.md): 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) ## Nickel Nickel market prices ### Get Nickel market prices - [POST /nickel](https://api-docs.benchmarkminerals.com/apis/prices/nickel/getnickelprices.md): Retrieve prices for the Nickel market with dynamic filtering. Available filters for Nickel: - products, priceCategories, priceTypes (base filters) - purities, incoterms, countries, regions, services (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Aluminium Aluminium market prices ### Get Aluminium market prices - [POST /aluminium](https://api-docs.benchmarkminerals.com/apis/prices/aluminium/getaluminiumprices.md): 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) ## Binders And Additives Binders and Additives market prices ### Get Binders and Additives market prices - [POST /binders-and-additives](https://api-docs.benchmarkminerals.com/apis/prices/binders-and-additives/getbindersandadditivesprices.md): Retrieve prices for the Binders and Additives market with dynamic filtering. Available filters for Binders and Additives: - products, priceCategories, priceTypes (base filters) - incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Precursor Precursor market prices ### Get Precursor market prices - [POST /precursor](https://api-docs.benchmarkminerals.com/apis/prices/precursor/getprecursorprices.md): Retrieve prices for the Precursor market with dynamic filtering. Available filters for Precursor: - products, priceCategories, priceTypes (base filters) - incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Solvent Solvent market prices ### Get Solvent market prices - [POST /solvent](https://api-docs.benchmarkminerals.com/apis/prices/solvent/getsolventprices.md): Retrieve prices for the Solvent market with dynamic filtering. Available filters for Solvent: - products, priceCategories, priceTypes (base filters) - incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed) ## Copper Copper market prices ### Get Copper market prices - [POST /copper](https://api-docs.benchmarkminerals.com/apis/prices/copper/getcopperprices.md): Retrieve prices for the Copper market with dynamic filtering. Available filters for Copper: - products, priceCategories, priceTypes (base filters) - incoterms, countries, regions (market-specific) - codes (exclusive filter - when used, only dateFrom/dateTo allowed)