Mineral rights statistics data dictionary
Mineral buyer fee disclosure statistics
| Field | Meaning |
|---|---|
| source_data_row | One-based logical data record in the archived ledger, excluding its header. |
| entity, role | Public entity name and role as coded in the archived ledger. |
| observed_at, source_ledger | Date the websites were read and the immutable October ledger URL. |
| fields ending in _stance | Original observation code. Explicit, indirect, and not found remain distinct. |
| fields ending in _source_url | Archived primary locator for that field, when available. |
| indicator flags | 1 means the definition was met. 0 means the definition was not met by the coded evidence, including missing evidence. It does not assert the site's actual policy. |
| title_term, recording_term, taxes_or_notary, commission_term | Named categories within explicit cost language. These do not assert who pays. |
| numeric_commission | An explicit cost row with a published percentage in its coded description. |
| close_timing_language | Original explicit closing or payment timing language, including qualitative claims. |
Mineral buyer closing and payment statistics
| Field | Meaning |
|---|---|
| source_data_row | One-based logical data record in the archived ledger, excluding its header. |
| entity, role | Public entity name and role as coded in the archived ledger. |
| observed_at, source_ledger | Date the websites were read and the immutable October ledger URL. |
| fields ending in _stance | Original observation code. Explicit, indirect, and not found remain distinct. |
| fields ending in _source_url | Archived primary locator for that field, when available. |
| indicator flags | 1 means the definition was met. 0 means the definition was not met by the coded evidence, including missing evidence. It does not assert the site's actual policy. |
| agreement_clock | Stated close or payment interval beginning at acceptance, agreed price, or a signed sale agreement. |
| later_clock | Stated close or payment interval beginning after title, deed, documents, or closing, including immediate funding language. |
| contact_or_consultation_clock | Stated overall interval from contact or consultation. |
| no_comparable_close_interval | Conservatively coded cases where the tracked closing field gave only qualitative speed, a component interval, or a different endpoint. |
Written mineral offers and paperwork statistics
| Field | Meaning |
|---|---|
| source_data_row | One-based logical data record in the archived ledger, excluding its header. |
| entity, role | Public entity name and role as coded in the archived ledger. |
| observed_at, source_ledger | Date the websites were read and the immutable October ledger URL. |
| fields ending in _stance | Original observation code. Explicit, indirect, and not found remain distinct. |
| fields ending in _source_url | Archived primary locator for that field, when available. |
| indicator flags | 1 means the definition was met. 0 means the definition was not met by the coded evidence, including missing evidence. It does not assert the site's actual policy. |
| explicit_written_offer_recode | Written offer or offer letter named, regardless of whether the site identifies the initial stage. |
| initial_written_offer | Written offer in the recode explicitly described as preliminary or an initial mailed bid. |
| agreement_or_valuation, written_quote_only | Agreement, contract, LOI or written valuation, or quote described in writing without explicit offer-letter wording. |
| document type flags | Document category named in an explicit documents entry. Mentions include optional or later-stage use. |
Mineral buyer eligibility disclosure statistics
| Field | Meaning |
|---|---|
| source_data_row | One-based logical data record in the archived ledger, excluding its header. |
| entity, role | Public entity name and role as coded in the archived ledger. |
| observed_at, source_ledger | Date the websites were read and the immutable October ledger URL. |
| fields ending in _stance | Original observation code. Explicit, indirect, and not found remain distinct. |
| fields ending in _source_url | Archived primary locator for that field, when available. |
| indicator flags | 1 means the definition was met. 0 means the definition was not met by the coded evidence, including missing evidence. It does not assert the site's actual policy. |
| explicit_inheritance_language, explicit_partial_sale_language | Original explicit labels for inheritance or partial-sale wording. |
| nonproducing_consideration_language | A narrower recode for wording on possible nonproducing consideration, excluding purely educational or procedural mentions. |
| small_or_all_sizes_language | Specific small-interest, no-minimum or all-size wording, including named conditions. Numerical ranges alone are excluded. |
Farm oil and gas payments
| Field | Meaning |
|---|---|
| population, geography | USDA survey group and geography. |
| observed_year | Year measured, rather than date of study publication. |
| payments_usd_million, estimated_rights_value_usd_million | Distinct amounts in nominal millions of U.S. dollars. |
| payments_as_pct_net_cash_farm_income | Published ratio of the group’s payments to net cash farm income. |
| source_locator, source_url | Primary table and source. |
Unclaimed royalty records
| Field | Meaning |
|---|---|
| state, source_version | State and primary document label. |
| observed_item, evidence_category | Visible instruction and scope of the observation. |
| source_locator, source_url | Primary passage and source. |
Federal oil and gas royalty collections
| Field | Meaning |
|---|---|
| fiscal_year | ONRR federal fiscal year. |
| onshore_royalty_usd, offshore_royalty_usd, total_royalty_usd | Summed federal oil and gas royalty collections in nominal dollars. |
| offshore_pct | Offshore dollars divided by the combined total, percentage rounded to one decimal. |
| source_url | Official ONRR input file. |
Federal mineral revenue disbursements
| Field | Meaning |
|---|---|
| fiscal_year, fund_type | ONRR period and recipient grouping. |
| disbursement_usd, all_funds_total_usd | Nominal annual dollars disbursed to the category and to all categories. |
| share_pct | Category divided by that fiscal year’s total, rounded to one decimal. |
| source_url | Official ONRR source file. |
Oil and gas production on farmland
| Field | Meaning |
|---|---|
| geography | Contiguous United States or one of six states printed in Table 1. |
| production_year, farm_land_input_year | Year of production values and year of farm area inputs. |
| total_production_value_usd_billion, estimated_farmland_production_value_usd_billion | Reported total value and USDA’s allocated farmland value, in nominal billions of dollars. |
| estimated_share_pct | Estimated farmland value divided by total value, rounded to one decimal. |
| source_locator, source_url | Primary table and publisher document. |
Texas crude oil concentration by county
| Field | Meaning |
|---|---|
| period, vintage | Calendar month and reporting vintage from the Commission. |
| display_rank, county | Within-period ranking by crude barrels and county name, with alphabetical ties. |
| county_crude_barrels, statewide_crude_barrels | County numerator and statewide denominator in reported crude barrels. |
| county_share_pct, primary_source | County share rounded to one decimal and source table URL. |
U.S. low-producing well statistics
| Field | Meaning |
|---|---|
| year, rate_bracket_boe_per_day | EIA reporting year and rate cutoff. Groups are not all mutually exclusive. |
| metric, unit | Well count, oil volume or natural gas volume with the corresponding EIA unit. |
| bracket_numerator, all_included_denominator | Numerator and denominator in the specified metric and unit. |
| share_pct, workbook_cells, calculation, primary_source | Derived share to one decimal, source cells, operation and original workbook URL. |
Texas orphan well counts by county
| Field | Meaning |
|---|---|
| report_month, display_rank, county | Workbook month, rank by count and reported county label. |
| listed_api_count, statewide_listed_api_count | County numerator and statewide denominator of distinct listed API identifiers. |
| county_share_pct, api_rows_missing_lat_or_lon | County share to one decimal and number of listed rows with either coordinate blank. |
| workbook_locator, primary_source | Original worksheet columns and public download URL. |
Federal leases, permits and wells
| Field | Meaning |
|---|---|
| fiscal_year, geography | Federal fiscal year and national or geographic state reporting scope. |
| metric, source_value | Published count or acres, with source and category indicated. |
| count_basis, workbook_cell, primary_source | Fiscal-year activity or fiscal-year-end inventory, source cell and workbook. |
Federal split-estate acreage
| Field | Meaning |
|---|---|
| fiscal_year, geography | BLM table year and named geographic row. The dataset contains three national totals and four selected FY 2025 state rows. |
| onshore_federal_minerals_million_acres | Onshore federal minerals within the BLM’s responsibilities, as reported in millions of acres. |
| federal_surface_lands_million_acres, split_estate_federal_minerals_million_acres | The two area columns BLM adds to obtain its onshore federal minerals total. Federal surface lands includes lands of all federal agencies. |
| source_url, source_locator, checked_date | Edition, table and footnote locator, and AMR’s date of verification. |
Public mineral acquisition terms
| Field | Meaning |
|---|---|
| close_date, buyer, asset_perimeter and geography | Identified completed transaction and what the filing says was acquired. |
| reported_cash_component_usd_million | Cash component or cash transaction value as disclosed. Basis and costs are in the row note. |
| stated_contingent_cash_cap_usd_million | Maximum stated contingent cash, separate from base cash and any realized payment. |
| stated_opco_units | Reported count of OpCo units. A blank records no count used in this comparison. |
| reported_net_royalty_acres | Same-perimeter net royalty acres when recorded. Blanks are not zeros. |
| primary_source, source_locator and supplementary_primary_source | Evidence locator and supporting filing or issuer statement. |
Oil and gas trust distributions
| Field | Meaning |
|---|---|
| trust and ticker | Legal trust name and its reporting ticker in the source. |
| period_start and period_end | Matching calendar year bounds. |
| distribution_usd_per_unit_as_published | Cash distribution per unit at the precision in the primary trustee record or annual filing. |
| distribution_usd_per_unit_rounded | Same value to cents for display comparison. |
| reporting_basis and source_locator | Time attribution basis and location of the underlying number. |
| primary_source and confirmation_source | Original trustee or SEC documents. Rounded statement totals independently cross-check the selected amounts. |
Oil and gas monthly price movements
| Field | Meaning |
|---|---|
| month | Calendar month for the spot-price average, YYYY-MM. |
| wti_usd_per_barrel | EIA Cushing WTI spot-price average in dollars per barrel. |
| henry_hub_usd_per_mmbtu | EIA Henry Hub spot-price average in dollars per million British thermal units. |
| wti_change_pct and henry_hub_change_pct | Signed percentage change from the preceding matched month. The first month has no change value. |
| wti_eia_source and henry_hub_eia_source | Original EIA series URLs. Source row is calendar year, column is month. |
Oil versus gas royalty receipts
| Field | Meaning |
|---|---|
| fiscal_year, onrr_commodity | ONRR source period and exact commodity label. |
| royalty_usd, all_commodities_royalties_usd | Signed nominal dollar sums after the stated filter. |
| share_percent | Commodity dollars divided by all included royalty dollars in the same fiscal year. |
| source_url | Primary ONRR fiscal-year file. |
Federal lease payment mix
| Field | Meaning |
|---|---|
| fiscal_year, onrr_revenue_type | ONRR fiscal year and selected exact revenue-type label. |
| payment_usd, three_type_total_usd | Signed nominal dollars for the type and for royalties, bonuses and rents combined. |
| share_percent | Type dollars divided by the same-year three-category total. |
| source_url | Primary ONRR fiscal-year file. |
Gulf offshore revenue sharing
| Field | Meaning |
|---|---|
| disbursement_fiscal_year | Fiscal year in the ONRR disbursement file, distinct from the year of receipt. |
| onrr_fund_type, recipient_state_group | ONRR recipient fund type and state label. Blank state applies to nonstate groups in this file. |
| disbursement_usd | Sum of signed nominal dollar rows for the group. |
| all_ocs_gulf_funds_usd, four_state_and_local_total_usd | Two different same-year totals, repeated on rows for interpretation. |
| included_in_four_state_total | Yes only for state and local rows in the four named states. |
| source_url | Primary ONRR fiscal-year file. |
Texas crude oil and condensate
| Field | Meaning |
|---|---|
| month, county | Preliminary reporting month and Texas county. |
| crude_oil_bbl, condensate_bbl | The separate source columns, in barrels. |
| crude_county_rank, condensate_county_rank | Descending order among 254 rows, alphabetical within a tie. |
| statewide_crude_bbl, statewide_condensate_bbl | Sums of the same 254 rows. |
| oil_ranked_source, gas_ranked_source | Two verified versions of the same RRC county data. |
Federal onshore royalty collections by state
| Field | Meaning |
|---|---|
| fiscal_year, source_state | ONRR period and state where the source receipts are attributed. |
| royalties_usd, total_federal_onshore_royalties_usd | Nominal U.S. dollars, calculated from the same four ONRR classifications. |
| share_of_total_pct | The state's receipts divided by the fiscal year's federal onshore royalty total. |
| source_url | Primary ONRR file. |
Gross, marketed and dry gas production
| Field | Meaning |
|---|---|
| calendar_year, primary_source | Calendar year and original national EIA workbook. |
| gross_withdrawals_mmcf, marketed_mmcf, dry_mmcf | Three EIA production stages in million cubic feet. |
| repressuring_mmcf, vented_flared_mmcf, nonhydrocarbon_removed_mmcf | Volumes removed before marketed production. |
| extraction_loss_mmcf | Gaseous equivalent of liquids extracted. |
| dry_share_of_gross_pct | Dry production divided by gross withdrawals, times 100. |
U.S. gas withdrawals by well type
| Field | Meaning |
|---|---|
| calendar_year, well_type | Calendar year and exact EIA source category. |
| gross_withdrawals_mmcf | Category volume in million cubic feet. |
| national_gross_withdrawals_mmcf | Published national total for the same year. |
| share_of_national_gross_pct | Category volume divided by the national total, times 100. |
| primary_source | EIA historical series workbook. |
Lower 48 crude oil gravity mix
| Field | Meaning |
|---|---|
| calendar_month, days_in_month | Published period and calendar days for volume weighting. |
| all_gravities_kbd | Published total including the unclassified category, in thousand barrels per day. |
| api_*_kbd | Reported gravity-band rates or AMR sums of the selected published bands. |
| primary_source | Original EIA workbook. |
Crude oil and total petroleum trade
| Field | Meaning |
|---|---|
| calendar_year | Full-year EIA observation ending in period code 13. |
| crude_*_kbd, petroleum_*_kbd | Published or calculated thousand barrels per day. |
| products_*_kbd | Petroleum less crude in the same flow. Net imports are imports minus exports. |
| eia_*_source | Primary CSV table for the flow or reconciliation. |
U.S. proved oil reserves change
| Field | Meaning |
|---|---|
| calendar_year, source_workbook | Calendar reporting year and EIA source table. |
| beginning_reserves_mmbbl, end_reserves_mmbbl | Beginning and ending stocks, in million barrels. |
| revisions_other_mmbbl, net_transactions_mmbbl, extensions_discoveries_mmbbl | Published components of reserve change. |
| production_mmbbl, published_net_change_mmbbl | Production magnitude to subtract and reported net change. |
Federal royalties adjusted for inflation
| Field | Meaning |
|---|---|
| fiscal_year, first_cpi_month, last_cpi_month, cpi_month_count | Matched federal fiscal-year index window and month count. |
| fiscal_avg_cpi_u, fy2025_base_avg_cpi_u | Arithmetic means of 12 unadjusted monthly CPI-U values. |
| nominal_royalties_usd, fy2025_dollar_royalties | Reported dollars and CPI-adjusted dollars. |
| revenue_source, cpi_source | The two primary inputs. |
Native American land royalty collections
| Field | Meaning |
|---|---|
| fiscal_year, source_csv | Federal fiscal year and primary revenue file. |
| federal_royalties_usd, native_american_royalties_usd | Signed totals grouped by ONRR land class. |
| two_class_total_royalties_usd | Sum of the two recorded classes, not all U.S. royalties. |
| native_american_share_of_two_class_total_pct | Native American amount divided by the two-class total. |
Federal coal royalty receipts
| Field | Meaning |
|---|---|
| fiscal_year, geography | Federal fiscal year and United States total or reported source state. |
| federal_coal_royalties_usd | Signed receipts on Federal Coal leases, royalties only. |
| national_royalties_usd | Same-year total across all included records. |
| share_of_same_year_national_total_pct | Geographic amount divided by national net receipts. |
| source_csv | Original ONRR fiscal-year file. |
Negative entries in federal royalty data
| Field | Meaning |
|---|---|
| fiscal_year, source_csv | ONRR fiscal year and original CSV. |
| nonnegative_royalties_usd, negative_royalties_usd | Separate signed sums for values at or above zero and below zero. |
| net_royalties_usd | Sum of the two subtotals. |
| nonnegative_row_count, negative_row_count | Counts of source rows, not payments. |
| overstatement_if_negative_omitted_pct | Magnitude of negative subtotal divided by net royalties. |
Federal oil and gas producing acreage
| Field | Meaning |
|---|---|
| fiscal_year, geography | BLM federal fiscal year and national or geographic state inventory. |
| federal_acres_in_effect, blm_producing_acres | BLM federal onshore acreage in effect and acreage covered by producing leases, Tables 2 and 6. |
| producing_share_of_acres_in_effect_pct | Producing acres divided by acres in effect, times 100. |
| source_workbook | BLM primary Excel source. |
Offshore royalty receipts by region
| Field | Meaning |
|---|---|
| fiscal_year | Federal fiscal year ending in September. |
| gulf_royalties_usd, pacific_royalties_usd, alaska_royalties_usd | Signed receipt sums for matching rows in each observed offshore region. |
| offshore_total_royalties_usd, gulf_share_pct | Total across the three observed source regions and Gulf royalties divided by that total, times 100. |
| gulf_row_count, pacific_row_count, alaska_row_count, source_url | Counts of selected source records and primary input address. |
Federal geothermal lease receipts
| Field | Meaning |
|---|---|
| fiscal_year | Federal fiscal year with all four payment types present in the reviewed ONRR file. |
| royalties_usd, bonus_usd, rents_usd, other_revenues_usd | Signed sums of original revenue records grouped by revenue type. |
| signed_total_usd, royalties_share_pct, bonus_share_pct | Signed sum across all four types and shares of that same year’s sum. |
| royalty_row_count, bonus_row_count, rent_row_count, other_row_count, source_url | Selected row counts for each category and original fiscal revenue source. |
Federal royalty receipts vs. spot prices
| Field | Meaning |
|---|---|
| fiscal_year, first_month, last_month, month_count | Federal fiscal year and complete October to September price window. |
| wti_month_mean_usd_per_barrel, henry_hub_month_mean_usd_per_mmbtu | Equal-weight averages of the 12 published monthly prices in each window. |
| oil_royalties_usd, gas_royalties_usd | Signed federal Oil and Gas commodity royalty receipts in the matching fiscal year. |
| oil_row_count, gas_row_count, revenue_source, wti_source, henry_hub_source | Count of matching revenue rows and primary source addresses. |
Crude oil production by state
| Field | Meaning |
|---|---|
| calendar_year, primary_table | Calendar year and source locator. |
| us_kbd, texas_kbd, new_mexico_kbd, north_dakota_kbd, colorado_kbd, alaska_kbd, oklahoma_kbd, california_kbd | Published annual average field production rates, thousand barrels per day. |
| federal_gulf_kbd, federal_pacific_kbd | Separate federal offshore EIA rows, thousand barrels per day. |
| other_us_by_difference_kbd | Published U.S. rate less every named state and offshore row retained in the file. |
| tx_nm_nd_share_pct, tx_nm_share_pct | Fixed state group rate divided by the published U.S. rate, times 100. |
Refinery inputs and utilization
| Field | Meaning |
|---|---|
| calendar_year | Complete calendar year for all four measures. |
| gross_distillation_input_kbd, refinery_blender_net_crude_input_kbd | Two different input rates in thousand barrels per day. |
| operable_capacity_kb_per_calendar_day | Operable atmospheric crude distillation capacity in thousand barrels per calendar day. |
| published_utilization_pct, calculated_utilization_pct | Published EIA percent and gross input divided by capacity, times 100. |
| operable_minus_gross_kbd, gross_minus_net_crude_kbd | Arithmetic daily rate differences in thousand barrels per day. |
| gross_source, capacity_source, utilization_source, net_crude_source | Exact EIA annual series locators. |
SPR and commercial crude stocks
| Field | Meaning |
|---|---|
| month_end | Calendar date of the matched observation. |
| spr_kbbl, commercial_ex_spr_kbbl, total_kbbl | Three published EIA crude stock levels in thousand barrels. |
| spr_share_pct | SPR stock divided by published total stock, times 100. |
| spr_minus_commercial_kbbl | SPR stock minus non-SPR stock in thousand barrels. |
| spr_source, commercial_source, total_source | Exact EIA monthly history URLs. |
Natural gas trade and LNG
| Field | Meaning |
|---|---|
| calendar_year | January through December, United States. |
| exports_*_mmcf, imports_*_mmcf | Published EIA gas-equivalent volumes in million cubic feet, by all modes, mode, or named pipeline partner. |
| net_exports_*_mmcf | Exports minus imports for the same year and reported scope. A positive result means net exports. |
| annual_release_date, primary_url, source_tables | Source release date, fixed edition PDF and table locators. The release date is distinct from the observation year. |
Underground gas stocks and flows
| Field | Meaning |
|---|---|
| geography, observation_period | United States or selected state, and calendar year or month-end date according to the metric. |
| metric, value, unit | Reported or derived stock or flow measure, integer value in million cubic feet and stated unit. |
| source_release_date, primary_url, locator_or_formula | Release vintage, official source and table locator or operation. Annual flows and monthly stocks retain their separate vintages. |
Federal drilling permit processing times
| Field | Meaning |
|---|---|
| fiscal_year | BLM fiscal year shown in Table 12. |
| blm_phase_mean_calendar_days, operator_phase_mean_calendar_days | Published annual mean calendar days after and before application completeness, respectively. |
| total_mean_calendar_days | Published annual mean total calendar days. |
| operator_share_of_mean_total_pct | AMR divides the operator phase mean by the total mean. |
Federal oil and gas auction results
| Field | Meaning |
|---|---|
| fiscal_year, blm_office, sale_date | BLM Table 15 fiscal year, reporting office and date of sale. |
| reported_total_receipts_usd | Published total receipts in nominal U.S. dollars including bonus bids, first-year rentals and fees. |
| parcels_offered, acres_offered | Parcels and acres listed as offered at the sale. |
| parcels_receiving_bids, acres_receiving_bids | Published parcels and acres that received bids. |
| parcels_receiving_bids_pct, acres_receiving_bids_pct | AMR divides each sale’s receiving units by the corresponding offered units. |