OilPriceAPI Documentation
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
  • Commodities

    • List Commodities
    • Get Commodity Details
  • Marine Fuels

    • List Marine Fuel Ports
    • Get Port Details with Prices
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API

API Reference

Authentication

Authorization: Token YOUR_API_KEY

Get your API key from oilpriceapi.com/dashboard.

Base URL

https://api.oilpriceapi.com/v1

Response Format

{
  "status": "success|error",
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "response_time_ms": 42,
    "timestamp": "2025-07-18T10:30:00Z"
  }
}

Rate Limits

PlanRequests/MonthPer Minute
Free1,00010
Hobby10,000100
Starter50,000500
Professional100,0001,000
Business200,0002,000

Headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1736784000

Endpoints

Prices

MethodEndpointDescription
GET/prices/latestLatest commodity prices
GET/prices/past_dayHourly prices (24h)
GET/prices/past_weekDaily prices (7d)
GET/prices/past_monthDaily prices (30d)
GET/prices/past_quarterWeekly prices (90d)
GET/prices/past_yearMonthly prices (365d)

Commodities

MethodEndpointDescription
GET/commoditiesList all commodities
GET/commodities/{code}Commodity details

Premium Endpoints

MethodEndpointDescriptionPlan
GET/prices/allAll 40+ commoditiesProfessional+
GET/storage/cushingCushing storage dataProfessional+
GET/drilling/overviewDrilling intelligenceBusiness+
GET/futures/ice-brentICE Brent futuresBusiness+
GET/marine-fuels/overviewMarine fuel pricesProfessional+

Marine Fuels

MethodEndpointDescription
GET/marine/portsList fuel ports
GET/marine/ports/{code}Port details
GET/marine/fuelsAll marine fuel prices

Common Parameters

ParameterTypeDescriptionExample
by_codestringFilter by commodity codeWTI_USD
fieldsstringSpecific fields to returnprice,timestamp
pageintegerPagination page number1
per_pageintegerResults per page (max: 100)100

Error Codes

CodeStatusDescription
MISSING_API_KEY401No API key provided
INVALID_API_KEY401Invalid or expired key
RATE_LIMIT_EXCEEDED429Too many requests
INVALID_COMMODITY400Unknown commodity code
INTERNAL_ERROR500Server error

See Error Codes Guide for complete list.

Interactive API Explorer

Test endpoints directly: API Explorer

Next
Get Latest Prices