Transactions Forecast Details#
Returns a list of forecasted transactions, including a detailed route prediction breakdown. The forecasts are refreshed on an hourly basis.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/transactions/forecast/details |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.transactions_forecast_details
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. |
Spain |
destination_country_code |
string |
The ISO 3166-1 alpha-2 country code where the transaction is forecasted to occur. |
ES |
destination_terminal |
string |
The terminal where the transaction is forecasted to occur. |
Mugardos R |
destination_terminal_id |
string |
The unique identifier for the terminal. |
terminal_7e1c3aad4 |
destination_timestamp |
string |
The UTC timestamp of the actual transaction. |
2025-07-27T22:43:41.371622+00:00 |
forecast_run_at |
string |
The UTC timestamp of the forecast run. |
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 vessel is forecasted to depart from. |
USA |
origin_country_code |
string |
The ISO 3166-1 alpha-2 country code where the vessel is forecasted to depart from. |
US |
origin_terminal |
string |
The terminal where the vessel is forecasted to depart from. |
Sabine Pass |
origin_terminal_id |
string |
The unique identifier for the terminal. |
terminal_220d7ad08 |
origin_timestamp |
string |
The UTC timestamp of the forecasted departure of the vessel from the terminal. |
— |
route_score |
number |
The forecast route score is the product of forecast scores along a given forecast route. |
0.6942790140289807 |
route_score_weighted_volume |
number |
The forecast volume multiplied by the forecast route score. |
1826821.6556637555 |
score |
number |
The forecast score is the probability of a single forecast. |
0.6942790140289807 |
transaction_number |
integer |
The unique identifier for the transaction. |
1 |
transaction_type |
string |
The type of a forecast transaction, either loading or offloading. |
offloading |
vessel_name |
string |
The name of the vessel. |
INEOS INTUITION |
volume |
number |
The forecasted volume of LNG. |
2631250.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 |
score |
route_score |
route_score_weighted_volume |
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 |
0.5138481877366263 |
0.5138481877366263 |
1352063.043981998 |
1 |
offloading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
|||||
7361922 |
Old Harbour R |
terminal_66dea6e9d |
Jamaica |
JM |
2022-06-02 13:12:45+00 |
Mugardos L |
terminal_4264329f1 |
Spain |
ES |
2026-01-05 15:08:03.355608+00 |
2631250.0 |
mcf |
0.48615181226337356 |
0.48615181226337356 |
1279186.9560180018 |
1 |
loading |
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 |
0.18121723342225612 |
0.18121723342225612 |
648.4858698015436 |
1 |
loading |
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 |
Porvoo Refinery _L |
terminal_839af124a |
Finland |
FI |
2026-02-02 11:31:52.72376+00 |
3578.5 |
mcf |
0.1797298135248561 |
0.1797298135248561 |
643.1631376986975 |
1 |
loading |
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 |
Pori L |
terminal_0ceb73612 |
Finland |
FI |
2026-01-23 05:30:50.487145+00 |
3578.5 |
mcf |
0.1664444480970681 |
0.1664444480970681 |
595.6214575153582 |
1 |
loading |
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 _R |
terminal_bf0f8378e |
Finland |
FI |
2026-02-11 01:42:03.712402+00 |
3578.5 |
mcf |
0.1661927807706394 |
0.1661927807706394 |
594.7208659877331 |
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 |
Pori R |
terminal_c9d4b3a9b |
Finland |
FI |
2026-01-23 02:02:42.998629+00 |
3578.5 |
mcf |
0.15589521846490142 |
0.15589521846490142 |
557.8710392766498 |
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 |
Sweden12_L |
terminal_378482211 |
Sweden |
SE |
2025-12-10 14:46:21.299393+00 |
3578.5 |
mcf |
0.1505205057202788 |
0.1505205057202788 |
538.6376297200177 |
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.0 |
1.0 |
2576267.4 |
1 |
loading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 14:55:39.302527+00 |
|||||
9872901 |
Binhai (pipeline) |
terminal_1f047f8eb |
China |
CN |
2025-08-14 06:11:30.900548+00 |
PNG LNG |
terminal_1a55e918e |
Papua New Guinea |
PG |
2025-08-28 21:35:38.416411+00 |
3662700.0 |
mcf |
0.3058316626902356 |
0.011022770626606324 |
40373.10197407098 |
3 |
loading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 15:03:07.415027+00 |