# OilPriceAPI

> Source-timestamped oil, gas, refined-product, futures, and related energy data through a normalized REST API. Free tier available.

OilPriceAPI covers crude oil benchmarks, natural gas, refined products, futures, marine fuels, carbon markets, metals, forex, and selected energy-intelligence datasets. Latest available values include source timestamps; refresh cadence and access vary by source, market hours, dataset, plan, and account entitlement. Authentication uses `Authorization: Token YOUR_API_KEY`.

Data rights note: OilPriceAPI sells API access, normalization, monitoring, and delivery. It does not grant rights in the underlying source data. Standard plans are for internal workflows; public display, raw-data resale, redistribution, or downstream productization should be reviewed against the Data Usage Policy: https://www.oilpriceapi.com/legal/data-usage

## Documentation

- [Cookbook](https://github.com/OilpriceAPI/cookbook): Runnable Python recipes executed against production — no-key demo, as_of point-in-time backtests, gas hub basis, bunker ports, batch watchlists, AI-agent tool patterns
- [Full Technical Reference](https://api.oilpriceapi.com/llms-full.txt): Complete API spec for AI agents — authentication, endpoints, commodity codes, and response formats
- [Reviewed Product Facts](https://api.oilpriceapi.com/product-facts.json): Versioned source for offer, authentication, freshness, catalog, entitlement, and data-rights wording
- [Quick Start Guide](https://docs.oilpriceapi.com/quick-start): Make a first authenticated request with curl, Python, or JavaScript
- [API Quick Reference](https://docs.oilpriceapi.com/quick-ref/): All endpoints, commodity codes, and examples in one place
- [Authentication](https://docs.oilpriceapi.com/guides/authentication): API key setup and token-based auth
- [Rate Limiting](https://docs.oilpriceapi.com/guides/rate-limiting): Request limits by plan tier
- [Error Codes](https://docs.oilpriceapi.com/guides/error-codes): HTTP status codes and error response format
- [Production Checklist](https://docs.oilpriceapi.com/guides/production-checklist): Best practices for going live
- [Changelog](https://docs.oilpriceapi.com/changelog): API version history and updates

## API Reference

- [Commodities List](https://docs.oilpriceapi.com/api-reference/commodities/list): Complete list of supported commodity codes with currency and unit info
- [OpenAPI Spec](https://api.oilpriceapi.com/api-docs): Swagger/OpenAPI documentation for all endpoints
- GET /v1/electricity?state=CA&sector=residential: US retail electricity prices in cents/kWh by state and sector (EIA monthly data; 50 states + DC + US average; sectors: residential, commercial, industrial, all)

## Agent Discovery and x402 Measurement

- [No-key Sample Prices](https://api.oilpriceapi.com/sample?by_code=WTI_USD&measure=spot_price): Public sample endpoint for WTI, Brent, and natural gas discovery; no API key required.
- [Versioned No-key Sample](https://api.oilpriceapi.com/v1/sample?by_code=WTI_USD&measure=spot_price): Same sample endpoint under the API namespace for agents that infer versioned routes.
- [x402 Discovery Preview](https://api.oilpriceapi.com/v1/x402/prices/latest?by_code=WTI_USD&measure=spot_price): Measurement-only HTTP 402 endpoint for discovering agent demand before live payments are enabled.

## API Key Management

- POST /v1/api-keys: Create new API key (max 5 per user). Returns plain_token once.
- GET /v1/api-keys: List all API keys (token_hint only, never full token)
- DELETE /v1/api-keys/{id}: Revoke an API key (soft delete via revoked_at)
- POST /v1/api-keys/{id}/roll: Regenerate token (same key ID, new token, old token immediately invalidated)

## SDKs and Integrations

- [Python SDK](https://docs.oilpriceapi.com/developers/python): pip install oilpriceapi
- [JavaScript/Node.js SDK](https://docs.oilpriceapi.com/developers/javascript): npm install oilpriceapi
- [Go SDK](https://docs.oilpriceapi.com/developers/go): go get github.com/OilpriceAPI/oilpriceapi-go
- [Ruby SDK](https://docs.oilpriceapi.com/developers/ruby): gem install oilpriceapi
- [C# SDK](https://docs.oilpriceapi.com/developers/csharp): NuGet package
- [Google Sheets Integration](https://docs.oilpriceapi.com/integrations/google-sheets): Pull latest prices into spreadsheets
- [Power BI Integration](https://docs.oilpriceapi.com/integrations/power-bi): Connect commodity data to dashboards
- [Zapier Integration](https://docs.oilpriceapi.com/integrations/zapier): No-code automation workflows
- [n8n Integration](https://docs.oilpriceapi.com/integrations/n8n): Open-source workflow automation
- [MCP Server](https://www.npmjs.com/package/oilpriceapi-mcp): Model Context Protocol server for Claude, Cursor, and AI coding tools

## Pricing and Plans

- [Pricing](https://www.oilpriceapi.com/pricing): Every signup gets a 7-day, 10,000-request core commodity API trial; then Free (200 req/mo). Paid plans are Developer ($19/mo, 10K), Starter ($49/mo, 50K), Professional ($99/mo, 100K), Scale ($299/mo, 1M), and Enterprise (custom). Dataset access varies by entitlement.
- [Enterprise Solutions](https://www.oilpriceapi.com/enterprise): Custom data feeds, support, and contract terms

## Price Data

- [Brent Crude Oil](https://www.oilpriceapi.com/live/brent-crude-oil-price): ICE Brent front-month futures
- [WTI Crude Oil](https://www.oilpriceapi.com/live/wti-crude-oil-price): NYMEX WTI (Cushing, OK delivery)
- [Natural Gas](https://www.oilpriceapi.com/live/natural-gas-price): Henry Hub benchmark
- [Dutch TTF Gas](https://www.oilpriceapi.com/live/dutch-ttf-gas-price): European gas benchmark in EUR
- [Gold](https://www.oilpriceapi.com/live/gold-price): Spot gold in USD/oz
- [LBMA Gold Fix](https://www.oilpriceapi.com/live/lbma-gold-fix): LBMA Gold AM/PM Fix in USD, GBP, EUR (GOLD_AM_USD, GOLD_AM_GBP, GOLD_AM_EUR, GOLD_PM_USD, GOLD_PM_GBP, GOLD_PM_EUR)
- [LBMA Silver Fix](https://www.oilpriceapi.com/live/lbma-silver-fix): LBMA Silver Fix in USD, GBP, EUR (SILVER_FIX_USD, SILVER_FIX_GBP, SILVER_FIX_EUR)
- [EU Carbon Allowances](https://www.oilpriceapi.com/live/eu-carbon-price): EU ETS carbon permits in EUR/tCO2
- [UK Carbon Allowances](https://www.oilpriceapi.com/live/uk-carbon-price): UK ETS carbon permits in GBP/tCO2
- [All Commodities](https://www.oilpriceapi.com/commodities): Current catalog, codes, units, source details, and availability

## Comparisons

- [vs Bloomberg](https://www.oilpriceapi.com/vs/bloomberg): Compare OilPriceAPI with Bloomberg workflows and coverage
- [vs Platts](https://www.oilpriceapi.com/vs/platts): Comparison with S&P Global Platts
- [vs Refinitiv](https://www.oilpriceapi.com/vs/refinitiv): Comparison with Refinitiv Eikon
- [vs Alpha Vantage](https://www.oilpriceapi.com/vs/alpha-vantage): Energy-specific vs general market data

## Industry Solutions

- [Commodity Trading](https://www.oilpriceapi.com/solutions/commodity-trading): API access for internal trading-desk dashboards, research, alerts, and market-monitoring workflows
- [Aviation Fuel](https://www.oilpriceapi.com/solutions/aviation-fuel): Jet fuel pricing for airlines and FBOs
- [Maritime Bunker Fuel](https://www.oilpriceapi.com/solutions/maritime-bunker-fuel): VLSFO, MGO, HFO pricing for shipping
- [Fintech](https://www.oilpriceapi.com/solutions/fintech): Use energy price signals in internal fintech workflows, models, and dashboards
- [Oilfield Services](https://www.oilpriceapi.com/solutions/oilfield-services): Pricing data for upstream operations

## Company

- [About](https://www.oilpriceapi.com/about): Company background, mission, and team
- [Blog](https://www.oilpriceapi.com/blog): Market insights, API tutorials, and product updates
- [Support](https://www.oilpriceapi.com/support): Contact and help resources
- [Data Quality](https://www.oilpriceapi.com/data-quality): How we source, validate, and deliver accurate prices
- [Data Usage Policy](https://www.oilpriceapi.com/legal/data-usage): Internal-use, public-display, redistribution, and productization guidance
- [Security](https://www.oilpriceapi.com/security): Infrastructure and data security practices
- [Terms of Service](https://www.oilpriceapi.com/terms): Usage policies
- [Privacy Policy](https://www.oilpriceapi.com/privacy): Data handling practices

## Optional

- [Historical Prices](https://www.oilpriceapi.com/historical-prices): Historical depth varies by dataset and account entitlement
- [Oil Price Chart](https://www.oilpriceapi.com/oil-price-chart): Interactive price visualization
- [Fuel Surcharge Calculator Widget](https://www.oilpriceapi.com/widgets/fuel-surcharge-calculator): Embeddable calculator
- [Oil Price Ticker Widget](https://www.oilpriceapi.com/widgets/oil-price-ticker): Website price ticker; confirm display rights and source scope for your use case
- [Diesel Prices by State](https://www.oilpriceapi.com/diesel-prices): US retail diesel prices
- [OPEC Production Data](https://www.oilpriceapi.com/data/production/opec): OPEC member country output
- [US Rig Count](https://www.oilpriceapi.com/live/us-rig-count): Baker Hughes active rig count
- [API Number Lookup](https://www.oilpriceapi.com/data/api-number-lookup): US well identification numbers