First-call proof
Make your first API request in under 10 minutes
Start with one benchmark request and a clean response shape. Once you have that working, you can use the same workflow in spreadsheets, alerts, widgets, or your own internal tools.
Representative benchmark example
Use this example to understand the response shape and first-call workflow. Exact values and freshness depend on the benchmark and current service state.
{
"status": "success",
"data": {
"benchmark": {
"code": "BENCHMARK_CODE",
"price": null,
"currency": "USD",
"timestamp": "returned_by_api"
}
}
}1. Copy your API key
Use your dashboard key in the Authorization header. Do not paste API keys into public code, shared documents, or logs.
2. Run one request
Start with one benchmark request and keep the first call focused on a single success path.
3. Confirm JSON
Check that the response is valid JSON before adding spreadsheets, alerts, widgets, or internal tools.
Run one request
Confirm a valid JSON response
Keep the first call narrow: send one request, confirm the response shape, then decide which workflow should come next.
curl "https://api.oilpriceapi.com/v1/prices/latest" \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json"Choose the workflow you want next
Build from one working request
Find codes and latest prices
Confirm the commodity code and response fields before adding more symbols or sources.
If a code, region, or source is missing, send the intended workflow instead of guessing.
Open code guide
Use OilPriceAPI in Excel
Use the add-in formula path after the first API call works outside the spreadsheet.
Save the key in the OilPrice pane. Do not paste API keys into worksheet cells.
Open Excel guide
Understand historical rows
Check date, price, source/type fields, and dataset semantics before using rows in analysis.
Do not treat a row as an official close, settlement, or complete history unless that dataset supports it.
Open historical guide
Choose futures or latest prices
Use futures-specific pages when contract month, OHLC, settlement-style fields, or curve semantics matter.
Latest-price endpoints are not a substitute for exchange-grade futures feeds or resale-ready market data.
Open futures guide
Connect a customer-owned source
Use the marine connector path when provider access, ports, grades, or source-specific terms matter.
Provider rights, ports, grades, history, and usage terms need source-specific verification.
Open connector guide
Check data fit before plan fit
Confirm the commodity, region or source, workflow, and expected request volume before upgrading.
Unknown or gated data should route to support verification before upgrade pressure.
Review plan fit