OilAPI documentation

Fuel and oil prices for every country, one call away

Pump prices for over 150 countries, the prices governments set, 54,555 stations and crude benchmarks back to 1987. JSON over HTTPS, your key in a header, and an MCP server for AI assistants.

Quick start Get a free key

A call, live

Start here

1Get a keySign in with Google and your free key is made at once, saved in this browser for every Try it.Sign up 2Make your first callOne line of curl returns a country's pump prices now, in its own currency and per litre.Quick start 3Pick what you needEvery endpoint has Try it, code in four languages and a real answer from today's data.API reference

Endpoints

Coverage2 endpoints

List countries/v1/countriesGet a country/v1/countries/{country}

Prices2 endpoints

Pump prices/v1/prices/retailGovernment set prices/v1/prices/set

Stations3 endpoints

Find stations/v1/stationsGet a station/v1/stations/{id}Station price history/v1/stations/{id}/history

Markets3 endpoints

List benchmarks/v1/benchmarksBenchmark history/v1/benchmarks/{benchmark}Currency rates/v1/fx

Series2 endpoints

List series/v1/seriesSeries values/v1/series/{series}

Account1 endpoint

Your usage/v1/usage

Recipes

Cheapest fuel near a userThe five cheapest diesel stations within 3 km of a point, with how fresh each price is.2 calls Track a country's pricesToday's pump prices for a country, then one fuel's history to chart.2 calls Compare countries in dollarsPut any countries side by side in US dollars a litre, each at its own day's rate.1 call each Crude against the pumpBrent by month next to a country's pump price, to see how much of a litre is crude.2 calls

Use with Claude and agents

Add the MCP server to Claude, ChatGPT or Cursor, or give an agent the skill: download SKILL.md and save it as ~/.claude/skills/oilapi/SKILL.md, or upload it as a skill in Claude's settings.

MCP serveroilapi.net/mcp, with sign-in for Claude and ChatGPT.Set up MCP tools7 tools, each one endpoint.See the tools Agent skillA SKILL.md that teaches an agent the API.Download and install The manualEvery endpoint in one markdown file.manual.md

What is new

28 Oct 2026The API opens: coverage, pump and set prices, stations near a point, benchmarks, every series, currencies and usage.

28 Oct 2026The MCP server at https://oilapi.net/mcp, with sign-in for Claude and ChatGPT connectors.

28 Oct 2026Set prices by town or zone: /v1/prices/set takes region.

29 Oct 2026Prices in today's money: real= on pump prices, benchmarks and series, with a monthly consumer price index for 190 countries.

Plans

FreeFree key: 50 calls a day, 30 days of history

$29 a monthLive: 10,000 calls a day, 2 years of history

$99 a monthComplete: 100,000 calls a day, full record of history

$249 a monthAnalyst: 500,000 calls a day, full record of history