Skip to main content

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: Webhooks Only for Reservoir Mastery

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

$129/month

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
Upgrade to Reservoir Mastery

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 Trial

No credit card required • Full API access • Cancel anytime

Need a custom solution?

Contact our Enterprise team →