Oil price API: list benchmarks

List benchmarks

Crude and product benchmarks with their latest price.

GEThttps://api.oilapi.net/v1/benchmarks

PlansEvery plan

Cost1 call per request

ReturnsEvery benchmark in one call

UpdatedDaily; futures every few minutes

What it is for

Every benchmark we hold, crude grades and refined products, with its latest price, unit and the day of that price.

Take a benchmark code from here to Benchmark history.

Good for

A market ticker
The latest Brent and WTI
Listing benchmark codes

Also the MCP tool benchmarks

Parameters

This endpoint takes no parameters: your key is all it needs.

Try it runs against the live API with your key

Your API key

No key yet? Get a free one; it is saved in this browser for every page.

The answer 200, application/json

Field	Type	What it holds	Example
`benchmark`	string	Benchmark code, such as brent	`"brent"`
`name`	string	Our name for it	`"Brent crude, spot"`
`unit`	string	litre, gallon or barrel	`"barrel"`
`currency`	string	Three letter currency code	`"USD"`
`price`	number	The price in currency per unit	`123.1`
`date`	string	The day of the close	`"2026-10-27"`

Example answer real, from what we hold now; long lists cut to three

GET /v1/benchmarks

{
    "data": [
        {
            "benchmark": "brent",
            "name": "Brent crude, spot",
            "unit": "barrel",
            "currency": "USD",
            "price": 123.1,
            "date": "2026-10-27",
            "since": "1987-05-20"
        },
        {
            "benchmark": "wti",
            "name": "WTI crude, Cushing spot",
            "unit": "barrel",
            "currency": "USD",
            "price": 103.37,
            "date": "2026-10-27",
            "since": "1986-01-02"
        },
        {
            "benchmark": "gasoline_nyh",
            "name": "Conventional gasoline, New York Harbor spot",
            "unit": "gallon",
            "currency": "USD",
            "price": 2.819,
            "date": "2026-10-27",
            "since": "1986-06-02"
        }
    ],
    "meta": {
        "count": 12
    }
}

Errors every error has the same shape

HTTP	Code	When	What to do
401	`unauthorized`	No key, or not a valid one	Send your key in the `X-API-Key` header; your account page shows it.
429	`rate_limited`	Too many calls this minute	Wait the seconds in the `Retry-After` header, then call again.
429	`quota_exceeded`	Today's calls are used up	Wait for the day to reset at midnight UTC, or move to a larger plan.

Dates and times are UTC. A point's date is the day its price took effect, or the first day of its week or month for weekly and monthly series. Conversions use each day's own rate, so a converted series moves with both the price and the exchange rate.

Benchmark historyOne benchmark day by day, or averaged by week, month or year.GET /v1/benchmarks/{benchmark}Currency ratesUnits of a currency per US dollar, day by day.GET /v1/fx HistoryHow far back each series goes, and reading long ranges.Guide