Webhooks & Real-Time Push
Get instant notifications for oil price changes and exclusive drilling intelligence data. Real-time rig counts, frac spreads, well permits, and DUC well inventory pushed directly to your systems.
Exclusive: Drilling Intelligence Webhooks
Be the first to know about changes in drilling activity. Get real-time notifications for rig counts, frac spreads, well permits, and DUC well inventory updates.
Rig Count Updates
Weekly Baker Hughes rig count data for US, Canada, and International markets
drilling.rig_count.updated
Frac Spread Counts
Daily hydraulic fracturing spread counts by major US basins
drilling.frac_spread.updated
Well Permits
Daily drilling permit issuances from state regulatory agencies
drilling.well_permit.updated
DUC Well Inventory
Monthly Drilled but Uncompleted well inventories by basin
drilling.duc_well.updated
Drilling Intelligence Webhook Example:
{ "id": "evt_1a2b3c4d5e", "type": "drilling.rig_count.updated", "created_at": "2025-08-03T17:00:00Z", "data": { "commodity": "US_RIG_COUNT", "region": "United States", "value": 540, "previous_value": 535, "change": 5, "change_percent": 0.93, "unit": "rigs", "source": "Baker Hughes", "breakdown": { "oil_rigs": 425, "gas_rigs": 110, "misc_rigs": 5 }, "timestamp": "2025-08-03T17:00:00Z" } }
How Oil Price & Drilling Webhooks Work
1. Data Updates
Our system monitors oil prices every 5 minutes and drilling data from official sources daily/weekly
2. Instant Push
When new data arrives, we immediately push notifications to your configured webhook endpoints
3. Your App Updates
Your application receives the webhook and automatically processes the latest energy market data
Price Update Webhook Example:
{ "id": "evt_9z8y7x6w5v", "type": "price.updated", "created_at": "2025-08-03T14:30:00Z", "data": { "commodity": "BRENT_CRUDE_OIL", "name": "Brent Crude Oil", "value": 78.45, "currency": "USD", "unit": "barrel", "change_percent": 2.3, "previous_value": 76.69, "timestamp": "2025-08-03T14:30:00Z" } }
Available Webhook Events
Price Events
price.updated
Any commodity price update
price.significant_change
Price changes exceeding 5%
Drilling Intelligence Events
drilling.rig_count.updated
Weekly rig count updates
drilling.frac_spread.updated
Daily frac spread counts
drilling.well_permit.updated
Daily permit issuances
drilling.duc_well.updated
Monthly DUC inventories
API Usage Events
api.limit.warning
Usage reaches 80% of monthly limit
api.limit.exceeded
Monthly limit exceeded
Subscription Events
subscription.updated
Plan or status changes
subscription.cancelled
Subscription cancelled
Real-World Applications
Energy Trading Platforms
Power real-time trading interfaces with instant price updates and drilling activity indicators.
- • Real-time position valuations
- • Automated trading triggers based on rig counts
- • Supply/demand indicators from drilling data
E&P Analytics Dashboards
Build comprehensive drilling intelligence dashboards with real-time updates.
- • Basin-specific activity monitoring
- • Competitor drilling analysis
- • DUC well completion timing
Investment Research Tools
Enhance research platforms with real-time drilling intelligence and price correlations.
- • Activity-based forecasting models
- • Supply trend analysis
- • Regional production indicators
SCADA & Control Systems
Integrate market data into operational systems for dynamic optimization.
- • Price-based production optimization
- • Market-driven storage decisions
- • Automated hedging triggers
Risk Management Systems
Real-time risk calculations based on price movements and drilling trends.
- • VaR recalculations on price changes
- • Supply risk from drilling activity
- • Automated compliance reporting
Market Intelligence Platforms
Comprehensive market monitoring with drilling activity as leading indicators.
- • Early trend detection
- • Regional supply forecasts
- • Competitive intelligence alerts
Enterprise-Grade Implementation
Advanced Configuration
- Up to 25 webhook endpoints per account
- Granular event and commodity filtering
- Custom headers and authentication
- Configurable retry policies
- Event deduplication
Security & Reliability
- HMAC-SHA256 signature verification
- Automatic retry with exponential backoff
- 99.9% delivery SLA
- Event logs and delivery tracking
- Replay protection
Webhook Security - Signature Verification:
// Node.js webhook signature verification const crypto = require('crypto'); app.post('/webhook/oilpriceapi', (req, res) => { const signature = req.headers['x-oilpriceapi-signature']; const timestamp = req.headers['x-oilpriceapi-signature-timestamp']; const payload = JSON.stringify(req.body); // Prevent replay attacks (5 minute window) if (Date.now() - parseInt(timestamp) > 300000) { return res.status(401).send('Timestamp too old'); } // Verify signature const expectedSig = crypto .createHmac('sha256', process.env.WEBHOOK_SECRET) .update(`${payload}.${timestamp}`) .digest('hex'); if (signature !== expectedSig) { return res.status(401).send('Invalid signature'); } // Process webhook const { type, data } = req.body; switch(type) { case 'price.updated': handlePriceUpdate(data); break; case 'drilling.rig_count.updated': handleRigCountUpdate(data); break; // ... handle other events } res.status(200).send('OK'); });
Exclusive to Reservoir Mastery Plan
Reservoir Mastery Plan
Webhook Features:
- Real-time price update webhooks for all commodities
- Exclusive drilling intelligence webhooks (rig counts, frac spreads, permits, DUC wells)
- Up to 25 webhook endpoints
- 250,000 webhook events per month
- Custom event filtering and routing
Also Includes:
- 250,000 API requests per month
- WebSocket real-time connections
- Priority support with dedicated Slack channel
- 99.9% uptime SLA
14-day free trial • No setup fees • Cancel anytime
Quick Implementation Guide
1. Create Webhook Endpoint
curl -X POST https://api.oilpriceapi.com/v1/webhooks \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://your-app.com/webhooks/oilprice",
"events": ["price.updated", "drilling.rig_count.updated"],
"commodity_filters": ["BRENT_CRUDE_OIL", "US_RIG_COUNT"],
"description": "Production webhook for real-time updates"
}'
2. Test Your Endpoint
curl -X POST https://api.oilpriceapi.com/v1/webhooks/{webhook_id}/test \
-H 'Authorization: Token YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"event_type": "price.updated"
}'
3. Monitor Delivery
curl https://api.oilpriceapi.com/v1/webhooks/{webhook_id}/events \
-H 'Authorization: Token YOUR_API_KEY'
# Response includes delivery status, attempts, and response codes
Ready for Real-Time Energy Intelligence?
Join leading energy companies using our webhooks for real-time oil prices and exclusive drilling intelligence data.
Start with Reservoir Mastery
Get instant access to webhooks, drilling intelligence, and premium support.
Start 14-Day Free TrialNo credit card required • Full API access • Cancel anytime
Need a custom solution?
Contact our Enterprise team →