stocks

Monthly closing stock levels of a petroleum product - one column per reporting country.

Examples

from openbb import obb
# Get monthly crude oil closing stock levels - one column per reporting country.
obb.jodi.oil.stocks(provider='jodi')
# Compare gasoline stocks in the United States and Japan, in thousand barrels.
obb.jodi.oil.stocks(provider='jodi', country='united_states,japan', product='gasoline', unit='kbbl', start_date='2020-01-01')

Parameters

• standard
• jodi

country: str | None
The country or countries to get data for, by name or ISO 3166-1 alpha-2 code. If None, all reporting countries are returned.

product: str | None
Default: crude_oil

Description

The petroleum product to get closing stock levels of. JODI questionnaire definitions:
crude_oil: Crude oil, including lease condensate and excluding NGL.
ngl: Liquid or liquefied hydrocarbons recovered from gas separation plants and gas processing facilities.
other_crude: Refinery feedstocks, additives/oxygenates, and other hydrocarbons.
total_crude: The sum of the primary categories: crude oil + NGL + other.
lpg: Liquefied petroleum gases, comprising propane and butane.
naphtha: Naphtha used as feedstock for producing high octane gasoline and as feedstock for the chemical/petrochemical industries.
gasoline: Motor gasoline and aviation gasoline; motor gasoline includes biogasoline, e.g. ethanol blends.
kerosene: Kerosenes, comprising jet kerosene and other kerosene.
jet_fuel: Kerosene type jet fuel: aviation fuel used for aviation turbine power units; a subset of the amount reported under kerosenes.
gas_diesel_oil: Gas/diesel oil, for automotive and other purposes; biodiesel is included.
fuel_oil: Heavy residual oil/boiler oil, including bunker oil.
other_products: Refinery gas, ethane, petroleum coke, lubricants, white spirit and SBP, bitumen, paraffin waxes, and other petroleum products.
total_products: The sum of all secondary product categories; demand for total products includes direct use of crude oil, NGL, and other hydrocarbons.

Choices

• crude_oil
• ngl
• other_crude
• total_crude
• lpg
• naphtha
• gasoline
• kerosene
• jet_fuel
• gas_diesel_oil
• fuel_oil
• other_products
• total_products

unit: str | None
Default: kbbl
The unit of measurement. kbd: thousand barrels per day; kbbl: thousand barrels; kl: thousand kilolitres; ktons: thousand metric tons; conversion_factor: barrels per thousand metric tons.

Choices

• kbd
• kbbl
• kl
• ktons
• conversion_factor

start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. Defaults to the first data period, 2002-01-01.

end_date: date | None | str
End date of the data, in YYYY-MM-DD format.

use_cache: bool | None
Default: True
If True, the source tables are cached under the user cache directory and revalidated against the source at most once per day, downloading again only when JODI has published an update.

---

Returns

results: JodiOilStocks

Serializable results.

provider: str | None

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• jodi

date: date | str
The date of the data.

albania: float | None
Monthly value reported by Albania.

algeria: float | None
Monthly value reported by Algeria.

angola: float | None
Monthly value reported by Angola.

argentina: float | None
Monthly value reported by Argentina.

armenia: float | None
Monthly value reported by Armenia.

australia: float | None
Monthly value reported by Australia.

austria: float | None
Monthly value reported by Austria.

azerbaijan: float | None
Monthly value reported by Azerbaijan.

bahrain: float | None
Monthly value reported by Bahrain.

bangladesh: float | None
Monthly value reported by Bangladesh.

barbados: float | None
Monthly value reported by Barbados.

belarus: float | None
Monthly value reported by Belarus.

belgium: float | None
Monthly value reported by Belgium.

belize: float | None
Monthly value reported by Belize.

bermuda: float | None
Monthly value reported by Bermuda.

bolivia: float | None
Monthly value reported by Bolivia.

brazil: float | None
Monthly value reported by Brazil.

brunei: float | None
Monthly value reported by Brunei.

bulgaria: float | None
Monthly value reported by Bulgaria.

canada: float | None
Monthly value reported by Canada.

chile: float | None
Monthly value reported by Chile.

china: float | None
Monthly value reported by China.

colombia: float | None
Monthly value reported by Colombia.

costa_rica: float | None
Monthly value reported by Costa Rica.

croatia: float | None
Monthly value reported by Croatia.

cuba: float | None
Monthly value reported by Cuba.

cyprus: float | None
Monthly value reported by Cyprus.

czechia: float | None
Monthly value reported by Czechia.

denmark: float | None
Monthly value reported by Denmark.

dominican_republic: float | None
Monthly value reported by Dominican Republic.

ecuador: float | None
Monthly value reported by Ecuador.

egypt: float | None
Monthly value reported by Egypt.

el_salvador: float | None
Monthly value reported by El Salvador.

equatorial_guinea: float | None
Monthly value reported by Equatorial Guinea.

