Transactions Details#
Returns a list of transaction details with multi-step ahead predicted transactions including prediction scores. The data is refreshed every hour.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/transactions/details |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.transactions_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’] |
forecast_run_at |
string |
The UTC timestamp of the forecast run to filter the transactions. |
2025-07-27T22:43:41.371622+00:00 |
from_timestamp |
string |
The start UTC timestamp to filter the transactions by destination_timestamp |
2025-07-27T22:43:41.371622+00:00 |
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’] |
to_timestamp |
string |
The end UTC timestamp to filter the transactions by destination_timestamp |
2025-07-27T22:43:41.371622+00:00 |
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 terminal is located. |
Japan |
destination_country_code |
string |
The ISO 3166-1 alpha-2 country code where the terminal is located. |
JP |
destination_terminal |
string |
The name of the terminal where the transaction occurred. |
Tobata Kitakyushu |
destination_terminal_id |
string |
The unique identifier for the terminal. |
terminal_9a3564cac |
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 |
forecasted_transaction |
boolean |
Indicates whether the transaction is forecasted. |
True |
imo |
integer |
International Maritime Organization number identifying the vessel. |
9433884 |
loading_origin_country |
string |
The country where the transaction is forecasted to originate from. |
Japan |
loading_origin_country_code |
string |
The ISO 3166-1 alpha-2 country code where the transaction is forecasted to originate from. |
JP |
loading_origin_terminal |
string |
The terminal where the transaction is forecasted to originate from. |
Terminal 9220 |
loading_origin_terminal_id |
string |
The unique identifier for the origin terminal. |
terminal_df01c7aa2 |
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 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_9a3564cac |
origin_timestamp |
string |
The UTC timestamp of the forecasted origin of the transaction. |
— |
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 number of the transaction. |
1 |
transaction_type |
string |
The type of transaction, either loading or offloading. |
offloading |
vessel_name |
string |
The name of the vessel. |
SHINJU MARU NO.2 |
volume |
number |
The volume of LNG involved in the transaction. |
0.008897133333333333 |
volume_unit |
string |
The unit of measurement for the volume. |
bcf |
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 |
score |
route_score |
route_score_weighted_volume |
volume |
volume_unit |
forecasted_transaction |
transaction_number |
transaction_type |
forecast_run_at |
modified_at |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2022-04-28 11:08:40+00 |
Sakaide LNG |
terminal_6345dbc8f |
Japan |
JP |
2022-05-08 23:55:27+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2022-04-28 11:08:40+00 |
2.7365 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
|||||
9030838 |
Yangshan R |
terminal_2db64381b |
China |
CN |
2025-08-19 23:58:27.649276+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2025-08-27 15:57:00.118701+00 |
1.0 |
0.10253771229821539 |
280594.4497040664 |
2736500.0 |
mcf |
True |
5.0 |
loading |
2025-07-23 14:02:17.639938+00 |
2025-07-23 15:08:21.789646+00 |
|||||
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2025-04-16 11:55:23+00 |
Sodeshi |
terminal_9447c8575 |
Japan |
JP |
2025-04-25 02:55:08+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2025-04-16 11:55:23+00 |
2.7365 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
|||||
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2024-03-09 02:52:42+00 |
Hitachi |
terminal_9842fd945 |
Japan |
JP |
2024-03-17 06:59:37+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2024-03-09 02:52:42+00 |
2.7365 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
|||||
9030838 |
Samcheok |
terminal_20ce84819 |
South Korea |
KR |
2023-12-26 03:11:38+00 |
Chita |
terminal_f0c417f7c |
Japan |
JP |
2024-01-12 00:57:12+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2023-12-10 08:59:17+00 |
1.36825 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
|||||
9030838 |
Nigata |
terminal_70d492283 |
Japan |
JP |
2023-03-05 00:11:15+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2023-03-19 02:12:32+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
||||||||||
9030838 |
Map Ta Phut |
terminal_d282492d3 |
Thailand |
TH |
2021-06-30 03:12:12+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2021-07-06 03:25:51+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
||||||||||
9030838 |
Chita |
terminal_f0c417f7c |
Japan |
JP |
2024-01-12 00:57:12+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2024-01-19 23:55:00+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
||||||||||
9030838 |
Chita |
terminal_f0c417f7c |
Japan |
JP |
2020-03-31 00:00:03+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-04-10 23:09:58+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
||||||||||
9030838 |
Kawagoe |
terminal_634a12ae7 |
Japan |
JP |
2020-03-03 00:00:01+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-03-10 00:02:08+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |