# Benchmark Mineral Intelligence

> IOSCO-assured price reporting agency and market intelligence provider for the lithium-ion battery and energy-transition supply chain. The Benchmark Prices API v2 exposes 36 read-only operations covering assessed prices, summaries and composite indices across 14 markets, from lithium and cobalt through cathode, anode, battery cells and black mass.

Generated by API Evangelist (apis.io) from the provider-published OpenAPI at https://www.benchmarkminerals.com/prices-api.yml. Benchmark does not publish an llms.txt of its own.

## API

- [API overview](https://www.benchmarkminerals.com/api): what the Prices API covers and how to get a key
- [API reference](https://www.benchmarkminerals.com/api/docs): rendered reference (client-side; the spec URL is in the page source)
- [OpenAPI 3.0.3 specification](https://www.benchmarkminerals.com/prices-api.yml): the machine-readable contract
- Base URL: `https://api.benchmarkminerals.com/v2`
- Authentication: API key in the `x-api-key` request header, retrieved from the subscription section of your account
- Shape: every operation is a POST carrying a filter object; the surface is read-only and has no pagination

## Agent surface

- MCP endpoint: `https://mcp.benchmarkminerals.com/mcp` (remote, OAuth 2.0 bearer; tools/list requires a token)
- OAuth protected-resource metadata: https://mcp.benchmarkminerals.com/.well-known/oauth-protected-resource
- OAuth scopes: `benchmark-tools/sandbox.read`, `benchmark-tools/production.read`
- Authorization server: https://mcp-auth.benchmarkminerals.com/oauth2/authorize (Amazon Cognito, eu-west-2)

## Operations by market

### Spotlight
- `POST /prices/spotlight` — `spotlight-list-prices` — List spotlight prices

### Lithium
- `POST /prices/lithium` — `lithium-list-prices` — List prices
- `POST /prices/lithium/summary` — `lithium-summary` — Summary
- `POST /prices/lithium/index` — `lithium-index` — Index

### Cobalt
- `POST /prices/cobalt` — `cobalt-list-prices` — List prices
- `POST /prices/cobalt/summary` — `cobalt-summary` — Summary
- `POST /prices/cobalt/index` — `cobalt-index` — Index

### Nickel
- `POST /prices/nickel` — `nickel-list-prices` — List prices
- `POST /prices/nickel/summary` — `nickel-summary` — Summary
- `POST /prices/nickel/index` — `nickel-index` — Index

### Manganese
- `POST /prices/manganese` — `manganese-list-prices` — List prices
- `POST /prices/manganese/summary` — `manganese-summary` — Summary

### Natural Graphite
- `POST /prices/natural-graphite` — `natural-graphite-list-prices` — List prices
- `POST /prices/natural-graphite/summary` — `natural-graphite-summary` — Summary
- `POST /prices/natural-graphite/index` — `natural-graphite-index` — Index

### Synthetic-Graphite
- `POST /prices/synthetic-graphite` — `synthetic-graphite-list-prices` — List prices
- `POST /prices/synthetic-graphite/summary` — `synthetic-graphite-summary` — Summary
- `POST /prices/synthetic-graphite/index` — `synthetic-graphite-index` — Index

### Electrolyte
- `POST /prices/electrolyte` — `electrolyte-list-prices` — List prices
- `POST /prices/electrolyte/summary` — `electrolyte-summary` — Summary

### Anodes
- `POST /prices/anodes` — `anode-list-prices` — List prices
- `POST /prices/anodes/summary` — `anode-summary` — Summary
- `POST /prices/anodes/index` — `anode-index` — Index

### Cathodes
- `POST /prices/cathodes` — `cathodes-list-prices` — List prices
- `POST /prices/cathodes/summary` — `cathodes-summary` — Summary
- `POST /prices/cathodes/index` — `cathodes-index` — Index

### Lithium ion Battery
- `POST /prices/lithium-ion-battery` — `lithium-ion-battery-list-prices` — List prices
- `POST /prices/lithium-ion-battery/summary` — `lithium-ion-battery-summary` — Summary
- `POST /prices/lithium-ion-battery/index` — `lithium-ion-battery-index` — Index

### Black Mass
- `POST /prices/black-mass` — `black-mass-list-prices` — List prices
- `POST /prices/black-mass/summary` — `black-mass-summary` — Summary
- `POST /prices/black-mass/index` — `black-mass-index` — Index

### Rare Earths
- `POST /prices/rare-earths` — `rare-earths-list-prices` — List prices
- `POST /prices/rare-earths/summary` — `rare-earths-summary` — Summary
- `POST /prices/rare-earths/index` — `rare-earths-index` — Index

### Lithium ion Battery Raw Material
- `POST /prices/lithium-ion-battery-raw-material/index` — `lithium-ion-battery-raw-material-index` — Index

## Products

- [Price assessments](https://www.benchmarkminerals.com/price-assessments)
- [Price dashboard](https://www.benchmarkminerals.com/price-dashboard)
- [Excel add-in](https://www.benchmarkminerals.com/excel-add-in)
- [Benchmark App](https://www.benchmarkminerals.com/app)
- [Benchmark Source](https://source.benchmarkminerals.com)
- [Supply chain data](https://www.benchmarkminerals.com/supply-chain-data)
- [Plans](https://www.benchmarkminerals.com/plans)

## Company

- [About](https://www.benchmarkminerals.com/about)
- [Contact](https://www.benchmarkminerals.com/contact)
- [Technical support](https://www.benchmarkminerals.com/contact/a-technical-issue)
- [Terms](https://www.benchmarkminerals.com/terms)
- [Privacy](https://www.benchmarkminerals.com/privacy)
- [IOSCO assurance report](https://www.benchmarkminerals.com/independent-practitioners-assurance-report)

## Optional

- No SDKs, CLI, webhooks, AsyncAPI, agent card, status page or changelog are published as of 2026-09-04.
- Rate limits are applied but not published; there are no RateLimit-* headers and no 429 in the contract.
- Errors are not RFC 9457; a 400 returns a bare JSON array of validation objects.