[Provider] Add OilPriceAPI provider for commodity prices

[karlwaldman]

Summary

Request to add OilPriceAPI as a provider for real-time oil and commodity prices.

Provider Details

• Name: oilpriceapi
• Website: https://oilpriceapi.com
• API Documentation: https://docs.oilpriceapi.com
• PyPI Package: https://pypi.org/project/openbb-oilpriceapi/ (pending)
• GitHub: https://github.com/OilpriceAPI/openbb-oilpriceapi

Supported Data

• Crude Oil: WTI, Brent, Urals, Dubai
• Natural Gas: US (Henry Hub), EU (TTF), UK (NBP)
• Other: Coal, Diesel, Gasoline

Features Implemented

• OilPrice fetcher - Latest prices for all commodities
• OilHistorical fetcher - Historical prices (past_day, past_week, past_month)
• Error handling with retries (exponential backoff for rate limits)
• 89% test coverage (43 tests)

Why Add This Provider?

1. Commodity Focus: OpenBB lacks a dedicated commodity price provider
2. Reliability: Built-in retry logic and comprehensive error handling
3. Free Tier: Users can get started with a free API key
4. Well-Documented: Full README with examples and API reference

Implementation

The provider follows OpenBB conventions:

• Fetcher pattern with transform_query, aextract_data, transform_data
• Pydantic models for query params and data
• Symbol mapping between OpenBB and API codes

Usage Example

from openbb import obb

obb.user.credentials.oilpriceapi_api_key = "your_key"

# Get all commodity prices
prices = obb.commodity.oil.price(provider="oilpriceapi")

# Get historical WTI prices
history = obb.commodity.oil.historical(symbol="WTI", period="past_week", provider="oilpriceapi")

I'm happy to submit a PR with the full provider implementation if you're interested in including it.

[deeleeramone]

Hi there, and thanks for the note.

I encourage you to implement this as a standalone repository that you own, and from where it is published to PyPI.

You could then share it here: https://github.com/OpenBB-finance/awesome-openbb

Bespoke, vendor, APIs are not realistically maintainable in this repository. Anyone is welcome to create, maintain, and publish their own extensions that are compatible with the core infrastructure.