Health check endpoints
Prices API V3 - OpenAPI 3.0 (1.0.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.
Download OpenAPI description
Overview
Languages
Servers
Mock server
https://api-docs.benchmarkminerals.com/_mock/apis/prices
Production server
https://api.benchmarkminerals.com/v3/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
)- Mock serverhttps://api-docs.benchmarkminerals.com/_mock/apis/prices/recycling
- Production serverhttps://api.benchmarkminerals.com/v3/prices/recycling
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
- Basic request
- Filtered by date range
- Filter by product codes
- List available price series
- Include summary statistics
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
}
}'Response
application/json
- withSeries
- withSummary
- availablePrices
{ "$metadata": { "market": "Recycling" }, "data": [ { … } ] }