imports

Monthly natural gas imports - total, pipeline, or LNG - one column per reporting country.

Examples

from openbb import obb
# Get monthly natural gas imports - one column per reporting country.
obb.jodi.gas.imports(provider='jodi')
# Compare LNG imports of Japan, China, and South Korea.
obb.jodi.gas.imports(provider='jodi', country='japan,china,south_korea', flow='lng', 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.

flow: str | None
Default: total

Description

The imports breakdown. JODI questionnaire definitions:
total: Amounts that have crossed the physical boundaries of the country, whether customs clearance has taken place or not; excludes goods in transit and goods temporarily admitted/withdrawn, includes re-imports; deliveries for international bunkers are excluded.
pipeline: Imports of gaseous natural gas through pipelines.
lng: Imports of liquefied natural gas through ocean tankers, on a re-gasified equivalent basis.

Choices

• total
• pipeline
• lng

unit: str | None
Default: m3
The unit of measurement. m3: million cubic metres (at 15C, 760 mm Hg); tj: terajoules, on a gross calorific value basis; ktons: thousand metric tons, on a re-gasified equivalent basis, reported only for LNG trade amounts.

Choices

• m3
• tj
• ktons

start_date: date | None | str
Start date of the data, in YYYY-MM-DD format. Defaults to the first data period, 2009-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: JodiGasImports

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.