Transactions History#
Returns a history of transactions, including the volume, vessels, and terminals involved
Endpoint#
POST |
https://leviaton.api.synmax.com/v1/transactions/history |
Python Method Name#
from synmax.leviaton.v1 import LeviatonApiClient
leviaton_client = LeviatonApiClient(access_token=access_token)
# Method name:
leviaton_api_client.transactions_history
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. |
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. |
Yufutsu |
destination_terminal_id |
string |
The unique identifier for the terminal. |
terminal_5c68727c3 |
destination_timestamp |
string |
The UTC timestamp of the actual transaction. |
2025-07-27T22:43:41.371622+00:00 |
imo |
integer |
International Maritime Organization number identifying the vessel. |
9554729 |
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. |
Ishikari |
loading_origin_terminal_id |
string |
The unique identifier for the origin terminal. |
terminal_1c148436c |
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. |
— |
origin_timestamp |
string |
The UTC timestamp of the forecasted origin of the transaction. |
2025-07-27T22:43:41.371622+00:00 |
transaction_type |
string |
The type of transaction, either loading or offloading. |
offloading |
vessel_name |
string |
The name of the vessel. |
AKEBONO MARU |
volume |
number |
The volume of LNG involved in the transaction. |
0.0062378166666666665 |
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 |
volume |
volume_unit |
transaction_type |
modified_at |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
9338797 |
Mundra |
terminal_28d5fd62f |
India |
IN |
2025-07-14 03:55:49+00 |
Qalhat |
terminal_5d3d00d42 |
Oman |
OM |
2025-07-23 11:59:26+00 |
2.9049 |
bcf |
loading |
2025-07-23 15:02:46.768284+00 |
|||||
9825427 |
Corpus Christi |
terminal_78fa9b2ca |
USA |
US |
2025-07-10 13:55:59+00 |
Mejillones |
terminal_fb5a036dc |
Chile |
CL |
2025-07-23 10:55:52+00 |
Corpus Christi |
terminal_78fa9b2ca |
USA |
US |
2025-07-10 13:55:59+00 |
3.65007 |
bcf |
offloading |
2025-07-23 15:02:46.768284+00 |
9942524 |
Cartagena _L |
terminal_587d3e0d8 |
Spain |
ES |
2025-07-17 07:52:38+00 |
Huelva L |
terminal_a92998c7c |
Spain |
ES |
2025-07-23 10:54:29+00 |
0.089030975 |
bcf |
loading |
2025-07-23 15:02:46.768284+00 |
|||||
9976147 |
Cove Point L |
terminal_bdc27fc80 |
USA |
US |
2025-06-22 10:55:16+00 |
Dabhol |
terminal_76ce0b06e |
India |
IN |
2025-07-23 10:49:11+00 |
Cove Point L |
terminal_bdc27fc80 |
USA |
US |
2025-06-22 10:55:16+00 |
3.6626999999999996 |
bcf |
offloading |
2025-07-23 15:02:46.768284+00 |
9884473 |
FSRU Golar Tundra _R |
terminal_18777c9dd |
Italy |
IT |
2025-06-30 22:58:18+00 |
Calcasieu Pass |
terminal_6134defa9 |
USA |
US |
2025-07-23 10:17:16+00 |
3.6626999999999996 |
bcf |
loading |
2025-07-23 15:02:46.768284+00 |
|||||
9830898 |
Sungai Udang |
terminal_1775b7689 |
Malaysia |
MY |
2024-09-09 23:55:21+00 |
Pengerang Johor _L |
terminal_836ce901e |
Malaysia |
MY |
2025-07-23 09:56:00+00 |
0.07998999999999999 |
bcf |
loading |
2025-07-23 15:02:46.768284+00 |
|||||
9781918 |
GTA Phase 1 |
terminal_5f4bddbdc |
Senegal |
SN |
2025-06-23 18:55:59+00 |
Hazira |
terminal_50579e6be |
India |
IN |
2025-07-23 09:35:39+00 |
GTA Phase 1 |
terminal_5f4bddbdc |
Senegal |
SN |
2025-06-23 18:55:59+00 |
3.6626999999999996 |
bcf |
offloading |
2025-07-23 15:02:46.768284+00 |
9685425 |
Fredrikstad _R |
terminal_11dd92c34 |
Norway |
NO |
2025-07-12 03:57:07+00 |
Gibbstown LNG |
terminal_28c27df09 |
USA |
US |
2025-07-23 08:55:50+00 |
0.578875 |
bcf |
loading |
2025-07-23 15:02:46.768284+00 |
|||||
9469235 |
Kushiro |
terminal_72fa173e6 |
Japan |
JP |
2025-07-21 05:57:37+00 |
Ishikari |
terminal_1c148436c |
Japan |
JP |
2025-07-23 08:29:18+00 |
Hachinohe |
terminal_200ff28e2 |
Japan |
JP |
2024-12-24 04:57:03+00 |
0.0010894448979591837 |
bcf |
offloading |
2025-07-23 15:02:46.768284+00 |
9324435 |
Port Qasim Karachi |
terminal_b86f80e9c |
Pakistan |
PK |
2025-07-19 00:55:38+00 |
Ras Laffan |
terminal_5606306ee |
Qatar |
QA |
2025-07-23 07:59:07+00 |
3.066985 |
bcf |
loading |
2025-07-23 15:02:46.768284+00 |