New Americas Gas Endpoint

This release adds the pipeline flows endpoint:

This will, in the future, replace the NA Gas endpoint. Which is difficult to use and has several glaring filtering limitations.

More Oil/NGL Endpoints

Added the remaining Oil/NGL Endpoints:

Service Catalog

includes:
Inventories
Price Forecast
Runs
Production
Utilization
Demand

See readme for a couple examples

Added Integrated Energy Scenarios

Integrated Energy Scenarios includes forecasts for various Energy and Climate Scenarios, including Green Rules, Discord and Inflections (base planning scenario), and low emission cases: Accelerated CCS and Multitech Mitigation.

for example:

df = ies.get_coal_market(country="France", year=2025, scenario="Inflections 2024")
print(df)

shows the predicted coal consumption by sector (Power, Agriculture, Transport, etc..) for France in 2025 under the Inflections (base-case) scenario as of 2024.

Bug Fix

Fixed an issue parsing the modifiedDate in arbflow, which was preventing it from returning at all for certain margins.

EU Gas Outages

Added EU Gas Outages Endpoints:

• get_outages_event
• get_outages_time_series

Added Additional Chemicals Endpoints

This release includes a function to find the unique values in a given dataset. This is useful for knowing the exact values to pass to endpoints for filtering operations:

import spgci as ci

chem = ci.Chemicals()

# just a single column
chem.get_unique_values(dataset='production', columns='region')

# distinct values across multiple columns
chem.get_unique_values(dataset='capacity', columns=['region', 'commodity'])

Additional Endpoints Added:

• capacity
• production
• capacity-utilization
• demand-by-derivative
• demand-by-end-use
• trade
• inventory-change
• total-supply
• total-demand
• assumptions
• country-supply-demand-balance
• region-supply-demand-balance
• world-supply-demand-balance

Oil and NGL Analytics

Included in this version:

• Added the Oil and NGL Analytics API.
• Added modified_date_(gte|gt|lte|lt) as a parameter in the MarketData().get_symbols method.
• Added sector as a parameter in the Insights().get_heards, get_top_news, get_latest_news, get_spotlights, and get_stories methods.

Added LNG Forecast Prices

• Updated WorldRefineryData to using the latest endpoint (which no longer requires an Appkey)
• Added LNG Forecast Prices Endpoints

LNG Market Fundamentals

Added the LNG Market Fundamentals endpoints:

https://developer.spglobal.com/commodityinsights/servicecatalog/documentation#/LNGGlobalAnalytics/v1/LNG%20Market%20Fundamentals%20API

Hub Balances and Removed ApiKey

Important

This release removes the ApiKey usage. You can still pass it in, for backwards compatibility, but it is ignored.

EU Gas Analytics:

We've added hub balances

df = egp.get_overview_hub_balance(
    gas_day_gte="2024-10-01",
    gas_day_lte="2024-10-31",
    average_type="Daily value",
    hub="PEG",
    uom="MCM",
)
df.pivot_table(
    index=["hubFlowType", "hubSubFlowType"],
    columns="dayMonthOrdinal",
    values="quantity",
)

(example from readme)

A few things to note on these endpoints:

• it's recommended to specify a uom, otherwise you will get duplicate records
• Also, to specify a direction where supported.
• we introduced a custom sort function for the dayMonthOrdinal field, so that the above pivot table columns are sorted sensibly.