feat(oilpriceapi): add OilPriceAPI provider with CommoditySpotPrices

[karlwaldman]

What

Adds a provider extension for OilPriceAPI, implementing the CommoditySpotPrices standard model behind obb.commodity.price.spot.

That command currently has one provider, fred, serving 12 hardcoded FRED series. OilPriceAPI's public catalogue (GET /v1/commodities) exposes 463 series — crude benchmarks, natural gas, refined products, coal, carbon, marine fuels and drilling activity — each carrying its own source timestamp and freshness metadata.

Behaviour

Query	Endpoint
no start_date/end_date	/v1/prices/latest — latest observation
either date supplied	/v1/prices/historical — daily series

commodity accepts friendly aliases (brent, wti, dutch_ttf, eu_carbon, …) or any raw catalogue code, forwarded unchanged.

from openbb import obb

obb.commodity.price.spot(provider="oilpriceapi", commodity="brent")
obb.commodity.price.spot(provider="oilpriceapi", commodity="wti",
                         start_date="2026-01-01", end_date="2026-06-30")

Design notes

• Depends only on openbb-core. Uses amake_request rather than adding an HTTP client.
• The API's error envelope carries code, message and request_id — surfaced rather than swallowed.
• EmptyDataError distinguishes unknown commodity from valid commodity, empty window; the first message points at /v1/commodities.
• Registered as an optional provider in dev_install.py, matching the nasdaq/tmx pattern.

Verification

Run against the live API before submission, not just unit-tested:

latest brent          -> 1 row   2026-08-05 BRENT_CRUDE_USD 79.31 barrel USD
wti 2026-07-01..07-31 -> 29 rows 2026-07-01 WTI_USD 68.83 barrel USD
raw code passthrough  -> DUTCH_TTF_EUR 53.44 mwh EUR
unknown commodity     -> EmptyDataError naming /v1/commodities
invalid credential    -> OpenBBError UNAUTHORIZED with request_id
empty date window     -> EmptyDataError reporting records found vs window

Credentials for review

Free tier is 200 requests/month, no card required (https://www.oilpriceapi.com/auth/signup). There is also a keyless demo endpoint if you'd rather not sign up at all:

curl https://api.oilpriceapi.com/v1/demo/prices

Happy to provide a reviewer key — just say where to send it.

Not included

tests/record/ cassettes are not committed: record_http needs to run in your CI environment to capture them against a real key. Glad to add them however you prefer — or I can record with a throwaway key if that's the convention.

Docs: https://docs.oilpriceapi.com · OpenAPI: https://api.oilpriceapi.com/.well-known/openapi.json

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}