OilPriceAPI Documentation

# API Features

# Core Features (All Plans)

# Real-time Price Updates

  • Updates every 5 minutes during market hours
  • Coverage for multiple commodities:
    • Crude Oil: WTI, Brent, Dubai
    • Natural Gas: Henry Hub, TTF, NBP
    • Others: Gold, Coal, Currency pairs
  • Standardized JSON responses
  • Accurate pricing with validation

# RESTful API Design

  • Simple, intuitive endpoints
  • Standard HTTP methods
  • Comprehensive error messages
  • Pagination support
  • Rate limiting (60 req/min)

# Multiple Data Formats

  • Spot prices
  • Daily average prices
  • Historical data (tier-dependent)
  • Price formatting with currency symbols

# Features by Subscription Tier

# Free Trial & Exploration

Available in: All plans

  • Latest price endpoint (/v1/prices/latest)
  • Basic commodity data
  • Community/Email support
  • API documentation access
  • Test environment access

# Historical Data Access

Available in: Production Boost ($45) and Reservoir Mastery ($129)

Access historical price data through dedicated endpoints:

# Past 24 hours
GET /v1/prices/past_day

# Past 7 days
GET /v1/prices/past_week

# Past 30 days
GET /v1/prices/past_month

# Past 365 days
GET /v1/prices/past_year

# Custom date range
GET /v1/prices?by_period[from]=1698192000&by_period[to]=1700179199
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# Price & Volatility Alerts

Available in: Production Boost ($45) and Reservoir Mastery ($129)

Set up automated alerts for:

  • Price threshold breaches
  • Volatility spikes
  • Daily/weekly summaries
  • Custom alert conditions

Note: Alert delivery via email. Webhook notifications available in Reservoir Mastery tier.

# Drilling Intelligence (EXCLUSIVE)

Available in: Reservoir Mastery ($129) ONLY

Access comprehensive upstream oil & gas data:

# Rig Counts

  • US state-by-state breakdown
  • Canadian provincial data
  • International rig counts
  • Weekly updates from Baker Hughes

# Frac Spreads

  • Active completion crews by basin
  • Permian, Eagle Ford, Bakken coverage
  • Weekly updates from Primary Energy

# Well Permits

  • Texas Railroad Commission data
  • North Dakota Industrial Commission
  • Oklahoma Corporation Commission
  • Weekly permit issuance tracking

# DUC Wells Inventory

  • Drilled but uncompleted wells
  • Basin-specific inventory levels
  • Monthly EIA updates

Learn more about Drilling Intelligence →

# WebSocket Real-time Streaming

Available in: Reservoir Mastery ($129) ONLY

Stream real-time price updates without polling:

// Connect to WebSocket
const cable = ActionCable.createConsumer('wss://api.oilpriceapi.com/cable');

// Subscribe to price updates
const subscription = cable.subscriptions.create('EnergyPricesChannel', {
  received(data) {
    console.log('Price update:', data);
  }
});
1
2
3
4
5
6
7
8
9

Benefits:

  • Instant price updates
  • Reduced API calls
  • Lower latency
  • Efficient data streaming

# Webhooks & Push Notifications

Available in: Reservoir Mastery ($129) ONLY

Configure webhooks for:

  • Price updates
  • Alert triggers
  • System events
  • Custom notifications

Example webhook payload:

{
  "event": "price_update",
  "commodity": "WTI_USD",
  "price": 75.43,
  "previous": 75.21,
  "change": 0.22,
  "change_percent": 0.29,
  "timestamp": "2025-07-18T14:30:00Z"
}
1
2
3
4
5
6
7
8
9

# Advanced Features

# Custom Integrations

Available in: Reservoir Mastery ($129)

  • Custom data formatting
  • Specialized endpoints
  • Direct database access (case-by-case)
  • Priority feature requests

# White-label Options

Available in: Reservoir Mastery ($129)

  • Remove OilPriceAPI branding
  • Custom domain support
  • Branded documentation
  • Co-branded solutions

# Enterprise Support

Available in: Reservoir Mastery ($129)

  • Dedicated support channel
  • Slack integration
  • Priority issue resolution
  • Technical consultation
  • Custom SLA agreements

# Performance & Reliability

# Uptime Guarantees

  • Production Boost: 99% uptime SLA
  • Reservoir Mastery: 99.9% uptime SLA

# Response Times

  • Average: <100ms
  • 95th percentile: <200ms
  • 99th percentile: <500ms

# Infrastructure

  • Global CDN distribution
  • Multiple data centers
  • Automatic failover
  • DDoS protection

# Rate Limiting

All plans include generous rate limits:

Plan Requests/Month Requests/Minute
Free Trial 1,000 60
Exploration 10,000 60
Production Boost 50,000 60
Reservoir Mastery 250,000 60

# Rate Limit Headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1625097600
1
2
3

# Data Quality

# Sources

  • Multiple data providers
  • Cross-validation
  • Outlier detection
  • Manual verification for anomalies

# Accuracy

  • Price validation ranges
  • Automatic error correction
  • Historical data reconciliation
  • Regular audits

# Security

# Authentication

  • Secure API tokens
  • Token rotation support
  • IP whitelisting (optional)
  • Request signing (optional)

# Encryption

  • TLS 1.3 for all connections
  • Encrypted data at rest
  • Secure token storage
  • PCI compliant infrastructure

# Coming Soon

We're constantly improving our API. Features in development:

  • Mobile SDKs
  • GraphQL endpoint
  • Batch operations
  • Advanced analytics API
  • Machine learning predictions

Note: SMS/WhatsApp notifications are planned for future release.

# Feature Comparison Matrix

Feature Free Exploration Production Reservoir
Real-time Prices ✓ ✓ ✓ ✓
API Documentation ✓ ✓ ✓ ✓
Email Support - ✓ ✓ ✓
Historical Data - - ✓ ✓
Price Alerts - - ✓ ✓
Drilling Intelligence - - - ✓
WebSocket Streaming - - - ✓
Webhooks - - - ✓
Custom Integrations - - - ✓
Dedicated Support - - - ✓

View Pricing Plans →