BlackSeaGrain.io API

Real-time Ukraine grain & fertilizer prices, freight rates & margin analysis.LIVEFREE TIER

Commodities

60+

Locations

Freight oblasts

48x

Daily updates

Endpoints GET /api/prices — Grain & oilseed prices GET /api/fertilizers — Fertilizer prices NEW GET /api/freight — Inland freight rates GET /api/margins — Margin analysis NEW GET /api/commodities — List commodities GET /api/locations — List locations

Base URL

https://blackseagrain.io/api

Prices

GET /api/prices

Current buying prices across Ukraine: ports (FOB/CPT), factories, and inland (EXW). Updated every 30 minutes.

Authentication

All API endpoints require an API key. Pass it via X-API-Key header or ?api_key= query param. Use demo as a free test key.

curl -H "X-API-Key: demo" https://blackseagrain.io/api/prices

Parameters

Param	Type	Description
crop	string	Filter by commodity (partial match): `Corn`, `Soy`, `Wheat`, `Sunflower`, `Barley`, `Ammonium Nitrate`, `Urea`
location	string	Filter by location: `Odesa`, `Yuzhne`, `Chornomorsk`
type	string	Location type: `PORT`, `FACTORY`, `INLAND`
cat	string	Category filter: `grain` or `fertilizer`
currency	string	Filter: `uah` or `usd`
limit	int	Max results
offset	int	Skip N results (pagination)
format	string	`csv` for CSV download

Try it

/api/prices — all prices
/api/prices?crop=Corn¤cy=usd — Corn in USD
/api/prices?type=PORT&limit=10 — first 10 port prices
/api/prices?cat=fertilizer — all fertilizer prices
/api/prices?crop=Soy&format=csv — Soy as CSV

Fertilizer Prices

GET /api/fertilizers NEW

Current fertilizer prices across Ukraine: AN, Urea, DAP, MAP, NPK, NP, UAN, Ammonium Sulfate, and more. Multiple producers per product. Updated every 30 minutes.

Parameters

Param	Type	Description
product	string	Filter by product (partial match): `Ammonium Nitrate`, `Urea`, `DAP`, `NPK`, `MAP`, `UAN`
location	string	Filter by location: `Odesa`, `Chornomorsk`, `Mykolaiv`
producer	string	Filter by producer: `Agropolychim`, `SOCAR`, `OSTCHEM`
limit	int	Max results
offset	int	Skip N results (pagination)
format	string	`csv` for CSV download

Try it

/api/fertilizers — all fertilizer prices
/api/fertilizers?product=Ammonium Nitrate — AN prices
/api/fertilizers?product=Urea — Urea prices
/api/fertilizers?product=NPK — all NPK formulations
/api/fertilizers?producer=Agropolychim — by producer
/api/fertilizers?format=csv — full CSV download

Freight Rates

GET /api/freight NEW

Inland truck freight rates from Ukrainian oblasts to Black Sea ports. Rates in UAH/ton. Sourced from verified logistics networks.

Parameters

Param	Type	Description
oblast	string	Filter by origin oblast: `Kyiv`, `Poltava`, `Vinnytsia`
destination	string	Filter by port: `Yuzhne`, `Odesa`, `Chornomorsk`
crop	string	Filter by crop: `Corn`, `Wheat`, `General`
format	string	`csv` for CSV download

Try it

/api/freight — all freight data
/api/freight?oblast=Kyiv — from Kyiv oblast
/api/freight?destination=Yuzhne — to Yuzhne port
/api/freight?format=csv — full CSV download

Margin Analysis

GET /api/margins NEW

Calculated trade margins: port reference price minus inland buying price minus freight cost. Shows profitability of buying inland and delivering to port.

Parameters

Param	Type	Description
crop	string	Filter by commodity: `Corn`, `Sunflower`, `Soy`
format	string	`csv` for CSV download

Try it

/api/margins — all margins
/api/margins?crop=Corn — Corn margins
/api/margins?format=csv — full CSV download

Margin formula

margin = port_ref_price - inland_price - freight_cost (UAH/ton)

Positive margin = profitable to buy inland and ship to port. Negative = inland price too high relative to port.

Commodities

GET /api/commodities

List all available commodities in the current dataset.

/api/commodities

Locations

GET /api/locations

List all locations with their types (PORT / FACTORY / INLAND).

/api/locations

Response Examples

Prices

Loading...

Fertilizers

Loading...

Freight

Loading...

Margins

Loading...

Data Coverage

Dataset	Coverage	Update freq	Sources
Prices	14 grain crops, 60+ locations	Every 30 min	Verified market sources
Fertilizers	20+ products, 30+ locations	Every 30 min	Verified fertilizer sources
Freight	20 oblasts, 14 port destinations	Every 30 min	Verified logistics data
Margins	8 major crops	Every 30 min	Calculated: prices + freight

Rate Limits

Plan	Requests	Data
Free	100/hour	Current day only
Pro	Unlimited	30-day history + CSV/JSON
Enterprise	Unlimited	Full history + streaming + white-label

Pricing

Plan	Price	Includes
Free	$0	Website + basic API (100 req/hr, current data)
Pro	$499/mo	Full API + historical data + freight + margins + CSV exports
Enterprise	$1,900/mo	Everything + streaming API + white-label + custom feeds + SLA

Contact: info@blackseagrain.io · Free alerts: @BlackSeaGrain_io