Transactions Forecast#
Returns a list of forecasted transactions, including the volume, vessels, and terminals involved. The forecasts are refreshed on an hourly basis.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/transactions/forecast |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.transactions_forecast
Parameters#
Parameter |
Type |
Description |
Example |
|---|---|---|---|
destination_countries |
string |
A list of destination ISO 3166 country names to filter the transactions. |
[‘Japan’, ‘Malaysia’] |
destination_country_codes |
string |
A list of destination ISO 3166-1 alpha-2 country codes to filter the transactions. |
[‘JP’, ‘MY’] |
destination_polygons |
array |
A closed list of closed EPSG:4326 lon, lat coordinate pairs to filter by. |
[[[-125.0, 24.5], [-125.0, 49.5], [-66.9, 49.5], [-66.9, 24.5], [-125.0, 24.5]], [[122.9, 24.0], [122.9, 45.5], [146.0, 45.5], [146.0, 24.0], [122.9, 24.0]]] |
destination_regions |
string |
A list of destination regions to filter the transactions. |
[‘Asia’, ‘Europe’] |
destination_terminals |
string |
A list of destination terminal names to filter the transactions. |
[‘Higashi-Ohgishima’, ‘PFLNG DUA’] |
imos |
integer |
A list of IMO numbers to filter the transactions. |
[9030838] |
loading_origin_countries |
string |
A list of loading origin ISO 3166 country names to filter the transactions. |
[‘Malaysia’] |
loading_origin_country_codes |
string |
A list of loading origin ISO 3166-1 alpha-2 country codes to filter the transactions. |
[‘MY’] |
loading_origin_polygons |
array |
A closed list of closed EPSG:4326 lon, lat coordinate pairs to filter by. |
[[[99.6, 1.0], [99.6, 7.5], [104.5, 7.5], [104.5, 1.0], [99.6, 1.0]], [[109.0, 1.0], [109.0, 7.5], [115.0, 7.5], [115.0, 1.0], [109.0, 1.0]]] |
loading_origin_regions |
string |
A list of loading origin regions to filter the transactions. |
[‘Asia’] |
loading_origin_terminal_ids |
string |
A list of loading origin terminal ids to filter the transactions. |
[‘terminal_75375a6e8’] |
loading_origin_terminals |
string |
A list of loading origin terminal names to filter the transactions. |
[‘Chita’, ‘Sodeshi’, ‘MLNG’] |
origin_countries |
string |
A list of origin ISO 3166 country names to filter the transactions. |
[‘Malaysia’] |
origin_country_codes |
string |
A list of origin ISO 3166-1 alpha-2 country codes to filter the transactions. |
[‘MY’] |
origin_polygons |
array |
A closed list of closed EPSG:4326 lon, lat coordinate pairs to filter by. |
[[[99.6, 1.0], [99.6, 7.5], [104.5, 7.5], [104.5, 1.0], [99.6, 1.0]], [[109.0, 1.0], [109.0, 7.5], [115.0, 7.5], [115.0, 1.0], [109.0, 1.0]]] |
origin_regions |
string |
A list of origin regions to filter the transactions. |
[‘Asia’] |
origin_terminal_ids |
string |
A list of origin terminal ids to filter the transactions. |
[‘terminal_75375a6e8’] |
origin_terminals |
string |
A list of origin terminal names to filter the transactions. |
[‘Chita’, ‘Sodeshi’, ‘MLNG’] |
transaction_type |
string |
The type of transaction to filter the transactions. |
loading |
Response Details#
Parameter |
Type |
Description |
Example |
|---|---|---|---|
destination_country |
string |
The country where the transaction is forecasted to occur. |
USA |
destination_country_code |
string |
The ISO 3166-1 alpha-2 country code where the transaction is forecasted to occur. |
US |
destination_terminal |
string |
The terminal where the transaction is forecasted to occur. |
Sabine Pass |
destination_terminal_id |
string |
The unique identifier for the terminal. |
terminal_220d7ad08 |
destination_timestamp |
string |
The UTC timestamp of the forecasted transaction. |
2025-07-27T22:43:41.371622+00:00 |
imo |
integer |
International Maritime Organization number identifying the vessel. |
9020766 |
loading_origin_country |
string |
The country where the transaction is forecasted to originate from. |
USA |
loading_origin_country_code |
string |
The ISO 3166-1 alpha-2 country code where the transaction is forecasted to originate from. |
US |
loading_origin_terminal |
string |
The terminal where the transaction is forecasted to originate from. |
Sabine Pass |
loading_origin_terminal_id |
string |
The unique identifier for the terminal. |
terminal_220d7ad08 |
loading_origin_timestamp |
string |
The UTC timestamp of the forecasted origin of the transaction. |
2025-07-27T22:43:41.371622+00:00 |
modified_at |
string |
The UTC timestamp of the last modification to the forecast transaction in the database. |
2025-07-27T22:43:41.371622+00:00 |
origin_country |
string |
The country where the transaction is forecasted to originate from. |
USA |
origin_country_code |
string |
The ISO 3166-1 alpha-2 country code where the transaction is forecasted to originate from. |
US |
origin_terminal |
string |
The terminal where the transaction is forecasted to originate from. |
Sabine Pass |
origin_terminal_id |
string |
The unique identifier for the terminal. |
terminal_220d7ad08 |
origin_timestamp |
string |
The UTC timestamp of the forecasted origin of the transaction. |
2025-07-27T22:43:41.371622+00:00 |
transaction_number |
integer |
The unique identifier for the transaction. |
1 |
transaction_type |
string |
The type of a forecast transaction, either loading or offloading. |
loading |
vessel_name |
string |
The name of the vessel. |
INEOS INTUITION |
volume |
number |
The forecasted volume of LNG. |
2694400.0 |
volume_unit |
string |
The unit of measurement for the forecasted volume. |
mcf |
Normal Output#
imo |
origin_terminal |
origin_terminal_id |
origin_country |
origin_country_code |
origin_timestamp |
destination_terminal |
destination_terminal_id |
destination_country |
destination_country_code |
destination_timestamp |
loading_origin_terminal |
loading_origin_terminal_id |
loading_origin_country |
loading_origin_country_code |
loading_origin_timestamp |
volume |
volume_unit |
transaction_number |
transaction_type |
forecast_run_at |
modified_at |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
7361922 |
Old Harbour R |
terminal_66dea6e9d |
Jamaica |
JM |
2022-06-02 13:12:45+00 |
Mugardos R |
terminal_7e1c3aad4 |
Spain |
ES |
2026-01-30 12:38:38.240232+00 |
2631250.0 |
mcf |
1 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
|||||
7382691 |
Lysekil |
terminal_5c131e4a5 |
Sweden |
SE |
2024-05-28 03:41:26+00 |
Exemplar FSRU Inkoo _L |
terminal_92b65e188 |
Finland |
FI |
2026-01-21 16:42:53.511386+00 |
3578.5 |
mcf |
1 |
loading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
|||||
7382732 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2023-10-02 05:10:54+00 |
GTA Phase 1 |
terminal_5f4bddbdc |
Senegal |
SN |
2025-12-26 02:03:48.2048+00 |
2576267.4 |
mcf |
1 |
loading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
|||||
8608705 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2022-03-06 23:12:24+00 |
Itaguai |
terminal_64b11b0e0 |
Brazil |
BR |
2025-12-05 15:43:49.449237+00 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2022-03-06 23:12:24+00 |
2673350.0 |
mcf |
1 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
8608872 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2025-06-25 16:59:16+00 |
North West Shelf |
terminal_25cd7fc53 |
Australia |
AU |
2025-08-17 11:12:50.181168+00 |
2667035.0 |
mcf |
1 |
loading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
|||||
8608872 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2025-08-13 04:08:35.254636+00 |
Higashi-Ohgishima |
terminal_540fd51b4 |
Japan |
JP |
2025-08-24 01:32:23.551908+00 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2025-06-25 16:59:16+00 |
2667035.0 |
mcf |
2 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:58:57.659116+00 |
8608872 |
North West Shelf |
terminal_25cd7fc53 |
Australia |
AU |
2025-08-17 11:12:50.181168+00 |
Higashi-Ohgishima |
terminal_540fd51b4 |
Japan |
JP |
2025-08-31 00:32:52.238978+00 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2025-06-25 16:59:16+00 |
2667035.0 |
mcf |
2 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:58:57.659116+00 |
8608872 |
Gorgon LNG |
terminal_5ea4154c7 |
Australia |
AU |
2025-08-17 15:45:49.892757+00 |
Higashi-Ohgishima |
terminal_540fd51b4 |
Japan |
JP |
2025-08-31 10:13:27.727891+00 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2025-06-25 16:59:16+00 |
2667035.0 |
mcf |
2 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:58:57.659116+00 |
8608872 |
Ichthys LNG |
terminal_f458e2bdd |
Australia |
AU |
2025-08-17 18:51:58.820901+00 |
Higashi-Ohgishima |
terminal_540fd51b4 |
Japan |
JP |
2025-08-29 18:39:01.059092+00 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2025-06-25 16:59:16+00 |
2667035.0 |
mcf |
2 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:58:57.659116+00 |
8608872 |
Prelude FLNG |
terminal_656a17536 |
Australia |
AU |
2025-08-18 04:48:41.851745+00 |
Higashi-Ohgishima |
terminal_540fd51b4 |
Japan |
JP |
2025-08-30 20:44:20.631483+00 |
Jurong Island |
terminal_065ae4e88 |
Singapore |
SG |
2025-06-25 16:59:16+00 |
2667035.0 |
mcf |
2 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:58:57.659116+00 |