Python SDK

from oilpriceapi import OilPriceAPI

# Initialize client (uses OILPRICEAPI_KEY env var by default)
client = OilPriceAPI()

# Get latest Brent Crude price
brent = client.prices.get("BRENT_CRUDE_USD")
print(f"Brent Crude: ${brent.value:.2f}/{brent.unit} at {brent.timestamp.isoformat()}")
# Output: Brent Crude: $104.32/barrel at 2026-09-13T14:51:34.609000+00:00

# Method 1: Environment variable (recommended)
# export OILPRICEAPI_KEY="your_api_key"
client = OilPriceAPI()

# Method 2: Direct initialization
client = OilPriceAPI(api_key="your_api_key")

# Method 3: With configuration
client = OilPriceAPI(
    api_key="your_api_key",
    timeout=30,
    max_retries=3
)

prices = client.prices.get_multiple(["BRENT_CRUDE_USD", "WTI_USD", "NATURAL_GAS_USD"])
for price in prices:
    print(f"{price.commodity}: ${price.value:.2f}/{price.unit}")
# BRENT_CRUDE_USD: $104.32/barrel
# WTI_USD: $99.99/barrel
# NATURAL_GAS_USD: $2.83/mmbtu

# Get historical data as DataFrame (requires: pip install "oilpriceapi[pandas]")
df = client.prices.to_dataframe(
    commodity="BRENT_CRUDE_USD",
    start="2026-01-01",
    end="2026-03-31",
    interval="daily"
)

print(f"Retrieved {len(df)} data points")
print(df.head())

# Calculate moving averages — the price column is `value`
df['SMA_20'] = df['value'].rolling(window=20).mean()

import os

from oilpriceapi import OilPriceAPI

with OilPriceAPI(api_key=os.environ["OILPRICEAPI_KEY"]) as client:
    payload = client.request(
        "GET",
        "/v1/diesel-prices",
        params={"state": "CA"},
        timeout=30,
    )

average = payload["data"]["regional_average"]
print(
    f"{average['region']} diesel: "
    f"{average['price']} {average['currency']}/{average['unit']} "
    f"({average['source']}, {average['updated_at']})"
)
# california diesel: 8.136 USD/gallon (aaa, 2026-09-13T14:57:19Z)

# Create a price alert with webhook notification
alert = client.alerts.create(
    name="Brent High Alert",
    commodity_code="BRENT_CRUDE_USD",
    condition_operator="greater_than",
    condition_value=85.00,
    webhook_url="https://your-server.com/webhook",
    enabled=True,
    cooldown_minutes=60
)

print(f"Alert created: {alert.id}")

# List all alerts
alerts = client.alerts.list()
for alert in alerts:
    print(f"{alert.name}: {alert.trigger_count} triggers")

import asyncio
from oilpriceapi import AsyncOilPriceAPI

async def get_prices():
    async with AsyncOilPriceAPI() as client:
        prices = await asyncio.gather(
            client.prices.get("BRENT_CRUDE_USD"),
            client.prices.get("WTI_USD"),
            client.prices.get("NATURAL_GAS_USD")
        )
        return prices

prices = asyncio.run(get_prices())

from oilpriceapi.exceptions import (
    OilPriceAPIError,
    AuthenticationError,
    BadRequestError,
    RateLimitError,
)

try:
    price = client.prices.get("INVALID_CODE")
except BadRequestError as e:
    print(f"Bad request: {e}")
    print(f"Rejected codes: {e.invalid_codes}")
    print(f"Did you mean: {e.suggestions}")
except AuthenticationError:
    print("Replace the missing, expired, or revoked API key.")
except RateLimitError as e:
    print(f"Rate limited. Resets in {e.seconds_until_reset}s")
except OilPriceAPIError as e:
    print(f"API error: {e} (request_id={e.request_id})")

matches = client.commodities.search("brent crude", limit=5)
print([commodity["code"] for commodity in matches])
# ['BRENT_CRUDE_USD', 'BRENT_FUTURES', 'BRENT_FUTURES_CONTINUOUS', 'BRENT_SPOT_EUROPE_USD', 'BRENT_SPOT_USD']