Physical prices only
References, assessments, averages, and trade unit values remain distinct.
Read the methodology →All APIs
Regional Coal Prices API
Regional physical coal prices across admitted markets, with source-native units, grades, dates, and history.
First request
Quickstart →curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/coal/physical" \
--header "Authorization: Bearer $NARWHAL_API_KEY"Example response Illustrative response · not a live request
{
"series": [
{
"series_id": "eia-us-steam-export-average",
"market": "USA",
"coal_type": "thermal",
"price_type": "export_unit_value",
"currency": "USD",
"unit": "short_ton",
"frequency": "quarterly"
}
],
"next_cursor": null
}Endpoints
GETDiscover physical coal series/v1/commodities/coal/physical
GETRead the latest physical coal price/v1/commodities/coal/physical/{series_id}
GETRead physical coal price history/v1/commodities/coal/physical/{series_id}/observations
Sources and methodology
Dated observations
Latest values and history retain their priced periods and publication dates.
Native grades and units
Calorific values, ranges, delivery basis, currency, and units stay explicit.
Coverage
View coverage →Discover the admitted series first. It returns each market, price type, grade data, coverage interval, and source-native quote unit.
Explore related pages
API reference
REST and MCP operation details.
Open the reference →Coverage
Markets, dates, and source status.
View coverage →Common questions
Does this include coal futures?
No. This API covers physical-market prices only.
How do I find a grade or market?
Use discovery and filter with the source-specific market, coal type, price type, or calorific fields.