Transactions#
Returns a detailed list of historic and forecasted future transactions, including the volume, vessels, and terminals involved. The data is refreshed every hour.
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/transactions |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.transactions
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’] |
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. |
USA |
destination_country_code |
string |
The ISO 3166-1 alpha-2 country code where the terminal is located. |
US |
destination_terminal |
string |
The name of the terminal where the transaction occurred. |
Sabine Pass |
destination_terminal_id |
string |
The unique identifier for the terminal. |
terminal_25cd7fc53 |
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. |
8608872 |
loading_origin_country |
string |
The country where the transaction is forecasted to originate from. |
Australia |
loading_origin_country_code |
string |
The ISO 3166-1 alpha-2 country code where the transaction is forecasted to originate from. |
AU |
loading_origin_terminal |
string |
The terminal where the transaction is forecasted to originate from. |
North West Shelf |
loading_origin_terminal_id |
string |
The unique identifier for the origin terminal. |
terminal_25cd7fc53 |
loading_origin_timestamp |
string |
— |
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_25cd7fc53 |
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 number of the transaction. |
1 |
transaction_type |
string |
The type of transaction, either loading or offloading. |
loading |
vessel_name |
string |
The name of the vessel. |
LNGT ANTARCTICA |
volume |
number |
The volume of LNG involved in the transaction. |
2667035.0 |
volume_unit |
string |
The unit of measurement for the 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 |
forecasted_transaction |
transaction_number |
transaction_type |
forecast_run_at |
modified_at |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
9030838 |
Incheon |
terminal_0d2d39d69 |
South Korea |
KR |
2020-01-02 02:29:44+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-01-08 12:00:06+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
|||||||
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-01-08 12:00:06+00 |
Kawagoe |
terminal_634a12ae7 |
Japan |
JP |
2020-01-16 04:00:02+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-01-08 12:00:06+00 |
0.9121666666666667 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
||
9030838 |
Kawagoe |
terminal_634a12ae7 |
Japan |
JP |
2020-01-16 04:00:02+00 |
Chita |
terminal_f0c417f7c |
Japan |
JP |
2020-02-02 00:00:01+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-01-08 12:00:06+00 |
0.9121666666666667 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
||
9030838 |
Chita |
terminal_f0c417f7c |
Japan |
JP |
2020-02-02 00:00:01+00 |
Hitachi |
terminal_9842fd945 |
Japan |
JP |
2020-02-18 06:00:01+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-01-08 12:00:06+00 |
0.9121666666666667 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
||
9030838 |
Hitachi |
terminal_9842fd945 |
Japan |
JP |
2020-02-18 06:00:01+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-02-25 04:00:09+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
|||||||
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-02-25 04:00:09+00 |
Kawagoe |
terminal_634a12ae7 |
Japan |
JP |
2020-03-03 00:00:01+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-02-25 04:00:09+00 |
2.7365 |
bcf |
False |
offloading |
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 |
|||||||
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-03-10 00:02:08+00 |
Taichung |
terminal_843cc3ee5 |
Taiwan |
TW |
2020-03-18 22:01:48+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-03-10 00:02:08+00 |
2.7365 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |
||
9030838 |
Taichung |
terminal_843cc3ee5 |
Taiwan |
TW |
2020-03-18 22:01:48+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-03-24 03:00:03+00 |
2.7365 |
bcf |
False |
loading |
2025-07-23 15:02:46.768284+00 |
|||||||
9030838 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-03-24 03:00:03+00 |
Chita |
terminal_f0c417f7c |
Japan |
JP |
2020-03-31 00:00:03+00 |
MLNG |
terminal_75375a6e8 |
Malaysia |
MY |
2020-03-24 03:00:03+00 |
2.7365 |
bcf |
False |
offloading |
2025-07-23 15:02:46.768284+00 |