estonia: float | None
Monthly value reported by Estonia.

eswatini: float | None
Monthly value reported by Eswatini.

finland: float | None
Monthly value reported by Finland.

france: float | None
Monthly value reported by France.

gabon: float | None
Monthly value reported by Gabon.

gambia: float | None
Monthly value reported by Gambia.

georgia: float | None
Monthly value reported by Georgia.

germany: float | None
Monthly value reported by Germany.

greece: float | None
Monthly value reported by Greece.

grenada: float | None
Monthly value reported by Grenada.

guatemala: float | None
Monthly value reported by Guatemala.

guyana: float | None
Monthly value reported by Guyana.

haiti: float | None
Monthly value reported by Haiti.

honduras: float | None
Monthly value reported by Honduras.

hong_kong: float | None
Monthly value reported by Hong Kong.

hungary: float | None
Monthly value reported by Hungary.

iceland: float | None
Monthly value reported by Iceland.

india: float | None
Monthly value reported by India.

indonesia: float | None
Monthly value reported by Indonesia.

iran: float | None
Monthly value reported by Iran.

iraq: float | None
Monthly value reported by Iraq.

ireland: float | None
Monthly value reported by Ireland.

italy: float | None
Monthly value reported by Italy.

jamaica: float | None
Monthly value reported by Jamaica.

japan: float | None
Monthly value reported by Japan.

kazakhstan: float | None
Monthly value reported by Kazakhstan.

kuwait: float | None
Monthly value reported by Kuwait.

latvia: float | None
Monthly value reported by Latvia.

libya: float | None
Monthly value reported by Libya.

lithuania: float | None
Monthly value reported by Lithuania.

luxembourg: float | None
Monthly value reported by Luxembourg.

malaysia: float | None
Monthly value reported by Malaysia.

malta: float | None
Monthly value reported by Malta.

mauritius: float | None
Monthly value reported by Mauritius.

mexico: float | None
Monthly value reported by Mexico.

moldova: float | None
Monthly value reported by Moldova.

morocco: float | None
Monthly value reported by Morocco.

myanmar: float | None
Monthly value reported by Myanmar.

nepal: float | None
Monthly value reported by Nepal.

netherlands: float | None
Monthly value reported by Netherlands.

new_zealand: float | None
Monthly value reported by New Zealand.

nicaragua: float | None
Monthly value reported by Nicaragua.

niger: float | None
Monthly value reported by Niger.

nigeria: float | None
Monthly value reported by Nigeria.

north_macedonia: float | None
Monthly value reported by North Macedonia.

norway: float | None
Monthly value reported by Norway.

oman: float | None
Monthly value reported by Oman.

panama: float | None
Monthly value reported by Panama.

papua_new_guinea: float | None
Monthly value reported by Papua New Guinea.

paraguay: float | None
Monthly value reported by Paraguay.

peru: float | None
Monthly value reported by Peru.

philippines: float | None
Monthly value reported by Philippines.

poland: float | None
Monthly value reported by Poland.

portugal: float | None
Monthly value reported by Portugal.

qatar: float | None
Monthly value reported by Qatar.

romania: float | None
Monthly value reported by Romania.

russia: float | None
Monthly value reported by Russia.

saudi_arabia: float | None
Monthly value reported by Saudi Arabia.

serbia: float | None
Monthly value reported by Serbia.

singapore: float | None
Monthly value reported by Singapore.

slovakia: float | None
Monthly value reported by Slovakia.

slovenia: float | None
Monthly value reported by Slovenia.

south_africa: float | None
Monthly value reported by South Africa.

south_korea: float | None
Monthly value reported by South Korea.

spain: float | None
Monthly value reported by Spain.

sudan: float | None
Monthly value reported by Sudan.

suriname: float | None
Monthly value reported by Suriname.

sweden: float | None
Monthly value reported by Sweden.

switzerland: float | None
Monthly value reported by Switzerland.

syria: float | None
Monthly value reported by Syria.

taiwan: float | None
Monthly value reported by Taiwan.

tajikistan: float | None
Monthly value reported by Tajikistan.

thailand: float | None
Monthly value reported by Thailand.

trinidad_and_tobago: float | None
Monthly value reported by Trinidad and Tobago.

tunisia: float | None
Monthly value reported by Tunisia.

turkiye: float | None
Monthly value reported by Turkiye.

ukraine: float | None
Monthly value reported by Ukraine.

united_arab_emirates: float | None
Monthly value reported by United Arab Emirates.

united_kingdom: float | None
Monthly value reported by United Kingdom.

united_states: float | None
Monthly value reported by United States.

uruguay: float | None
Monthly value reported by Uruguay.

venezuela: float | None
Monthly value reported by Venezuela.

vietnam: float | None
Monthly value reported by Vietnam.

yemen: float | None
Monthly value reported by Yemen.