Short Term Forecast Declines#

This table provides data about the short-term forecasts of monthly oil production and monthly gas production declines for well APIs extended up to 10 years in to future.

To refer to the Short Term Forecast Declines API endpoint, click here.

Columns#

Column Name

Type

Description

Example Value

API

NUMBER

An API is a unique, permanent, numeric identifier assigned to each well drilled.

4221532392

DATE

DATE

Forecasted month (unsynced).

2022-07-15

GAS_MONTHLY

FLOAT

Amount of gas produced over one month (in MCF, or 1 thousand cubic feet).

134.235

OIL_MONTHLY

FLOAT

The amount of oil produced over one month (in BBLS, or barrels).

23.0

COMPLETION_DATE

DATE

The date when the well was completed.

2021-10-01

FIRST_PRODUCTION_MONTH

DATE

The first month when the well started producing.

2022-01-01

PRODUCTION_MONTH

NUMBER(38,0)

The production month, representing one or more months since the well started producing.

3

COUNTY_NAME

VARCHAR

County in the state where the well is located.

“HIDALGO”

OPERATOR_NAME

VARCHAR

Operator of the well.

“MERIT ENERGY COMPANY”

SUB_REGION

VARCHAR

Aggregation of several counties, typically representing a major producing basin.

“South - TX”

REGION

VARCHAR

Aggregation of multiple major producing basins.

“gulf”

FORECAST_RUN_DATE

DATE

Date of forecast generation (unsynced).

2024-05-23

MODELED

BOOLEAN

Indicates whether the production numbers are based on the forecast model (True) or from pipescrapes (False).

True

API_NO_10

VARCHAR

The first 10 digits of the API well number.

“4200347857”

STATE_AB

VARCHAR

Abbreviation of the state.

“TX”

Note

Unsynced data in the date column provide a date at the start of the month. However, the actual reported date is for the end of the month.

For example, if the reported date is “2022-1-10”, this means the data pertains to the month of January and was actually reported on “2022-01-31”.

This means that you should ideally interpret the reported date as representing the whole month and not just the specific date at the start of the month.

Example Data#

API

DATE

GAS_MONTHLY

OIL_MONTHLY

COMPLETION_DATE

FIRST_PRODUCTION_MONTH

PRODUCTION_MONTH

COUNTY_NAME

OPERATOR_NAME

SUB_REGION

REGION

FORECAST_RUN_DATE

MODELED

API_NO_10

STATE_AB

4242330962

2026-12-01

397.287782788

190.610231839

1993-01-01

408

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

4242330962

2027-01-01

397.287781155

190.610231839

1993-01-01

409

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

4242330962

2027-02-01

358.840575136

172.164080371

1993-01-01

410

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

4242330962

2026-03-01

397.287802701

190.610231839

1993-01-01

399

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

4242330962

2026-04-01

384.472064455

184.461514683

1993-01-01

400

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

4242330962

2026-05-01

397.28779733

190.610231839

1993-01-01

401

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

4242330962

2026-06-01

384.472059553

184.461514683

1993-01-01

402

Smith

EXXON MOBIL

Haynesville - TX

gulf

2024-09-11

true

4242330962

TX

Usage#

In Snowflake, you can write SQL queries to return the data you want.

Sample queries#

⮞ Return the total amount of OIL_MONTHLY forecast for COUNTY_NAME “Smith”

SELECT
  SUM(oil_monthly) AS total_oil_monthly
FROM
  short_term_forecast_declines
WHERE
  county_name ILIKE '%Smith%';

Output

TOTAL_OIL_MONTHLY

1

11322247.2277314

⮞ Return all the records where the operator is “EXXON MOBIL” and belongs to region “gulf”

SELECT
  *
FROM
  short_term_forecast_declines
WHERE
  operator_name ILIKE '%EXXON MOBIL%'
  AND region ILIKE '%gulf%';

Output

API

DATE

GAS_MONTHLY

OIL_MONTHLY

COMPLETION_DATE

FIRST_PRODUCTION_MONTH

PRODUCTION_MONTH

COUNTY_NAME

OPERATOR_NAME

SUB_REGION

REGION

FORECAST_RUN_DATE

MODELED

API_NO_10

STATE_AB

4247537812

2023-09-01

32765.0

3688.0

2020-07-01

39

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

False

4247537812

TX

4247537812

2023-10-01

32721.0

3949.0

2020-07-01

40

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

False

4247537812

TX

4247537812

2023-11-01

29871.0

3103.0

2020-07-01

41

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

False

4247537812

TX

4247537812

2023-12-01

39537.0

4418.0

2020-07-01

42

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

False

4247537812

TX

4247537812

2024-01-01

36906.0

4407.0

2020-07-01

43

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

False

4247537812

TX

4247537812

2024-02-01

39049.0

4157.0

2020-07-01

44

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

False

4247537812

TX

4247537812

2033-09-01

2971.797204429

499.934541124

2020-07-01

159

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

True

4247537812

TX

4247537812

2033-10-01

3034.014680014

516.498986349

2020-07-01

160

Ward

EXXON MOBIL

West - TX

gulf

2024-09-11

True

4247537812

TX