Note that the Liquids API can be used to access Oil, CPP and DPP data by using a single host URL i.e. https://api.kpler.com/
\nIf you need help with this documentation please reach out to cs@kpler.com
\n![](\"https://kp-prod-public-content.s3-eu-west-1.amazonaws.com/doc/available-columns.gif\")
\n\nYou are able to generate custom code snippet by choosing your favorite language. You will find in this list all available programming languages.
\nVessel: 1 time/hour
\nTrade: 1 time/hour
\nPort-calls: 1 time/hour
\nFlow: 1 time/hour
\nFleet metrics: 1 time/every 3 hours
\nNote: Queries should not be run simultaneously and should be run one after another (sequentially) to reduce the load.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7260703","collectionId":"ca98fde2-6222-4bb0-9569-550b4621baee","publishedId":"SzmiVFY9","public":true,"customColor":{"top-bar":"FF5349","right-sidebar":"303030","highlight":"FF5349"},"publishDate":"2023-10-20T06:48:56.000Z"},"item":[{"name":"Login","item":[{"name":"Basic Authentication","id":"a5f9108b-f219-4d98-9e11-9de7b2394d23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"---","header":[{"key":"Authorization","value":"Basic YOUR_TOKEN","type":"text"}],"url":"{{HOST_URL}}/v1/{{endpoint}}","description":"What is {{HOST_URL}} and where do we find it?
\n","urlObject":{"path":["v1","{{endpoint}}"],"host":["{{HOST_URL}}"],"query":[],"variable":[]}},"response":[{"id":"42e8dc4f-d75a-4ea4-ac19-78c66d640b91","name":"Liquids - Basic Authentication with trades","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Basic YOUR_TOKEN","type":"text"}],"url":{"raw":"https://api.kpler.com/v1/trades?size=10","protocol":"https","host":["api","kpler","com"],"path":["v1","trades"],"query":[{"key":"size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Thu, 18 Jun 2020 12:08:44 GMT"},{"key":"Content-Type","value":"text/csv; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"*,Accept-Encoding"},{"key":"Pragma","value":"no-cache"},{"key":"Cache-Control","value":"private, no-cache, no-store, must-revalidate, max-age=0, proxy-revalidate, s-maxage=0, Expires: Sat, 12 Oct 1991 05:00:00 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"Vessel;Volume (bbl);Grade;Product;Group;Family;Date (origin);Origin;Eta source (origin);Reload STS Partial (origin);Date (destination);Destination;Eta source (destination);Reload STS Partial (destination);Forecasted destination;Forecasted ETA;Forecasted confidence;Trade status;Seller (origin);Buyer (destination);Intermediaries;Country (origin);Subcontinent (origin);Continent Origin;Eta (origin);Start (origin);End (origin);Country (destination);Subcontinent (destination);Continent Destination;Eta (destination);Start (destination);End (destination);Capacity (vessel m3);Vessel type;Cargo type (vessel);Id (vessel);Id (Trade);Zone Origin;Zone Origin Id;Zone Destination;Zone Destination Id;Installation origin;Installation origin id;Installation Destination;Installation Destination Id;Mileage;Ton Miles;Id (Voyage)\nKattegat;77264;;;;Clean;2020-12-08 11:32;Szczecin;Port;;;;;;;;;Scheduled;;;;Poland;Eastern Europe;Europe;2020-12-06 23:30;;;;;;;;;12471;GP;;81861;6827388;Szczecin;3664;;;;;;;;;30417586\nCoswish Lake;2128660;;;crude/co;Dirty;2020-10-10 07:13;;Model;;;;Model;;China;2020-08-04 13:03;0.99;Scheduled;;;;;;;;;;;;;;;;343584;VLCC;;101940;6820772;;;;;;;;;;;30413461\nFontana;1061367;;;crude/co;Dirty;2020-10-09 23:29;;Model;;;;Model;;Asia;2020-11-18 23:09;0.6;Scheduled;;;;;;;;;;;;;;;;171314;LR3;;101329;6825280;;;;;;;;;;;30416318\nRichmond Voyager;2122031;;;crude/co;Dirty;2020-10-09 21:39;;Model;;;;Model;;China;2020-10-16 21:39;0.64;Scheduled;;;;;;;;;;;;;;;;342514;VLCC;;102665;6768227;;;;;;;;;;;30381079\nHunter Saga;2122031;;;crude/co;Dirty;2020-10-04 19:21;;Model;;;;Model;;Eastern Asia;2020-11-11 10:09;0.78;Scheduled;;;;;;;;;;;;;;;;342513;VLCC;;103894;6825896;;;;;;;;;;;30416813\nVoyager I;708836;;;crude/co;Dirty;2020-10-02 16:06;;Model;;;;Model;;Petronas Melaka Refinery;2020-10-06 06:40;0.99;Scheduled;Petronas;Petronas;0;;;;;;;;;;;;;114412;LR2;;71174;6823947;;;;;;;;;;;30415640\nMinerva Vera;1039045;;;crude/co;Dirty;2020-10-01 16:36;;Model;;;;Model;;North China;2020-11-03 16:21;0.99;Scheduled;;;;;;;;;;;;;;;;167711;LR3;;80645;6825824;;;;;;;;;;;30416762\nArosa;2002386;;;crude/co;Dirty;2020-10-01 16:30;;Model;;;;Model;;China;2020-10-08 16:30;0.82;Scheduled;Aramco;;1;;;;;;;;;;;;;323202;VLCC;;100944;6825374;;;;;;;;;;;30416389\nDrenec;2002707;;;crude/co;Dirty;2020-09-29 18:56;;Model;;;;Model;;North China;2020-11-01 18:56;0.43;Scheduled;;;;;;;;;;;;;;;;323254;VLCC;;97406;6825054;;;;;;;;;;;30416135\nShaden;2002707;;;crude/co;Dirty;2020-09-29 00:29;;Model;;;;Model;;Asia;2020-10-18 07:09;0.99;Scheduled;Aramco;;0;;;;;;;;;;;;;323254;VLCC;;100672;6825710;;;;;;;;;;;30416667\n"}],"_postman_id":"a5f9108b-f219-4d98-9e11-9de7b2394d23"},{"name":"/v1/login","event":[{"listen":"test","script":{"id":"a981d822-5a6d-4814-bf4f-ebad1375f58a","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"47d56a25-c797-49b2-9273-ccb8568bc858","exec":[""],"type":"text/javascript"}}],"id":"f2e4171c-434e-4243-b6ea-beac14133d58","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"Required [String]: Content-Type \"application/json\"
\n","key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"email\": \"your_mail@example.com\",\n\t\"password\": \"your_password\"\n}"},"url":"{{HOST_URL}}/v1/login","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","login"],"host":["{{HOST_URL}}"],"query":[],"variable":[]}},"response":[{"id":"88582200-5eed-4334-86c2-f1d31c38e4e2","name":"Liquids - Login","originalRequest":{"method":"POST","header":[{"description":"**Required [String]**: Content-Type \"application/json\"","key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"email\": \"your_mail@example.com\",\n\t\"password\": \"your_password\"\n}"},"url":"https://api.kpler.com/v1/login"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"token\": \"ef6599b897e90072739f7f877d640e76b52934eb38a5d25516afefde10d5091634ec9389ac85f08fb3ce78e44c77ec211e46d4690fe38d2c678dd4d5a4ce94bbae8105ad88de767f23d124238c9549bda40090cc302cea38ef39a66a0927bba16fb13739dd3ea4c1f02456190d3c9b743676a54fadflspzirfjznfkfe85\",\n \"user\": {\n \"accounts\": [\n \"oil\",\n \"cpp\",\n \"lng\",\n \"lpg\",\n \"coal\"\n ]\n }\n}"},{"id":"afedd2e2-9afa-4c95-8a46-e9571ce7195b","name":"CPP - Login","originalRequest":{"method":"POST","header":[{"description":"**Required [String]**: Content-Type \"application/json\"","key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"email\": \"your_mail@example.com\",\n\t\"password\": \"your_password\"\n}"},"url":"https://api-cpp.kpler.com/v1/login"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"token\": \"f8c59ce093c61bd171009197584509190ae051620ee8135bbf4cee1d752b68cae4ed00d60846c6bbf66693be3e4601b44742f3e418e0c56869ae7152983e029b9aff9ce74dcff8af11e3964aa1c0fad4d23ad8f94989ebbd8fcaEfdszBvcdspl3c44c126d230828d0d5009b7974544dd7b9fd86445994c40088196af59c5fe\",\n \"user\": {\n \"accounts\": [\n \"oil\",\n \"cpp\",\n \"lng\",\n \"lpg\",\n \"coal\"\n ]\n }\n}"}],"_postman_id":"f2e4171c-434e-4243-b6ea-beac14133d58"}],"id":"f0c89033-4628-42cc-b232-8f3fe14882ce","description":"You are able to use our API by using Basic Authentication. It is not necessary to use login endpoint to do this.
\nFollow these steps to use Basic Authentication :
\nEncode your email and password in base64
\n your_email@example.com:your_password = Y3VzdG9tZXJAZW1haWwuY29tOm1Zc3RSb25nUDRzc3cwUmQ=\n\nAdd your encoded credentials in the 'Authorization' header.
\n Authorization: Basic Y3VzdG9tZXJAZW1haWwuY29tOm1Zc3RSb25nUDRzc3cwUmQ=\n\nIn python3
\nimport base64\ntoken = base64.b64encode(str.encode(f'your_email:your_password')).decode('ascii')\n\nIn jQuery
\nlet encodedData = btoa(\"YOUR_EMAIL:YOUR_PASSWORD\");\n/* Output */ \nencodedData = WU9VUl9FTUFJTDpZT1VSX1BBU1NXT1JE\n\nIn Node.js
\nlet data = 'YOUR_EMAIL:YOUR_PASSWORD';\nlet buffer = Buffer.from(data);\nlet encodedData = buffer.toString('base64');\n/* Output */ \nencodedData = WU9VUl9FTUFJTDpZT1VSX1BBU1NXT1JE\n\nFor Windows Users:
\nRunning this command in your command prompt to convert the string [YOUR_USERNAME]:[YOUR_PASSWORD] to a base64-encrypted string.
\nPress Windows key + R
\nEnter cmd to open the command prompt
\nCopy-paste the command below (changing the username/password) and run it
\n powershell \"[convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes(\\\"YOUR_USERNAME:YOUR_PASSWORD\\\"))\"\n\nIf you have any problems with this section, please do not hesitate to contact us.
\nWe provide you with a second authentication method to access our data. This method is the most used in the examples in the documentation, but you can choose the method you prefer.
\nTo do so, you have to use the endpoint /login that will allow you to generate the Bearer Token to request our API's.
\n","event":[{"listen":"prerequest","script":{"id":"3ea008fe-478c-4bfc-b0d6-43824d2b20cb","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"fc37d95c-dfb1-42d0-bd9d-b0ab98651b3b","type":"text/javascript","exec":[""]}}],"_postman_id":"f0c89033-4628-42cc-b232-8f3fe14882ce","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Trades","item":[{"name":"/v1/trades","event":[{"listen":"test","script":{"id":"45357501-e865-4575-93a1-03e1f674cba6","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"6dbc685c-7e4f-453b-969e-879642f01de7","exec":[""],"type":"text/javascript"}}],"id":"d14e1116-e0b9-483c-b730-48da8b921c1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/trades?size={{size}}&vessels={{vessels}}&fromInstallations={{fromInstallations}}&toInstallations={{toInstallations}}&fromZones={{fromZones}}&toZones={{toZones}}&buyers={{buyers}}&sellers={{sellers}}&products={{products}}&startDate={{startDate}}&endDate={{endDate}}&tradeStatus={{tradeStatus}}&destinationStartDate={{destinationStartDate}}&destinationEndDate={{destinationEndDate}}&vesselTypes={{vesselTypes}}&vesselTypesAlt={{vesselTypesAlt}}&withForecast={{withForecast}}&withIntraCountry={{withIntraCountry}}&withIntraRegion={{withIntraRegion}}&columns={{columns}}&hash={{hash}}&withProductEstimation={{withProductEstimation}}","description":"What is {{HOST_URL}} and where do we find it?
\n","urlObject":{"protocol":"https","path":["v1","trades"],"host":["api","kpler","com"],"query":[{"description":{"content":"Optional [Integer]: Maximum number of trades returned
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"description":{"content":"Optional [String]: Names/IMO's of vessels
\n","type":"text/plain"},"key":"vessels","value":"{{vessels}}"},{"description":{"content":"Optional [String]: Names of the origin installations
\n","type":"text/plain"},"key":"fromInstallations","value":"{{fromInstallations}}"},{"description":{"content":"Optional [String]: Names of the destination installations (terminal/refinery)
\n","type":"text/plain"},"key":"toInstallations","value":"{{toInstallations}}"},{"description":{"content":"Optional [String]: Names of the origin zones (port/region/country/continent)
\n","type":"text/plain"},"key":"fromZones","value":"{{fromZones}}"},{"description":{"content":"Optional [String]: Names of the destination zones (port/region/country/continent)
\n","type":"text/plain"},"key":"toZones","value":"{{toZones}}"},{"description":{"content":"Optional [String]: Buyers of the cargo
\n","type":"text/plain"},"key":"buyers","value":"{{buyers}}"},{"description":{"content":"Optional [String]: Sellers of the cargo
\n","type":"text/plain"},"key":"sellers","value":"{{sellers}}"},{"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [Date]: Origin Date: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: Origin Date: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Return only trades of a particular status [“delivered”, ”loading”, ”in transit”, ”scheduled”].
\n","type":"text/plain"},"key":"tradeStatus","value":"{{tradeStatus}}"},{"description":{"content":"Optional [Date]: Destination Date: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"destinationStartDate","value":"{{destinationStartDate}}"},{"description":{"content":"Optional [Date]: Destination Date: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"destinationEndDate","value":"{{destinationEndDate}}"},{"description":{"content":"Optional [String]: For given cpp vessel types\n
\nUse [\"LR2\", \"VLCC\", \"LR3\", \"MR\", \"GP\", \"LR1\"]\n
\nNotes:
Optional [String]: For given oil vessel types\n
\nUse [\"Aframax\", \"Product Tanker\", \"Suezmax\", \"VLCC\", \"Panamax\", \"ULCC\"]\n
\nNotes:
Optional [Boolean]: Default to true if not specified. Include trades predicted by our in-house model when set to \"true\". Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withForecast","value":"{{withForecast}}"},{"description":{"content":"Optional [Boolean]: Default to true if not specified. Takes into account the trades that originate from and are delivered to the same country. Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withIntraCountry","value":"{{withIntraCountry}}"},{"description":{"content":"Optional [Boolean]: Default to true if not specified. Takes into account the trades that originate from and are delivered to a specified region. Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withIntraRegion","value":"{{withIntraRegion}}"},{"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the next endpoint to learn more about how to generate the hash code )
\nNote: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"},{"description":{"content":"Optional [Boolean]: Default to false if not specified. Activate the product estimation feature for CPP, Fuel Oils and Chem/Bio trades only. When set to true, the estimated product will overwrite the existing product information.
\n","type":"text/plain"},"key":"withProductEstimation","value":"{{withProductEstimation}}"}],"variable":[]}},"response":[{"id":"20c2aa98-6317-4939-86fa-a742b715dd60","name":"CPP - Last 2 trades from West Coast India by Diesel where trades status is set to delivered and selllers are RIL and Nayara Energy","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades?fromZones=West Coast India&sellers=RIL, Nayara Energy&products=Diesel&tradeStatus=Delivered&withForecast=false&withIntraCountry=true&size=2","protocol":"https","host":["api","kpler","com"],"path":["v1","trades"],"query":[{"key":"fromZones","value":"West Coast India"},{"key":"sellers","value":"RIL, Nayara Energy"},{"key":"products","value":"Diesel"},{"key":"tradeStatus","value":"Delivered"},{"key":"withForecast","value":"false"},{"key":"withIntraCountry","value":"true"},{"key":"size","value":"2"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Vessel;Volume (bbl);Grade;Product;Group;Family;Date (origin);Origin;Eta source (origin);Reload STS Partial (origin);Date (destination);Destination;Eta source (destination);Reload STS Partial (destination);Forecasted destination;Forecasted ETA;Forecasted confidence;Trade status;Seller (origin);Buyer (destination);Intermediaries;Country (origin);Subcontinent (origin);Continent Origin;Eta (origin);Start (origin);End (origin);Country (destination);Subcontinent (destination);Continent Destination;Eta (destination);Start (destination);End (destination);Capacity (vessel m3);Vessel type;Cargo type (vessel);Id (vessel);Id (Trade);Zone Origin;Zone Origin Id;Zone Destination;Zone Destination Id;Installation origin;Installation origin id;Installation Destination;Installation Destination Id;Mileage;Ton Miles;Id (Voyage)\nDavis Sea;656587;ULSD;Diesel;Gasoil/Diesel;Middle Distillates;2020-06-06 07:28;Jamnagar Refinery;;;2020-06-16 12:29;Kipevu;;;;;;Delivered;RIL;Vitol;0;India;South-Central Asia;Asia;2020-06-05 03:00;2020-06-05 07:01;2020-06-06 07:28;Kenya;Eastern Africa;Africa;2020-06-21 17:59;2020-06-16 12:29;;115672;LR2;;73826;6797106;Sikka;2358;Mombasa;1060;Jamnagar Refinery;1266;Kipevu;1369;2673;235279058;30344402\nFlagship Orchid;500241;ULSD;Diesel;Gasoil/Diesel;Middle Distillates;2020-06-02 08:43;Jamnagar Refinery;;;2020-06-12 05:29;Vopak Sebarok;;;;;;Delivered;RIL;;1;India;South-Central Asia;Asia;2020-06-07 08:15;2020-06-01 12:02;2020-06-02 08:43;Singapore Republic;South-East Asia;Asia;2020-06-12 08:00;2020-06-12 05:29;2020-06-13 15:29;80743;LR1;;83258;6777998;Sikka;2358;Singapore;1109;Jamnagar Refinery;1266;Vopak Sebarok;1337;2864;192082585;30301499\n"},{"id":"2cea877e-400b-465a-a417-0a98c8693a6a","name":"Liquids - Last 5 trades from United States by WTI, Gasoline, LSFO products since 2020-01-01 to 2020-03-01","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades?fromZones=United States&startDate=2020-01-01&endDate=2020-03-01&products=WTI, Gasoline, LSFO&size=5","protocol":"https","host":["api","kpler","com"],"path":["v1","trades"],"query":[{"key":"fromZones","value":"United States"},{"key":"startDate","value":"2020-01-01"},{"key":"endDate","value":"2020-03-01"},{"key":"products","value":"WTI, Gasoline, LSFO"},{"key":"size","value":"5"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Vessel;Volume (bbl);Grade;Product;Group;Family;Date (origin);Origin;Eta source (origin);Reload STS Partial (origin);Date (destination);Destination;Eta source (destination);Reload STS Partial (destination);Forecasted destination;Forecasted ETA;Forecasted confidence;Trade status;Seller (origin);Buyer (destination);Intermediaries;Country (origin);Subcontinent (origin);Continent Origin;Eta (origin);Start (origin);End (origin);Country (destination);Subcontinent (destination);Continent Destination;Eta (destination);Start (destination);End (destination);Capacity (vessel m3);Vessel type;Cargo type (vessel);Id (vessel);Id (Trade);Zone Origin;Zone Origin Id;Zone Destination;Zone Destination Id;Installation origin;Installation origin id;Installation Destination;Installation Destination Id;Mileage;Ton Miles;Id (Voyage)\nIndigo Sun;677664;eagle ford condensate;condensate;crude/co;Dirty;2020-03-01 20:19;Enterprise Houston;;;2020-03-26 17:18;Vopak Europoort;;;;;;Delivered;Enterprise;;1;United States;Northern America;Americas;2020-03-04 08:15;2020-02-29 01:07;2020-03-01 20:19;Netherlands;Northern Europe;Europe;2020-03-26 17:23;2020-03-26 17:18;2020-03-29 02:30;123646;LR2;;90071;6075686;Houston;2957;Rotterdam;2573;Enterprise Houston;1637;Vopak Europoort;1554;5188;415919779;26178352\nIndigo Sun;57331;WTI;crude;crude/co;Dirty;2020-03-01 20:19;Enterprise Houston;;;2020-03-26 17:18;Vopak Europoort;;;;;;Delivered;Enterprise;;1;United States;Northern America;Americas;2020-03-04 08:15;2020-02-29 01:07;2020-03-01 20:19;Netherlands;Northern Europe;Europe;2020-03-26 17:23;2020-03-26 17:18;2020-03-29 02:30;123646;LR2;;90071;6075686;Houston;2957;Rotterdam;2573;Enterprise Houston;1637;Vopak Europoort;1554;5188;39252889;26178352\nCap Guillaume;890001;WTI;crude;crude/co;Dirty;2020-03-01 13:39;Moda Ingleside;;;2020-04-08 12:58;MOT;;;;;;Delivered;Oxy;BP,Aramco,Total,ExxonMobil,Shell;0;United States;Northern America;Americas;2020-02-28 20:38;2020-02-28 20:15;2020-03-01 13:39;Netherlands;Western Europe;Europe;2020-04-07 12:14;2020-04-08 12:58;2020-04-09 17:34;171838;LR3;;75698;6272216;Corpus Christi;1284;Rotterdam;2573;Moda Ingleside;2246;MOT;1549;5471;642571636;26097221\nEndless Summer;291450;;Gasoline;Gasoline/Naphtha;Light Ends;2020-03-01 09:32;ITC Pasadena;;Partial;2020-03-23 17:13;Sao Luis;;Partial;;;;Delivered;;Petrobras;0;United States;Northern America;Americas;2020-03-05 12:15;2020-02-27 22:45;2020-03-01 09:32;Brazil;South America;Americas;;2020-03-23 17:13;2020-03-24 22:12;55882;MR;;81461;6156016;Houston;2957;Sao Luis;2575;ITC Pasadena;1625;;;3836;133849016;26184805\nEndless Summer;8547;;Gasoline;Gasoline/Naphtha;Light Ends;2020-03-01 09:32;ITC Pasadena;;Partial;2020-03-15 20:53;Sao Luis;;Partial;;;;Delivered;;Petrobras;0;United States;Northern America;Americas;2020-03-05 12:15;2020-02-27 22:45;2020-03-01 09:32;Brazil;South America;Americas;2020-03-22 14:15;2020-03-15 20:53;2020-03-16 10:28;55882;MR;;81461;6076831;Houston;2957;Sao Luis;2575;ITC Pasadena;1625;;;3809;3897533;26184805\nValle Bianca;94127;87 Gasoline;Gasoline;Gasoline/Naphtha;Light Ends;2020-03-01 04:19;ExxonMobil Baytown Refinery;;Partial;2020-03-18 23:20;Pemex Veracruz;;;;;;Delivered;ExxonMobil;Pemex;1;United States;Northern America;Americas;2020-03-07 04:15;2020-03-01 00:31;2020-03-01 04:19;Mexico;Northern America;Americas;;2020-03-18 23:20;2020-03-19 02:37;56431;MR;;79117;6135497;Houston;2957;San Juan de Ulua;1226;ExxonMobil Baytown Refinery;1640;Pemex Veracruz;3383;890;10031452;26221024\n"},{"id":"cb9e8e09-ea61-4b7c-a3bf-1860e18b76b8","name":"Retrieve columns using hash","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades?hash=YOUR_HASH","protocol":"https","host":["api","kpler","com"],"path":["v1","trades"],"query":[{"key":"hash","value":"YOUR_HASH"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null},{"id":"de5ce8af-c3d9-48ae-9329-c82ecc91c667","name":"OIL - Trades from Russian Federation to China by Urals since 2020-06-01","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades?fromZones=Russian Federation&columns=all&toZones=China&products=Urals&withForecast=true&startDate=2020-06-01","protocol":"https","host":["api","kpler","com"],"path":["v1","trades"],"query":[{"key":"fromZones","value":"Russian Federation"},{"key":"columns","value":"all"},{"key":"toZones","value":"China"},{"key":"products","value":"Urals"},{"key":"withForecast","value":"true"},{"key":"startDate","value":"2020-06-01"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Vessel;Country (origin);Zone Origin;Installation origin;End (origin);Country (destination);Zone Destination;Installation Destination;Start (destination);Volume (bbl);Family;Group;Product;Grade;Id (Trade);Origin PortCall Id;Destination PortCall Id;Id (Voyage);Zone Origin Id;Zone Destination Id;Installation origin id;Installation Destination Id;Continent Destination;Continent Origin;Mileage;Ton Miles;Import price;Number of trades (import);Export price;Number of trades (export);Date (origin);Origin;Reload STS Partial (origin);Date (destination);Destination;Reload STS Partial (destination);Forecasted destination;Forecasted ETA;Forecasted confidence;Forecasted origin;Forecasted origin ETA;Forecasted origin confidence;Trade status;Seller (origin);Buyer (destination);Intermediaries;Subcontinent (origin);Eta (origin);Start (origin);Eta source (origin);Eta source (destination);Subcontinent (destination);Eta (destination);End (destination);Capacity (vessel m3);Vessel type;Cargo type (vessel);Id (vessel);IMO (vessel);MMSI (vessel);Charterer;Zone Canal Transit;Link1 delivery;Link1 type;Link1 seller name;Link1 seller country;Link1 buyer name;Link1 buyer country;Link2 delivery;Link2 type;Link2 seller name;Link2 seller country;Link2 buyer name;Link2 buyer country;Link3 delivery;Link3 type;Link3 seller name;Link3 seller country;Link3 buyer name;Link3 buyer country;Link4 delivery;Link4 type;Link4 seller name;Link4 seller country;Link4 buyer name;Link4 buyer country;Link5 delivery;Link5 type;Link5 seller name;Link5 seller country;Link5 buyer name;Link5 buyer country;Cargo (tons);Capacity (m3);Vessel Id 2;Vessel Id 3;Voyage Id 2;Voyage Id 3;Vessel Name 2;Vessel Name 3;Vessel IMO 2;Vessel IMO 3;Zone STS 1;Zone STS 2;Zone STS Id 1;Zone STS Id 2;Date Start STS 1;Date Start STS 2;Date End STS 1;Date End STS 2;Grade API;Grade Sulfur;Country STS 1;Country STS 2;Vessel DWT;Vessel DWT 2;Vessel DWT 3;Installation STS 1;Installation STS 2;Volume STS 1;Volume STS 2;Cargo Sources;Id (Product)\nFront Sirius;Russian Federation;Primorsk;Primorsk;2020-06-07 09:59;China;Qingdao;;;216816;Dirty;crude/co;crude;Urals;6769585;347892969;348159028;30335687;1271;2474;1585;;Asia;Europe;;;;;;;2020-06-07 09:59;Primorsk;Partial;2020-07-31 05:00;Qingdao;;;;;;;;In Transit;Rosneft;Sinopec;2;;2020-06-05 17:00;2020-06-05 22:58;;AIS;Eastern Asia;2020-07-30 09:00;;121024;Aframax;;100235;9767340;538007337;;;;Spot;Rosneft;Russia;Glencore;Switzerland;;Spot;Glencore;Switzerland;;;;Spot;;;Sinopec;China;;;;;;;;;;;;;30024;121024;84946;;30356146;;New Pioneer;;9486532;;Frederikshavn Light.;;1337;;2020-06-10 18:19;;2020-06-11 05:26;;31.0;2.0;Denmark;;109896;297058;;;;51547.0;;;2342\n"},{"id":"df44dfb7-1267-42a1-9412-c5c2ba7e17d9","name":"Columns id, name, description and deprecation status","originalRequest":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/trades/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"Columns by default\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": \"Product type\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"str\",\n \"columnName\": \"Date (origin)\",\n \"description\": \"Departure date of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_location_name\",\n \"shortId\": \"oln\",\n \"columnName\": \"Origin\",\n \"description\": \"Origin location of the cargo\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_eta_source\",\n \"shortId\": \"oes\",\n \"columnName\": \"Eta source (origin)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Origin information (Port, Analyst, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_reload_sts_partial\",\n \"shortId\": \"ota\",\n \"columnName\": \"Reload STS Partial (origin)\",\n \"description\": \"If field contains 'Partial' = Partial has occurred in this port call. Same logic applies for when “Reload” and 'STS' is returned for Re-loads and Ship-to-Ship transfers\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"Date (destination)\",\n \"description\": \"Arrival date of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_location_name\",\n \"shortId\": \"dln\",\n \"columnName\": \"Destination\",\n \"description\": \"Destination location of the cargo\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_eta_source\",\n \"shortId\": \"des\",\n \"columnName\": \"Eta source (destination)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Destination information (Port, Analyst, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_reload_sts_partial\",\n \"shortId\": \"dta\",\n \"columnName\": \"Reload STS Partial (destination)\",\n \"description\": \"If field contains 'Partial' then Partial has occurred in this port call. Same logic applies for when 'Reload' and 'STS' is returned for Re-loads and Ship-to-Ship transfers.\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_location_name\",\n \"shortId\": \"fdl\",\n \"columnName\": \"Forecasted destination\",\n \"description\": \"Next destination forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_location_eta\",\n \"shortId\": \"fde\",\n \"columnName\": \"Forecasted ETA\",\n \"description\": \"Next destination ETA forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_confidence\",\n \"shortId\": \"fdc\",\n \"columnName\": \"Forecasted confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"status\",\n \"shortId\": \"stt\",\n \"columnName\": \"Trade status\",\n \"description\": \"'Scheduled' = cargo has not been picked up yet. 'In Transit' = cargo is in movement. 'Delivered' = cargo arrived to destination.\",\n \"deprecated\": false\n },\n {\n \"id\": \"initial_seller_name\",\n \"shortId\": \"isn\",\n \"columnName\": \"Seller (origin)\",\n \"description\": \"Company name that sold cargo at the installation of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"final_buyer_name\",\n \"shortId\": \"fbn\",\n \"columnName\": \"Buyer (destination)\",\n \"description\": \"Company name of the buyer at final destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"number_of_intermediaries\",\n \"shortId\": \"noi\",\n \"columnName\": \"Intermediaries\",\n \"description\": \"Number of intermediate players involved in the trade\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_country_name\",\n \"shortId\": \"ocn\",\n \"columnName\": \"Country (origin)\",\n \"description\": \"Name of the origin country\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_subcontinent_name\",\n \"shortId\": \"osn\",\n \"columnName\": \"Subcontinent (origin)\",\n \"description\": \"Subcontinent of trade origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_origin_name\",\n \"shortId\": \"con\",\n \"columnName\": \"Continent Origin\",\n \"description\": \"Continent of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_eta_date\",\n \"shortId\": \"oed\",\n \"columnName\": \"Eta (origin)\",\n \"description\": \"Estimated time of arrival at origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_start\",\n \"shortId\": \"ost\",\n \"columnName\": \"Start (origin)\",\n \"description\": \"Start date of the trip\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_end\",\n \"shortId\": \"oen\",\n \"columnName\": \"End (origin)\",\n \"description\": \"End of the loading process at the origin \",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_country_name\",\n \"shortId\": \"dcn\",\n \"columnName\": \"Country (destination)\",\n \"description\": \"Name of the destination country\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_subcontinent_name\",\n \"shortId\": \"dsn\",\n \"columnName\": \"Subcontinent (destination)\",\n \"description\": \"Subcontinent of trade destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_destination_name\",\n \"shortId\": \"cdn\",\n \"columnName\": \"Continent Destination\",\n \"description\": \"Continent of destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_eta\",\n \"shortId\": \"ded\",\n \"columnName\": \"Eta (destination)\",\n \"description\": \"Estimated time of arrival at destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_start\",\n \"shortId\": \"dsd\",\n \"columnName\": \"Start (destination)\",\n \"description\": \"Start of the discharge process at destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_end\",\n \"shortId\": \"den\",\n \"columnName\": \"End (destination)\",\n \"description\": \"Departure datetime from the destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"vcm\",\n \"columnName\": \"Capacity (vessel m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"vet\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"vct\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_id\",\n \"shortId\": \"tid\",\n \"columnName\": \"Id (Trade)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_origin_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"Zone Origin\",\n \"description\": \"Name of the origin area\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_origin_id\",\n \"shortId\": \"zoi\",\n \"columnName\": \"Zone Origin Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_destination_name\",\n \"shortId\": \"zdn\",\n \"columnName\": \"Zone Destination\",\n \"description\": \"Name of the destination area\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_destination_id\",\n \"shortId\": \"zdi\",\n \"columnName\": \"Zone Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_origin_name\",\n \"shortId\": \"ion\",\n \"columnName\": \"Installation origin\",\n \"description\": \"Name of the origin installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_origin_id\",\n \"shortId\": \"ioi\",\n \"columnName\": \"Installation origin id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_destination_name\",\n \"shortId\": \"idn\",\n \"columnName\": \"Installation Destination\",\n \"description\": \"Name of the destination installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_destination_id\",\n \"shortId\": \"idi\",\n \"columnName\": \"Installation Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"mileage_nautical_miles\",\n \"shortId\": \"mnm\",\n \"columnName\": \"Mileage\",\n \"description\": \"Distance between origin and destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"ton_miles\",\n \"shortId\": \"tom\",\n \"columnName\": \"Ton Miles\",\n \"description\": \"Ton/mile report\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (Voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n }\n ],\n \"Optional Columns\": [\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_sources\",\n \"shortId\": \"cargo_sources\",\n \"columnName\": \"Cargo Sources\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"charterer_name\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current Controller of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_1\",\n \"shortId\": \"stco1\",\n \"columnName\": \"Country STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_2\",\n \"shortId\": \"stco2\",\n \"columnName\": \"Country STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_3\",\n \"shortId\": \"stco3\",\n \"columnName\": \"Country STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date1\",\n \"shortId\": \"sted1\",\n \"columnName\": \"Date End STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date2\",\n \"shortId\": \"sted2\",\n \"columnName\": \"Date End STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date3\",\n \"shortId\": \"sted3\",\n \"columnName\": \"Date End STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_1\",\n \"shortId\": \"stsd1\",\n \"columnName\": \"Date Start STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_2\",\n \"shortId\": \"stsd2\",\n \"columnName\": \"Date Start STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_3\",\n \"shortId\": \"stsd3\",\n \"columnName\": \"Date Start STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_destination_id\",\n \"shortId\": \"pcdid\",\n \"columnName\": \"Destination PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"export_price\",\n \"shortId\": \"epr\",\n \"columnName\": \"Export price\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_location_name\",\n \"shortId\": \"fol\",\n \"columnName\": \"Forecasted origin\",\n \"description\": \"Next origin forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_eta\",\n \"shortId\": \"foe\",\n \"columnName\": \"Forecasted origin ETA\",\n \"description\": \"Next origin ETA forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_confidence\",\n \"shortId\": \"foc\",\n \"columnName\": \"Forecasted origin confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulfur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"product_id\",\n \"shortId\": \"proid\",\n \"columnName\": \"Id (Product)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"import_price\",\n \"shortId\": \"ipr\",\n \"columnName\": \"Import price\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_1\",\n \"shortId\": \"stsi1\",\n \"columnName\": \"Installation STS 1\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_2\",\n \"shortId\": \"stsi2\",\n \"columnName\": \"Installation STS 2\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_3\",\n \"shortId\": \"stsi3\",\n \"columnName\": \"Installation STS 3\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_buyer_country_name\",\n \"shortId\": \"b1c\",\n \"columnName\": \"Link1 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_buyer_name\",\n \"shortId\": \"n1b\",\n \"columnName\": \"Link1 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_delivery\",\n \"shortId\": \"t1d\",\n \"columnName\": \"Link1 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_seller_country_name\",\n \"shortId\": \"s1c\",\n \"columnName\": \"Link1 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_seller_name\",\n \"shortId\": \"s1n\",\n \"columnName\": \"Link1 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_type\",\n \"shortId\": \"t1t\",\n \"columnName\": \"Link1 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_buyer_country_name\",\n \"shortId\": \"b2c\",\n \"columnName\": \"Link2 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_buyer_name\",\n \"shortId\": \"n2b\",\n \"columnName\": \"Link2 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_delivery\",\n \"shortId\": \"t2d\",\n \"columnName\": \"Link2 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_seller_country_name\",\n \"shortId\": \"s2c\",\n \"columnName\": \"Link2 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_seller_name\",\n \"shortId\": \"s2n\",\n \"columnName\": \"Link2 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_type\",\n \"shortId\": \"t2t\",\n \"columnName\": \"Link2 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_buyer_country_name\",\n \"shortId\": \"b3c\",\n \"columnName\": \"Link3 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_buyer_name\",\n \"shortId\": \"n3b\",\n \"columnName\": \"Link3 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_delivery\",\n \"shortId\": \"t3d\",\n \"columnName\": \"Link3 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_seller_country_name\",\n \"shortId\": \"s3c\",\n \"columnName\": \"Link3 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_seller_name\",\n \"shortId\": \"s3n\",\n \"columnName\": \"Link3 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_type\",\n \"shortId\": \"t3t\",\n \"columnName\": \"Link3 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_buyer_country_name\",\n \"shortId\": \"b4c\",\n \"columnName\": \"Link4 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_buyer_name\",\n \"shortId\": \"n4b\",\n \"columnName\": \"Link4 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_delivery\",\n \"shortId\": \"t4d\",\n \"columnName\": \"Link4 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_seller_country_name\",\n \"shortId\": \"s4c\",\n \"columnName\": \"Link4 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_seller_name\",\n \"shortId\": \"s4n\",\n \"columnName\": \"Link4 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_type\",\n \"shortId\": \"t4t\",\n \"columnName\": \"Link4 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_buyer_country_name\",\n \"shortId\": \"b5c\",\n \"columnName\": \"Link5 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_buyer_name\",\n \"shortId\": \"n5b\",\n \"columnName\": \"Link5 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_delivery\",\n \"shortId\": \"t5d\",\n \"columnName\": \"Link5 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_seller_country_name\",\n \"shortId\": \"s5c\",\n \"columnName\": \"Link5 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_seller_name\",\n \"shortId\": \"s5n\",\n \"columnName\": \"Link5 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_type\",\n \"shortId\": \"t5t\",\n \"columnName\": \"Link5 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"msi\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"export_number_of_trades\",\n \"shortId\": \"ent\",\n \"columnName\": \"Number of trades (export)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"import_number_of_trades\",\n \"shortId\": \"int\",\n \"columnName\": \"Number of trades (import)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_origin_id\",\n \"shortId\": \"pcoid\",\n \"columnName\": \"Origin PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_1\",\n \"shortId\": \"dwt1\",\n \"columnName\": \"Vessel DWT\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_2\",\n \"shortId\": \"dwt2\",\n \"columnName\": \"Vessel DWT 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_3\",\n \"shortId\": \"dwt3\",\n \"columnName\": \"Vessel DWT 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_4\",\n \"shortId\": \"dwt4\",\n \"columnName\": \"Vessel DWT 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_2\",\n \"shortId\": \"imo2\",\n \"columnName\": \"Vessel IMO 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_3\",\n \"shortId\": \"imo3\",\n \"columnName\": \"Vessel IMO 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_4\",\n \"shortId\": \"imo4\",\n \"columnName\": \"Vessel IMO 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_2\",\n \"shortId\": \"vid2\",\n \"columnName\": \"Vessel Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_3\",\n \"shortId\": \"vid3\",\n \"columnName\": \"Vessel Id 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_4\",\n \"shortId\": \"vid4\",\n \"columnName\": \"Vessel Id 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_2\",\n \"shortId\": \"ven2\",\n \"columnName\": \"Vessel Name 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_3\",\n \"shortId\": \"ven3\",\n \"columnName\": \"Vessel Name 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_4\",\n \"shortId\": \"ven4\",\n \"columnName\": \"Vessel Name 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_1\",\n \"shortId\": \"stsv1\",\n \"columnName\": \"Volume STS 1\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_2\",\n \"shortId\": \"stsv2\",\n \"columnName\": \"Volume STS 2\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_3\",\n \"shortId\": \"stsv3\",\n \"columnName\": \"Volume STS 3\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_2\",\n \"shortId\": \"voyage_id_2\",\n \"columnName\": \"Voyage Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_3\",\n \"shortId\": \"voyage_id_3\",\n \"columnName\": \"Voyage Id 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_4\",\n \"shortId\": \"voyage_id_4\",\n \"columnName\": \"Voyage Id 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"zone_canal_transit\",\n \"shortId\": \"zct\",\n \"columnName\": \"Zone Canal Transit\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_1\",\n \"shortId\": \"st1\",\n \"columnName\": \"Zone STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_2\",\n \"shortId\": \"st2\",\n \"columnName\": \"Zone STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_3\",\n \"shortId\": \"st3\",\n \"columnName\": \"Zone STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_1_id\",\n \"shortId\": \"stzid1\",\n \"columnName\": \"Zone STS Id 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_2_id\",\n \"shortId\": \"stzid2\",\n \"columnName\": \"Zone STS Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_3_id\",\n \"shortId\": \"stzid3\",\n \"columnName\": \"Zone STS Id 3\",\n \"description\": null,\n \"deprecated\": false\n }\n ]\n}"}],"_postman_id":"d14e1116-e0b9-483c-b730-48da8b921c1f"},{"name":"/v1/trades/columns","event":[{"listen":"test","script":{"id":"45357501-e865-4575-93a1-03e1f674cba6","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"6dbc685c-7e4f-453b-969e-879642f01de7","exec":[""],"type":"text/javascript"}}],"id":"543df877-f14d-4351-a7b1-0da7c7d3be3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"Required [String]: application/json or text/json
\n","type":"text"}],"body":{"mode":"raw","raw":"[\n \"destination_eta_source\",\n \"status\",\n \"initial_seller_name\"\n]"},"url":"{{HOST_URL}}/v1/trades/columns","description":"What is {{HOST_URL}} and where do we find it?
\nTo prevent breaking changes, we strongly recommend you to not use the “all” or the default value for the 'column’ parameter as these may occasionally change.
\nTherefore we have added this endpoint which allows you to get a hash code for the set of columns that you wish to add on your query.
\nNote: The set of columns defined with the hash code will never change and will always remain the same.
\nIn this example, we have created a hash code that will always return the following columns:
\nRequired [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"description":"Required [String]: application/json or text/json
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"https://api.kpler.com/v1/trades/columns","description":"What is {{HOST_URL}} and where do we find it?
\nThis endpoint returns a recent and updated list of all columns available for the endpoint trades.
\n","urlObject":{"protocol":"https","path":["v1","trades","columns"],"host":["api","kpler","com"],"query":[],"variable":[]}},"response":[{"id":"3f7e2a80-324e-43b5-b2eb-f94992eb5ba7","name":"List of all columns","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"description":"**Required [String]**: **application/json** or **text/json**","key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"https://api.kpler.com/v1/trades/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"selected\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": \"Product type\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"start\",\n \"shortId\": \"str\",\n \"columnName\": \"Date (origin)\",\n \"description\": \"Departure date of the vessel\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"origin_location_name\",\n \"shortId\": \"oln\",\n \"columnName\": \"Origin\",\n \"description\": \"Origin location of the cargo\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"origin_eta_source\",\n \"shortId\": \"oes\",\n \"columnName\": \"Eta source (origin)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Origin information (Port, Analyst, etc.)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"origin_reload_sts_partial\",\n \"shortId\": \"ota\",\n \"columnName\": \"Reload STS Partial (origin)\",\n \"description\": \"If field contains 'Partial' = Partial has occurred in this port call. Same logic applies for when “Reload” and 'STS' is returned for Re-loads and Ship-to-Ship transfers\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"Date (destination)\",\n \"description\": \"Arrival date of the vessel\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"destination_location_name\",\n \"shortId\": \"dln\",\n \"columnName\": \"Destination\",\n \"description\": \"Destination location of the cargo\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"destination_eta_source\",\n \"shortId\": \"des\",\n \"columnName\": \"Eta source (destination)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Destination information (Port, Analyst, etc.)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"destination_reload_sts_partial\",\n \"shortId\": \"dta\",\n \"columnName\": \"Reload STS Partial (destination)\",\n \"description\": \"If field contains 'Partial' then Partial has occurred in this port call. Same logic applies for when 'Reload' and 'STS' is returned for Re-loads and Ship-to-Ship transfers.\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"next_forecasted_destination_location_name\",\n \"shortId\": \"fdl\",\n \"columnName\": \"Forecasted destination\",\n \"description\": \"Next destination forecasted\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"next_forecasted_destination_location_eta\",\n \"shortId\": \"fde\",\n \"columnName\": \"Forecasted ETA\",\n \"description\": \"Next destination ETA forecasted\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"next_forecasted_destination_confidence\",\n \"shortId\": \"fdc\",\n \"columnName\": \"Forecasted confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"status\",\n \"shortId\": \"stt\",\n \"columnName\": \"Trade status\",\n \"description\": \"'Scheduled' = cargo has not been picked up yet. 'In Transit' = cargo is in movement. 'Delivered' = cargo arrived to destination.\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"initial_seller_name\",\n \"shortId\": \"isn\",\n \"columnName\": \"Seller (origin)\",\n \"description\": \"Company name that sold cargo at the installation of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"final_buyer_name\",\n \"shortId\": \"fbn\",\n \"columnName\": \"Buyer (destination)\",\n \"description\": \"Company name of the buyer at final destination\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"number_of_intermediaries\",\n \"shortId\": \"noi\",\n \"columnName\": \"Intermediaries\",\n \"description\": \"Number of intermediate players involved in the trade\",\n \"deprecated\": false,\n \"type\": \"integer\"\n },\n {\n \"id\": \"origin_country_name\",\n \"shortId\": \"ocn\",\n \"columnName\": \"Country (origin)\",\n \"description\": \"Name of the origin country\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"origin_subcontinent_name\",\n \"shortId\": \"osn\",\n \"columnName\": \"Subcontinent (origin)\",\n \"description\": \"Subcontinent of trade origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"continent_origin_name\",\n \"shortId\": \"con\",\n \"columnName\": \"Continent Origin\",\n \"description\": \"Continent of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"origin_eta_date\",\n \"shortId\": \"oed\",\n \"columnName\": \"Eta (origin)\",\n \"description\": \"Estimated time of arrival at origin\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"origin_start\",\n \"shortId\": \"ost\",\n \"columnName\": \"Start (origin)\",\n \"description\": \"Start date of the trip\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"origin_end\",\n \"shortId\": \"oen\",\n \"columnName\": \"End (origin)\",\n \"description\": \"End of the loading process at the origin \",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"destination_country_name\",\n \"shortId\": \"dcn\",\n \"columnName\": \"Country (destination)\",\n \"description\": \"Name of the destination country\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"destination_subcontinent_name\",\n \"shortId\": \"dsn\",\n \"columnName\": \"Subcontinent (destination)\",\n \"description\": \"Subcontinent of trade destination\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"continent_destination_name\",\n \"shortId\": \"cdn\",\n \"columnName\": \"Continent Destination\",\n \"description\": \"Continent of destination\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"destination_eta\",\n \"shortId\": \"ded\",\n \"columnName\": \"Eta (destination)\",\n \"description\": \"Estimated time of arrival at destination\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"destination_start\",\n \"shortId\": \"dsd\",\n \"columnName\": \"Start (destination)\",\n \"description\": \"Start of the discharge process at destination\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"destination_end\",\n \"shortId\": \"den\",\n \"columnName\": \"End (destination)\",\n \"description\": \"Departure datetime from the destination\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"vcm\",\n \"columnName\": \"Capacity (vessel m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"vet\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of the vessel 1\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"vct\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"trade_id\",\n \"shortId\": \"tid\",\n \"columnName\": \"Id (Trade)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"zone_origin_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"Zone Origin\",\n \"description\": \"Name of the origin area\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"zone_origin_id\",\n \"shortId\": \"zoi\",\n \"columnName\": \"Zone Origin Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"zone_destination_name\",\n \"shortId\": \"zdn\",\n \"columnName\": \"Zone Destination\",\n \"description\": \"Name of the destination area\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"zone_destination_id\",\n \"shortId\": \"zdi\",\n \"columnName\": \"Zone Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"installation_origin_name\",\n \"shortId\": \"ion\",\n \"columnName\": \"Installation origin\",\n \"description\": \"Name of the origin installation\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"installation_origin_id\",\n \"shortId\": \"ioi\",\n \"columnName\": \"Installation origin id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"installation_destination_name\",\n \"shortId\": \"idn\",\n \"columnName\": \"Installation Destination\",\n \"description\": \"Name of the destination installation\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"installation_destination_id\",\n \"shortId\": \"idi\",\n \"columnName\": \"Installation Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"mileage_nautical_miles\",\n \"shortId\": \"mnm\",\n \"columnName\": \"Mileage\",\n \"description\": \"Distance between origin and destination\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"ton_miles\",\n \"shortId\": \"tom\",\n \"columnName\": \"Ton Miles\",\n \"description\": \"Ton/mile report\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (Voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"string\"\n }\n ],\n \"unselected\": [\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"cargo_sources\",\n \"shortId\": \"cargo_sources\",\n \"columnName\": \"Cargo Sources\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"charterer_name\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current Controller of the vessel\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_country_1\",\n \"shortId\": \"stco1\",\n \"columnName\": \"Country STS 1\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_country_2\",\n \"shortId\": \"stco2\",\n \"columnName\": \"Country STS 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_country_3\",\n \"shortId\": \"stco3\",\n \"columnName\": \"Country STS 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_end_date1\",\n \"shortId\": \"sted1\",\n \"columnName\": \"Date End STS 1\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"super_trade_end_date2\",\n \"shortId\": \"sted2\",\n \"columnName\": \"Date End STS 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"super_trade_end_date3\",\n \"shortId\": \"sted3\",\n \"columnName\": \"Date End STS 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"super_trade_start_date_1\",\n \"shortId\": \"stsd1\",\n \"columnName\": \"Date Start STS 1\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"super_trade_start_date_2\",\n \"shortId\": \"stsd2\",\n \"columnName\": \"Date Start STS 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"super_trade_start_date_3\",\n \"shortId\": \"stsd3\",\n \"columnName\": \"Date Start STS 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"port_call_destination_id\",\n \"shortId\": \"pcdid\",\n \"columnName\": \"Destination PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"product_confidence\",\n \"shortId\": \"product_confidence\",\n \"columnName\": \"Estimated Product - Confidence\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"integer\"\n },\n {\n \"id\": \"products_confidences\",\n \"shortId\": \"products_confidences\",\n \"columnName\": \"Estimated Products - Confidences\",\n \"description\": \"Confidence (in %)\",\n \"deprecated\": false,\n \"type\": \"list of integer\"\n },\n {\n \"id\": \"products_estimated\",\n \"shortId\": \"products_estimated\",\n \"columnName\": \"Estimated products\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"list of string\"\n },\n {\n \"id\": \"export_price\",\n \"shortId\": \"epr\",\n \"columnName\": \"Export price\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"next_forecasted_origin_location_name\",\n \"shortId\": \"fol\",\n \"columnName\": \"Forecasted origin\",\n \"description\": \"Next origin forecasted\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"next_forecasted_origin_eta\",\n \"shortId\": \"foe\",\n \"columnName\": \"Forecasted origin ETA\",\n \"description\": \"Next origin ETA forecasted\",\n \"deprecated\": false,\n \"type\": \"datetime yyyy-MM-dd HH:mm\"\n },\n {\n \"id\": \"next_forecasted_origin_confidence\",\n \"shortId\": \"foc\",\n \"columnName\": \"Forecasted origin confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false,\n \"type\": \"float\"\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulfur grade of the product\",\n \"deprecated\": false,\n \"type\": \"float\"\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"product_id\",\n \"shortId\": \"proid\",\n \"columnName\": \"Id (Product)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"shipment_id\",\n \"shortId\": \"shipmtid\",\n \"columnName\": \"Id (Shipment)\",\n \"description\": \"Shipment Id in the database\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"import_price\",\n \"shortId\": \"ipr\",\n \"columnName\": \"Import price\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"ship_to_ship_installation_1\",\n \"shortId\": \"stsi1\",\n \"columnName\": \"Installation STS 1\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"ship_to_ship_installation_2\",\n \"shortId\": \"stsi2\",\n \"columnName\": \"Installation STS 2\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"ship_to_ship_installation_3\",\n \"shortId\": \"stsi3\",\n \"columnName\": \"Installation STS 3\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_1_buyer_country_name\",\n \"shortId\": \"b1c\",\n \"columnName\": \"Link1 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_1_buyer_name\",\n \"shortId\": \"n1b\",\n \"columnName\": \"Link1 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_1_delivery\",\n \"shortId\": \"t1d\",\n \"columnName\": \"Link1 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_1_seller_country_name\",\n \"shortId\": \"s1c\",\n \"columnName\": \"Link1 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_1_seller_name\",\n \"shortId\": \"s1n\",\n \"columnName\": \"Link1 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_1_type\",\n \"shortId\": \"t1t\",\n \"columnName\": \"Link1 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_2_buyer_country_name\",\n \"shortId\": \"b2c\",\n \"columnName\": \"Link2 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_2_buyer_name\",\n \"shortId\": \"n2b\",\n \"columnName\": \"Link2 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_2_delivery\",\n \"shortId\": \"t2d\",\n \"columnName\": \"Link2 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_2_seller_country_name\",\n \"shortId\": \"s2c\",\n \"columnName\": \"Link2 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_2_seller_name\",\n \"shortId\": \"s2n\",\n \"columnName\": \"Link2 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_2_type\",\n \"shortId\": \"t2t\",\n \"columnName\": \"Link2 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_3_buyer_country_name\",\n \"shortId\": \"b3c\",\n \"columnName\": \"Link3 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_3_buyer_name\",\n \"shortId\": \"n3b\",\n \"columnName\": \"Link3 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_3_delivery\",\n \"shortId\": \"t3d\",\n \"columnName\": \"Link3 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_3_seller_country_name\",\n \"shortId\": \"s3c\",\n \"columnName\": \"Link3 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_3_seller_name\",\n \"shortId\": \"s3n\",\n \"columnName\": \"Link3 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_3_type\",\n \"shortId\": \"t3t\",\n \"columnName\": \"Link3 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_4_buyer_country_name\",\n \"shortId\": \"b4c\",\n \"columnName\": \"Link4 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_4_buyer_name\",\n \"shortId\": \"n4b\",\n \"columnName\": \"Link4 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_4_delivery\",\n \"shortId\": \"t4d\",\n \"columnName\": \"Link4 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_4_seller_country_name\",\n \"shortId\": \"s4c\",\n \"columnName\": \"Link4 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_4_seller_name\",\n \"shortId\": \"s4n\",\n \"columnName\": \"Link4 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_4_type\",\n \"shortId\": \"t4t\",\n \"columnName\": \"Link4 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_5_buyer_country_name\",\n \"shortId\": \"b5c\",\n \"columnName\": \"Link5 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_5_buyer_name\",\n \"shortId\": \"n5b\",\n \"columnName\": \"Link5 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_5_delivery\",\n \"shortId\": \"t5d\",\n \"columnName\": \"Link5 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_5_seller_country_name\",\n \"shortId\": \"s5c\",\n \"columnName\": \"Link5 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_5_seller_name\",\n \"shortId\": \"s5n\",\n \"columnName\": \"Link5 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"trade_link_5_type\",\n \"shortId\": \"t5t\",\n \"columnName\": \"Link5 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"msi\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"export_number_of_trades\",\n \"shortId\": \"ent\",\n \"columnName\": \"Number of trades (export)\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"import_number_of_trades\",\n \"shortId\": \"int\",\n \"columnName\": \"Number of trades (import)\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"port_call_origin_id\",\n \"shortId\": \"pcoid\",\n \"columnName\": \"Origin PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"parent_shipment_id\",\n \"shortId\": \"pshipmtid\",\n \"columnName\": \"Parent Id (Shipment)\",\n \"description\": \"Parent shipment Id in the database\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_dwt_1\",\n \"shortId\": \"dwt1\",\n \"columnName\": \"Vessel DWT\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_dwt_2\",\n \"shortId\": \"dwt2\",\n \"columnName\": \"Vessel DWT 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_dwt_3\",\n \"shortId\": \"dwt3\",\n \"columnName\": \"Vessel DWT 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_dwt_4\",\n \"shortId\": \"dwt4\",\n \"columnName\": \"Vessel DWT 4\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_imo_2\",\n \"shortId\": \"imo2\",\n \"columnName\": \"Vessel IMO 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_imo_3\",\n \"shortId\": \"imo3\",\n \"columnName\": \"Vessel IMO 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_imo_4\",\n \"shortId\": \"imo4\",\n \"columnName\": \"Vessel IMO 4\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_id_2\",\n \"shortId\": \"vid2\",\n \"columnName\": \"Vessel Id 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_id_3\",\n \"shortId\": \"vid3\",\n \"columnName\": \"Vessel Id 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_id_4\",\n \"shortId\": \"vid4\",\n \"columnName\": \"Vessel Id 4\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"vessel_name_2\",\n \"shortId\": \"ven2\",\n \"columnName\": \"Vessel Name 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_name_3\",\n \"shortId\": \"ven3\",\n \"columnName\": \"Vessel Name 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_name_4\",\n \"shortId\": \"ven4\",\n \"columnName\": \"Vessel Name 4\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type2\",\n \"shortId\": \"vet2\",\n \"columnName\": \"Vessel Type 2\",\n \"description\": \"Type of the vessel 2\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type3\",\n \"shortId\": \"vet3\",\n \"columnName\": \"Vessel Type 3\",\n \"description\": \"Type of the vessel 3\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type4\",\n \"shortId\": \"vet4\",\n \"columnName\": \"Vessel Type 4\",\n \"description\": \"Type of the vessel 4\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type_alt\",\n \"shortId\": \"vst_alt\",\n \"columnName\": \"Vessel Type Alternative \",\n \"description\": \"Type of the vessel 1 in the Oil classification (Product Tanker, Panamax, Aframax, Suezmax, VLCC, ULCC)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type_alt2\",\n \"shortId\": \"vst_alt2\",\n \"columnName\": \"Vessel Type Alternative 2\",\n \"description\": \"Type of the vessel 2 in the Oil classification (Product Tanker, Panamax, Aframax, Suezmax, VLCC, ULCC)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type_alt3\",\n \"shortId\": \"vst_alt3\",\n \"columnName\": \"Vessel Type Alternative 3\",\n \"description\": \"Type of the vessel 3 in the Oil classification (Product Tanker, Panamax, Aframax, Suezmax, VLCC, ULCC)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"vessel_type_alt4\",\n \"shortId\": \"vst_alt4\",\n \"columnName\": \"Vessel Type Alternative 4\",\n \"description\": \"Type of the vessel 4 in the Oil classification (Product Tanker, Panamax, Aframax, Suezmax, VLCC, ULCC)\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"ship_to_ship_volume_1\",\n \"shortId\": \"stsv1\",\n \"columnName\": \"Volume STS 1\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"ship_to_ship_volume_2\",\n \"shortId\": \"stsv2\",\n \"columnName\": \"Volume STS 2\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"ship_to_ship_volume_3\",\n \"shortId\": \"stsv3\",\n \"columnName\": \"Volume STS 3\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"voyage_id_2\",\n \"shortId\": \"voyage_id_2\",\n \"columnName\": \"Voyage Id 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"voyage_id_3\",\n \"shortId\": \"voyage_id_3\",\n \"columnName\": \"Voyage Id 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"voyage_id_4\",\n \"shortId\": \"voyage_id_4\",\n \"columnName\": \"Voyage Id 4\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"zone_canal_transit\",\n \"shortId\": \"zct\",\n \"columnName\": \"Zone Canal Transit\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_zone_1\",\n \"shortId\": \"st1\",\n \"columnName\": \"Zone STS 1\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_zone_2\",\n \"shortId\": \"st2\",\n \"columnName\": \"Zone STS 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_zone_3\",\n \"shortId\": \"st3\",\n \"columnName\": \"Zone STS 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"super_trade_zone_1_id\",\n \"shortId\": \"stzid1\",\n \"columnName\": \"Zone STS Id 1\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"super_trade_zone_2_id\",\n \"shortId\": \"stzid2\",\n \"columnName\": \"Zone STS Id 2\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"super_trade_zone_3_id\",\n \"shortId\": \"stzid3\",\n \"columnName\": \"Zone STS Id 3\",\n \"description\": null,\n \"deprecated\": false,\n \"type\": \"long\"\n }\n ]\n}"}],"_postman_id":"99d9aac4-da0a-4e52-8ef3-c8fb48691e8d"},{"name":"/v1/trades/snapshot","event":[{"listen":"test","script":{"id":"3d8b9b2d-e1e4-4f67-80d3-afa9222329f7","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"a6202481-7d54-4275-94d2-3ffd06f08985","exec":[""],"type":"text/javascript"}}],"id":"631ee3c1-9b11-4ebc-8175-d77f6c25048a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/trades/snapshot?snapshotDate={{date}}&vessels={{vessels}}&fromInstallations={{fromInstallations}}&toInstallations={{toInstallations}}&fromZones={{fromZones}}&toZones={{toZones}}&buyers={{buyers}}&sellers={{sellers}}&products={{products}}&startDate={{startDate}}&endDate={{endDate}}&tradeStatus={{tradeStatus}}&columns={{columns}}&hash={{hash}}","description":"https://api.kpler.com/Provides the last snapshot of all trades. The snapshot is a result of getTrades for all zones, vessels, and products, overall the history.
\nThis endpoint's main purpose is to be used as initialization of a local data store (or data lake /warehouse). After the data store has been set up, trade updates endpoint /v1/trades/updates provides daily deltas (see next section for more details).
\nIt allows users to view the state of the trades at a specific point in time.
\nThe snapshots are stored on an hourly basis since September 2020 (2020-09-21T200000), the date of the first snapshot can vary depending on the commodity queried. This is an add on feature, please reach out to your Account Manager for more details.
\nIf you want to use point-in-time data, you need to specify the snapshotDate parameter. The snapshotDate parameter is a date in the format YYYY-MM-DD that specifies the date for which you want to retrieve data. For example, to retrieve data for January 1, 2023, you would specify snapshotDate=2023-01-01.
It must be run at least once, for the initialization, before using /v1/trades/updates. Once the initialization step has been performed, /v1/trades/updates can be used alone.
\nIn addition to the body response, a header lastAvailableDate is returned. It must be used as the startDate parameter for /v1/trades/updates endpoint.
NOTE:
\n/v1/trades/updates endpoint.What is the difference between getTrades and Snapshot?
\nThe snapshot is a result of the getTrades endpoint (see previous section on /v1/trades for more details). The only difference is that getTrades retrieves all trades available at that moment. The Snapshot, however, returns the trades with a small delay (less than 1 hour).
\n![](\"https://kp-prod-public-content.s3-eu-west-1.amazonaws.com/doc/trades_snapshot.gif\")
","urlObject":{"protocol":"https","path":["v1","trades","snapshot"],"host":["api","kpler","com"],"query":[{"description":{"content":"Format Date : YYYY-MM-DDTHHMMSS, if empty it's returning the last snapshot
\n","type":"text/plain"},"key":"snapshotDate","value":"{{date}}"},{"description":{"content":"Optional [String]: Names/IMO's of vessels
\n","type":"text/plain"},"key":"vessels","value":"{{vessels}}"},{"description":{"content":"Optional [String]: Names of the origin installations
\n","type":"text/plain"},"key":"fromInstallations","value":"{{fromInstallations}}"},{"description":{"content":"Optional [String]: Names of the destination installations (terminal/refinery)
\n","type":"text/plain"},"key":"toInstallations","value":"{{toInstallations}}"},{"description":{"content":"Optional [String]: Names of the origin zones (port/region/country/continent)
\n","type":"text/plain"},"key":"fromZones","value":"{{fromZones}}"},{"description":{"content":"Optional [String]: Names of the destination zones (port/region/country/continent)
\n","type":"text/plain"},"key":"toZones","value":"{{toZones}}"},{"description":{"content":"Optional [String]: Buyers of the cargo
\n","type":"text/plain"},"key":"buyers","value":"{{buyers}}"},{"description":{"content":"Optional [String]: Sellers of the cargo
\n","type":"text/plain"},"key":"sellers","value":"{{sellers}}"},{"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Return only trades of a particular status [“delivered”, ”loading”, ”in transit”, ”scheduled”]. By default value is scheduled.
\n","type":"text/plain"},"key":"tradeStatus","value":"{{tradeStatus}}"},{"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the POST /v1/trades/columnsendpoint to learn more about how to generate the hash code )
\nNote: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"}],"variable":[]}},"response":[{"id":"79160b18-405e-41aa-92dc-d08168b4b6c0","name":"Liquids - Get trades snapshot","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/trades/snapshot"},"_postman_previewlanguage":null,"header":[{"key":"lastAvailableDate","value":"2020-10-27T140100","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"Vessel;Volume (bbl);Grade;Product;Group;Family;Date (origin);Origin;Eta source (origin);Reload STS Partial (origin);Date (destination);Destination;Eta source (destination);Reload STS Partial (destination);Forecasted destination;Forecasted ETA;Forecasted confidence;Trade status;Seller (origin);Buyer (destination);Intermediaries;Country (origin);Subcontinent (origin);Continent Origin;Eta (origin);Start (origin);End (origin);Country (destination);Subcontinent (destination);Continent Destination;Eta (destination);Start (destination);End (destination);Capacity (vessel m3);Vessel type;Cargo type (vessel);Id (vessel);Id (Trade);Zone Origin;Zone Origin Id;Zone Destination;Zone Destination Id;Installation origin;Installation origin id;Installation Destination;Installation Destination Id;Mileage;Ton Miles;Id (Voyage);Id (Product)\nAdvantage Party;259681;ULSD;Diesel;Gasoil/Diesel;Middle Distillates;2020-09-17 08:01;Vysotsk;;;2020-10-18 16:01;La Rochelle;;;;;;Delivered;Lukoil;Picoty;1;Russian Federation;;Europe;2020-09-22 06:15;2020-09-15 23:13;2020-09-17 08:01;France;Western Europe;Europe;2020-10-18 04:30;2020-10-18 16:01;2020-10-21 14:59;41915;MR;;76132;7899260;Vysotsk;2604;La Rochelle;1501;Vysotsk;1590;La Rochelle;2072;2612;90918741;30879910;2326\nAdeline;90761;;Gasoline;Gasoline/Naphtha;Light Ends;2020-09-17 07:43;Oiltank. Star Energy;;;2020-10-02 17:21;Mukalla;;;;;;Delivered;Star Energy Group;Yemen Oil & Gas;1;United Arab Emirates;Middle East;Asia;2020-09-21 18:15;2020-09-15 18:44;2020-09-17 07:43;Yemen;Middle East;Asia;;2020-10-02 17:21;2020-10-03 14:49;14650;GP;;68559;7824091;Jebel Ali;1120;Mukalla Port;3255;Oiltank. Star Energy;1843;Mukalla;2380;1313;14271717;30919582;1534\nLahore;717396;Das;crude;crude/co;Dirty;2020-09-17 07:31;Das Island;;;2020-09-21 10:26;Karachi Keamari;;;;;;Delivered;ExxonMobil,ADNOC;PSO;1;United Arab Emirates;Middle East;Asia;;2020-09-16 16:14;2020-09-17 07:31;Pakistan;South-Central Asia;Asia;2020-09-27 00:15;2020-09-21 10:26;2020-09-23 09:21;115794;LR2;;72754;7870516;Das Island;1117;Karachi;1342;Das Island;1348;Karachi Keamari;1732;833;78806606;30912634;1388\n(truncated response)"},{"id":"c2642191-e530-4406-9b7a-ee7f705f8867","name":"Columns id, name, description and deprecation status","originalRequest":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/trades/snapshot/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"Columns by default\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": \"Product type\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"str\",\n \"columnName\": \"Date (origin)\",\n \"description\": \"Departure date of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_location_name\",\n \"shortId\": \"oln\",\n \"columnName\": \"Origin\",\n \"description\": \"Origin location of the cargo\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_eta_source\",\n \"shortId\": \"oes\",\n \"columnName\": \"Eta source (origin)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Origin information (Port, Analyst, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_reload_sts_partial\",\n \"shortId\": \"ota\",\n \"columnName\": \"Reload STS Partial (origin)\",\n \"description\": \"If field contains 'Partial' = Partial has occurred in this port call. Same logic applies for when “Reload” and 'STS' is returned for Re-loads and Ship-to-Ship transfers\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"Date (destination)\",\n \"description\": \"Arrival date of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_location_name\",\n \"shortId\": \"dln\",\n \"columnName\": \"Destination\",\n \"description\": \"Destination location of the cargo\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_eta_source\",\n \"shortId\": \"des\",\n \"columnName\": \"Eta source (destination)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Destination information (Port, Analyst, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_reload_sts_partial\",\n \"shortId\": \"dta\",\n \"columnName\": \"Reload STS Partial (destination)\",\n \"description\": \"If field contains 'Partial' then Partial has occurred in this port call. Same logic applies for when 'Reload' and 'STS' is returned for Re-loads and Ship-to-Ship transfers.\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_location_name\",\n \"shortId\": \"fdl\",\n \"columnName\": \"Forecasted destination\",\n \"description\": \"Next destination forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_location_eta\",\n \"shortId\": \"fde\",\n \"columnName\": \"Forecasted ETA\",\n \"description\": \"Next destination ETA forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_confidence\",\n \"shortId\": \"fdc\",\n \"columnName\": \"Forecasted confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"status\",\n \"shortId\": \"stt\",\n \"columnName\": \"Trade status\",\n \"description\": \"'Scheduled' = cargo has not been picked up yet. 'In Transit' = cargo is in movement. 'Delivered' = cargo arrived to destination.\",\n \"deprecated\": false\n },\n {\n \"id\": \"initial_seller_name\",\n \"shortId\": \"isn\",\n \"columnName\": \"Seller (origin)\",\n \"description\": \"Company name that sold cargo at the installation of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"final_buyer_name\",\n \"shortId\": \"fbn\",\n \"columnName\": \"Buyer (destination)\",\n \"description\": \"Company name of the buyer at final destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"number_of_intermediaries\",\n \"shortId\": \"noi\",\n \"columnName\": \"Intermediaries\",\n \"description\": \"Number of intermediate players involved in the trade\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_country_name\",\n \"shortId\": \"ocn\",\n \"columnName\": \"Country (origin)\",\n \"description\": \"Name of the origin country\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_subcontinent_name\",\n \"shortId\": \"osn\",\n \"columnName\": \"Subcontinent (origin)\",\n \"description\": \"Subcontinent of trade origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_origin_name\",\n \"shortId\": \"con\",\n \"columnName\": \"Continent Origin\",\n \"description\": \"Continent of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_eta_date\",\n \"shortId\": \"oed\",\n \"columnName\": \"Eta (origin)\",\n \"description\": \"Estimated time of arrival at origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_start\",\n \"shortId\": \"ost\",\n \"columnName\": \"Start (origin)\",\n \"description\": \"Start date of the trip\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_end\",\n \"shortId\": \"oen\",\n \"columnName\": \"End (origin)\",\n \"description\": \"End of the loading process at the origin \",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_country_name\",\n \"shortId\": \"dcn\",\n \"columnName\": \"Country (destination)\",\n \"description\": \"Name of the destination country\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_subcontinent_name\",\n \"shortId\": \"dsn\",\n \"columnName\": \"Subcontinent (destination)\",\n \"description\": \"Subcontinent of trade destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_destination_name\",\n \"shortId\": \"cdn\",\n \"columnName\": \"Continent Destination\",\n \"description\": \"Continent of destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_eta\",\n \"shortId\": \"ded\",\n \"columnName\": \"Eta (destination)\",\n \"description\": \"Estimated time of arrival at destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_start\",\n \"shortId\": \"dsd\",\n \"columnName\": \"Start (destination)\",\n \"description\": \"Start of the discharge process at destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_end\",\n \"shortId\": \"den\",\n \"columnName\": \"End (destination)\",\n \"description\": \"Departure datetime from the destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"vcm\",\n \"columnName\": \"Capacity (vessel m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"vet\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"vct\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_id\",\n \"shortId\": \"tid\",\n \"columnName\": \"Id (Trade)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_origin_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"Zone Origin\",\n \"description\": \"Name of the origin area\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_origin_id\",\n \"shortId\": \"zoi\",\n \"columnName\": \"Zone Origin Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_destination_name\",\n \"shortId\": \"zdn\",\n \"columnName\": \"Zone Destination\",\n \"description\": \"Name of the destination area\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_destination_id\",\n \"shortId\": \"zdi\",\n \"columnName\": \"Zone Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_origin_name\",\n \"shortId\": \"ion\",\n \"columnName\": \"Installation origin\",\n \"description\": \"Name of the origin installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_origin_id\",\n \"shortId\": \"ioi\",\n \"columnName\": \"Installation origin id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_destination_name\",\n \"shortId\": \"idn\",\n \"columnName\": \"Installation Destination\",\n \"description\": \"Name of the destination installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_destination_id\",\n \"shortId\": \"idi\",\n \"columnName\": \"Installation Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"mileage_nautical_miles\",\n \"shortId\": \"mnm\",\n \"columnName\": \"Mileage\",\n \"description\": \"Distance between origin and destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"ton_miles\",\n \"shortId\": \"tom\",\n \"columnName\": \"Ton Miles\",\n \"description\": \"Ton/mile report\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (Voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n }\n ],\n \"Optional Columns\": [\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_sources\",\n \"shortId\": \"cargo_sources\",\n \"columnName\": \"Cargo Sources\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"charterer_name\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current Controller of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_1\",\n \"shortId\": \"stco1\",\n \"columnName\": \"Country STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_2\",\n \"shortId\": \"stco2\",\n \"columnName\": \"Country STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_3\",\n \"shortId\": \"stco3\",\n \"columnName\": \"Country STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date1\",\n \"shortId\": \"sted1\",\n \"columnName\": \"Date End STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date2\",\n \"shortId\": \"sted2\",\n \"columnName\": \"Date End STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date3\",\n \"shortId\": \"sted3\",\n \"columnName\": \"Date End STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_1\",\n \"shortId\": \"stsd1\",\n \"columnName\": \"Date Start STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_2\",\n \"shortId\": \"stsd2\",\n \"columnName\": \"Date Start STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_3\",\n \"shortId\": \"stsd3\",\n \"columnName\": \"Date Start STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_destination_id\",\n \"shortId\": \"pcdid\",\n \"columnName\": \"Destination PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"export_price\",\n \"shortId\": \"epr\",\n \"columnName\": \"Export price\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_location_name\",\n \"shortId\": \"fol\",\n \"columnName\": \"Forecasted origin\",\n \"description\": \"Next origin forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_eta\",\n \"shortId\": \"foe\",\n \"columnName\": \"Forecasted origin ETA\",\n \"description\": \"Next origin ETA forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_confidence\",\n \"shortId\": \"foc\",\n \"columnName\": \"Forecasted origin confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulfur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"product_id\",\n \"shortId\": \"proid\",\n \"columnName\": \"Id (Product)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"import_price\",\n \"shortId\": \"ipr\",\n \"columnName\": \"Import price\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_1\",\n \"shortId\": \"stsi1\",\n \"columnName\": \"Installation STS 1\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_2\",\n \"shortId\": \"stsi2\",\n \"columnName\": \"Installation STS 2\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_3\",\n \"shortId\": \"stsi3\",\n \"columnName\": \"Installation STS 3\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_buyer_country_name\",\n \"shortId\": \"b1c\",\n \"columnName\": \"Link1 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_buyer_name\",\n \"shortId\": \"n1b\",\n \"columnName\": \"Link1 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_delivery\",\n \"shortId\": \"t1d\",\n \"columnName\": \"Link1 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_seller_country_name\",\n \"shortId\": \"s1c\",\n \"columnName\": \"Link1 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_seller_name\",\n \"shortId\": \"s1n\",\n \"columnName\": \"Link1 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_type\",\n \"shortId\": \"t1t\",\n \"columnName\": \"Link1 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_buyer_country_name\",\n \"shortId\": \"b2c\",\n \"columnName\": \"Link2 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_buyer_name\",\n \"shortId\": \"n2b\",\n \"columnName\": \"Link2 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_delivery\",\n \"shortId\": \"t2d\",\n \"columnName\": \"Link2 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_seller_country_name\",\n \"shortId\": \"s2c\",\n \"columnName\": \"Link2 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_seller_name\",\n \"shortId\": \"s2n\",\n \"columnName\": \"Link2 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_type\",\n \"shortId\": \"t2t\",\n \"columnName\": \"Link2 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_buyer_country_name\",\n \"shortId\": \"b3c\",\n \"columnName\": \"Link3 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_buyer_name\",\n \"shortId\": \"n3b\",\n \"columnName\": \"Link3 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_delivery\",\n \"shortId\": \"t3d\",\n \"columnName\": \"Link3 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_seller_country_name\",\n \"shortId\": \"s3c\",\n \"columnName\": \"Link3 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_seller_name\",\n \"shortId\": \"s3n\",\n \"columnName\": \"Link3 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_type\",\n \"shortId\": \"t3t\",\n \"columnName\": \"Link3 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_buyer_country_name\",\n \"shortId\": \"b4c\",\n \"columnName\": \"Link4 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_buyer_name\",\n \"shortId\": \"n4b\",\n \"columnName\": \"Link4 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_delivery\",\n \"shortId\": \"t4d\",\n \"columnName\": \"Link4 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_seller_country_name\",\n \"shortId\": \"s4c\",\n \"columnName\": \"Link4 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_seller_name\",\n \"shortId\": \"s4n\",\n \"columnName\": \"Link4 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_type\",\n \"shortId\": \"t4t\",\n \"columnName\": \"Link4 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_buyer_country_name\",\n \"shortId\": \"b5c\",\n \"columnName\": \"Link5 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_buyer_name\",\n \"shortId\": \"n5b\",\n \"columnName\": \"Link5 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_delivery\",\n \"shortId\": \"t5d\",\n \"columnName\": \"Link5 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_seller_country_name\",\n \"shortId\": \"s5c\",\n \"columnName\": \"Link5 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_seller_name\",\n \"shortId\": \"s5n\",\n \"columnName\": \"Link5 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_type\",\n \"shortId\": \"t5t\",\n \"columnName\": \"Link5 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"msi\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"export_number_of_trades\",\n \"shortId\": \"ent\",\n \"columnName\": \"Number of trades (export)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"import_number_of_trades\",\n \"shortId\": \"int\",\n \"columnName\": \"Number of trades (import)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_origin_id\",\n \"shortId\": \"pcoid\",\n \"columnName\": \"Origin PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_1\",\n \"shortId\": \"dwt1\",\n \"columnName\": \"Vessel DWT\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_2\",\n \"shortId\": \"dwt2\",\n \"columnName\": \"Vessel DWT 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_3\",\n \"shortId\": \"dwt3\",\n \"columnName\": \"Vessel DWT 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_4\",\n \"shortId\": \"dwt4\",\n \"columnName\": \"Vessel DWT 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_2\",\n \"shortId\": \"imo2\",\n \"columnName\": \"Vessel IMO 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_3\",\n \"shortId\": \"imo3\",\n \"columnName\": \"Vessel IMO 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_4\",\n \"shortId\": \"imo4\",\n \"columnName\": \"Vessel IMO 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_2\",\n \"shortId\": \"vid2\",\n \"columnName\": \"Vessel Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_3\",\n \"shortId\": \"vid3\",\n \"columnName\": \"Vessel Id 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_4\",\n \"shortId\": \"vid4\",\n \"columnName\": \"Vessel Id 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_2\",\n \"shortId\": \"ven2\",\n \"columnName\": \"Vessel Name 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_3\",\n \"shortId\": \"ven3\",\n \"columnName\": \"Vessel Name 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_4\",\n \"shortId\": \"ven4\",\n \"columnName\": \"Vessel Name 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_1\",\n \"shortId\": \"stsv1\",\n \"columnName\": \"Volume STS 1\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_2\",\n \"shortId\": \"stsv2\",\n \"columnName\": \"Volume STS 2\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_3\",\n \"shortId\": \"stsv3\",\n \"columnName\": \"Volume STS 3\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_2\",\n \"shortId\": \"voyage_id_2\",\n \"columnName\": \"Voyage Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_3\",\n \"shortId\": \"voyage_id_3\",\n \"columnName\": \"Voyage Id 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_4\",\n \"shortId\": \"voyage_id_4\",\n \"columnName\": \"Voyage Id 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"zone_canal_transit\",\n \"shortId\": \"zct\",\n \"columnName\": \"Zone Canal Transit\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_1\",\n \"shortId\": \"st1\",\n \"columnName\": \"Zone STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_2\",\n \"shortId\": \"st2\",\n \"columnName\": \"Zone STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_3\",\n \"shortId\": \"st3\",\n \"columnName\": \"Zone STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_1_id\",\n \"shortId\": \"stzid1\",\n \"columnName\": \"Zone STS Id 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_2_id\",\n \"shortId\": \"stzid2\",\n \"columnName\": \"Zone STS Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_3_id\",\n \"shortId\": \"stzid3\",\n \"columnName\": \"Zone STS Id 3\",\n \"description\": null,\n \"deprecated\": false\n }\n ]\n}"},{"id":"fe07d02f-0270-4c70-aad4-5ae063c3b398","name":"Snapshot from the past","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades/snapshot?snapshotDate=2020-09-25T020000","protocol":"https","host":["api","kpler","com"],"path":["v1","trades","snapshot"],"query":[{"key":"columns","value":"{{columns}}","description":"Optional [String]: Retrieve all available columns when set to \"all\"","disabled":true},{"key":"hash","value":"{{hash}}","description":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the `POST /v1/trades/columns`endpoint to learn more about how to generate the hash code )\n\n**Note:** You cannot use it simultaneously with the ‘columns’ parameter","disabled":true},{"key":"snapshotDate","value":"2020-09-25T020000"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"631ee3c1-9b11-4ebc-8175-d77f6c25048a"},{"name":"/v1/trades/snapshot/list","event":[{"listen":"test","script":{"id":"3d8b9b2d-e1e4-4f67-80d3-afa9222329f7","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"a6202481-7d54-4275-94d2-3ffd06f08985","exec":[""],"type":"text/javascript"}}],"id":"ff0ea03a-f360-4124-bfe4-118a4a12c0eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/trades/snapshot/list?startDate={{startDate}}&endDate={{endDate}}","description":"List of snapshots provides a list of all the available snapshots in our /v1/trades/snapshot endpoint. You can filter the data by start date and end date.
\nNote that the duration between the start date and end date cannot exceed one month.
\n","urlObject":{"protocol":"https","path":["v1","trades","snapshot","list"],"host":["api","kpler","com"],"query":[{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"}],"variable":[]}},"response":[{"id":"959ad35d-a4bc-4205-9c8c-c2b8fdbaaaba","name":"Retrieve a list of snapshots","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades/snapshot/list?startDate=2023-05-01&endDate=2023-05-05","protocol":"https","host":["api","kpler","com"],"path":["v1","trades","snapshot","list"],"query":[{"key":"startDate","value":"2023-05-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD)"},{"key":"endDate","value":"2023-05-05","description":"Optional [Date]: End of the period (YYYY-MM-DD)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Wed, 10 May 2023 15:51:52 GMT"},{"key":"Content-Type","value":"text/csv; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"*,Accept-Encoding"},{"key":"Pragma","value":"no-cache"},{"key":"Cache-Control","value":"private, no-cache, no-store, must-revalidate, max-age=0, proxy-revalidate, s-maxage=0, Expires: Sat, 12 Oct 1991 05:00:00 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-Kong-Upstream-Latency","value":"640"},{"key":"X-Kong-Proxy-Latency","value":"1"},{"key":"Via","value":"kong/3.2.1.0-enterprise-edition"}],"cookie":[],"responseTime":null,"body":"2023-05-01T000100\n2023-05-01T010100\n2023-05-01T020100\n2023-05-01T030100\n2023-05-01T040100\n2023-05-01T050100\n2023-05-01T060100\n2023-05-01T070100\n2023-05-01T080100\n2023-05-01T090100\n2023-05-01T100100\n2023-05-01T110100\n2023-05-01T120100\n2023-05-01T130100\n2023-05-01T140100\n2023-05-01T150100\n2023-05-01T160100\n2023-05-01T170100\n2023-05-01T180000\n2023-05-01T190100\n2023-05-01T200100\n2023-05-01T210100\n2023-05-01T220100\n2023-05-01T230100\n2023-05-02T000100\n2023-05-02T010100\n2023-05-02T020100\n2023-05-02T030100\n2023-05-02T040100\n2023-05-02T050100\n2023-05-02T060100\n2023-05-02T070100\n2023-05-02T080100\n2023-05-02T090100\n2023-05-02T100100\n2023-05-02T110100\n2023-05-02T120100\n2023-05-02T130100\n2023-05-02T140100\n2023-05-02T150100\n2023-05-02T160100\n2023-05-02T170100\n2023-05-02T180100\n2023-05-02T190100\n2023-05-02T200100\n2023-05-02T210100\n2023-05-02T220100\n2023-05-02T230100\n2023-05-03T000100\n2023-05-03T010100\n2023-05-03T020100\n2023-05-03T030100\n2023-05-03T040100\n2023-05-03T050100\n2023-05-03T060100\n2023-05-03T070100\n2023-05-03T080100\n2023-05-03T090100\n2023-05-03T100100\n2023-05-03T110100\n2023-05-03T120100\n2023-05-03T130000\n2023-05-03T140100\n2023-05-03T150100\n2023-05-03T160100\n2023-05-03T170100\n2023-05-03T180100\n2023-05-03T190100\n2023-05-03T200100\n2023-05-03T210100\n2023-05-03T220100\n2023-05-03T230100\n2023-05-04T000100\n2023-05-04T010100\n2023-05-04T020100\n2023-05-04T030100\n2023-05-04T040100\n2023-05-04T050100\n2023-05-04T060100\n2023-05-04T070100\n2023-05-04T080100\n2023-05-04T090100\n2023-05-04T100100\n2023-05-04T110100\n2023-05-04T120100\n2023-05-04T130100\n2023-05-04T140100\n2023-05-04T150100\n2023-05-04T160100\n2023-05-04T170100\n2023-05-04T180100\n2023-05-04T190100\n2023-05-04T200100\n2023-05-04T210000\n2023-05-04T220100\n2023-05-04T230100\n2023-05-05T000100\n2023-05-05T010100\n2023-05-05T020100\n2023-05-05T030100\n2023-05-05T040000\n2023-05-05T050100\n2023-05-05T060100\n2023-05-05T070100\n2023-05-05T080000\n2023-05-05T090100\n2023-05-05T100100\n2023-05-05T110100\n2023-05-05T120100\n2023-05-05T130100\n2023-05-05T140100\n2023-05-05T150100\n2023-05-05T160100\n2023-05-05T170100\n2023-05-05T180100\n2023-05-05T190100\n2023-05-05T200100\n2023-05-05T210100\n2023-05-05T220100\n2023-05-05T230100"}],"_postman_id":"ff0ea03a-f360-4124-bfe4-118a4a12c0eb"},{"name":"/v1/trades/updates","event":[{"listen":"test","script":{"id":"987ccd93-b9db-4b3d-9f99-5077ed47ddd9","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"b6ee4c93-91f6-4ccc-854f-da7641cab189","exec":[""],"type":"text/javascript"}}],"id":"e13f30dc-7a1c-4dd1-b699-a6fabc74346b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/trades/updates","description":"https://api.kpler.com/For the first call, the startDate parameter should come from the header lastAvailableDate return by v1/trades/snapshot,\nthen for following calls will use the lastAvailableDate header returned by v1/trades/updates itself.
NOTE:
\n/v1/trades/snapshot once to initialize your data store/ data lake/ data warehouse, and schedule the call to /v1/trades/snapshot is more optimal than calling /v1/trades at a high frequency.How showAllHistory parameter works?
This parameter is meant to provide the different states of the data over time.
\ne.g 1: if a Trade changes 3 times since the startDate then you'll get 3 rows.
\ne.g 2: if a Trade changes 2 times since the startDate and is eventually deleted, both Updates and the Delete operation will be returned, so 3 rows as well.
\ne.g 1: if a Trade changes 3 times since the startDate then you'll get a single row compacting the 3 changes.
\ne.g 2: if a Trade is changes 2 times since the startDate and is eventually deleted, only the Delete operation will be returned.
\nFor a same time period, more rows will be returned when showAllHistory is set to true. \nFor a same trade_id product_id couple, more than one operation can be returned, compared to a single one when showAllHistory is set to false.
\nExample 1:
\nshowAllHistory set to true
\nshowAllHistory set to false
\nExample 2
\nshowAllHistory set to true
\nshowAllHistory set to false
\nNOTE: showAllHistory set to true takes more time to process as it doesn't stream the results as showAllHistory set to false does.
\n","urlObject":{"protocol":"https","path":["v1","trades","updates"],"host":["api","kpler","com"],"query":[{"disabled":true,"description":{"content":"Required [String]: Use following format: YYYY-MM-DDTHHmmss.\nThe starting point in time of the returned \"diffs\", in UTC 0 time. All diffs that have been computed strictly after that date will be returned.
\nNote: a time window of 15 days of diffs are kept, you can't look before in the past
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}\n"},{"disabled":true,"description":{"content":"Optional [String]: Use ['true', 'false']. Default to false if not specified.
\n","type":"text/plain"},"key":"showAllHistory","value":"{{showAllHistory}}"},{"disabled":true,"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"disabled":true,"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the POST /v1/trades/columnsendpoint to learn more about how to generate the hash code )
Note: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"},{"disabled":true,"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"}],"variable":[]}},"response":[{"id":"5f108cac-8d3f-4ba0-8bda-69d5186b3f6d","name":"Liquids - Get trades since 1st January 2020","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/trades/updates?startDate=2020-01-01T090721","protocol":"https","host":["api","kpler","com"],"path":["v1","trades","updates"],"query":[{"key":"startDate","value":"2020-01-01T090721"}]}},"_postman_previewlanguage":null,"header":[{"key":"lastAvailableDate","value":"2020-10-27T130100","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"productId;tradeId;date;operation;jsonUpdates\n1370;8367627;2020-10-27T020100;DELETE;\n1370;8381082;2020-10-28T090100;INSERT;{\"Vessel\":\"Seavelvet\",\"Volume (bbl)\":\"755695\",\"Family\":\"Dirty\",\"Group\":\"crude/co\",\"Id (Voyage)\":\"31231236\",\"Date (origin)\":\"2020-12-14 05:46\",\"Forecasted destination\":\"Americas\",\"Forecasted ETA\":\"2020-12-19 08:16\",\"Forecasted confidence\":\"0.8\",\"Trade status\":\"Scheduled\",\"Eta source (origin)\":\"Model\",\"Eta source (destination)\":\"Model\",\"Capacity (vessel m3)\":\"121976\",\"Vessel type\":\"LR2\",\"Id (vessel)\":\"103406\"}\n1894;8305898;2020-10-27T180100;UPDATE;{\"Country (destination)\":\"Panama\",\"Zone Destination\":\"Panama Light.\",\"Start (destination)\":\"2020-10-17 19:05\",\"Zone Destination Id\":\"2794\",\"Mileage\":\"417\",\"Ton Miles\":\"14600119\",\"Date (destination)\":\"2020-10-17 19:05\",\"Destination\":\"Panama Light.\",\"Reload STS Partial (destination)\":\"STS\",\"Trade status\":\"Delivered\",\"Buyer (destination)\":\"\",\"Intermediaries\":\"0\",\"Eta source (destination)\":\"\",\"Subcontinent (destination)\":\"Central America\",\"Eta (destination)\":\"\",\"End (destination)\":\"2020-10-18 21:47\"}\n(truncated response)"},{"id":"c0ca59e9-969a-4a3f-b048-121dcc43127b","name":"Columns id, name, description and deprecation status","originalRequest":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/trades/snapshot/updates"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"Columns by default\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": \"Product type\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"str\",\n \"columnName\": \"Date (origin)\",\n \"description\": \"Departure date of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_location_name\",\n \"shortId\": \"oln\",\n \"columnName\": \"Origin\",\n \"description\": \"Origin location of the cargo\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_eta_source\",\n \"shortId\": \"oes\",\n \"columnName\": \"Eta source (origin)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Origin information (Port, Analyst, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_reload_sts_partial\",\n \"shortId\": \"ota\",\n \"columnName\": \"Reload STS Partial (origin)\",\n \"description\": \"If field contains 'Partial' = Partial has occurred in this port call. Same logic applies for when “Reload” and 'STS' is returned for Re-loads and Ship-to-Ship transfers\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"Date (destination)\",\n \"description\": \"Arrival date of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_location_name\",\n \"shortId\": \"dln\",\n \"columnName\": \"Destination\",\n \"description\": \"Destination location of the cargo\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_eta_source\",\n \"shortId\": \"des\",\n \"columnName\": \"Eta source (destination)\",\n \"description\": \"Source of the Estimated Time of Arrival to the Installation of Destination information (Port, Analyst, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_reload_sts_partial\",\n \"shortId\": \"dta\",\n \"columnName\": \"Reload STS Partial (destination)\",\n \"description\": \"If field contains 'Partial' then Partial has occurred in this port call. Same logic applies for when 'Reload' and 'STS' is returned for Re-loads and Ship-to-Ship transfers.\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_location_name\",\n \"shortId\": \"fdl\",\n \"columnName\": \"Forecasted destination\",\n \"description\": \"Next destination forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_location_eta\",\n \"shortId\": \"fde\",\n \"columnName\": \"Forecasted ETA\",\n \"description\": \"Next destination ETA forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_destination_confidence\",\n \"shortId\": \"fdc\",\n \"columnName\": \"Forecasted confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"status\",\n \"shortId\": \"stt\",\n \"columnName\": \"Trade status\",\n \"description\": \"'Scheduled' = cargo has not been picked up yet. 'In Transit' = cargo is in movement. 'Delivered' = cargo arrived to destination.\",\n \"deprecated\": false\n },\n {\n \"id\": \"initial_seller_name\",\n \"shortId\": \"isn\",\n \"columnName\": \"Seller (origin)\",\n \"description\": \"Company name that sold cargo at the installation of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"final_buyer_name\",\n \"shortId\": \"fbn\",\n \"columnName\": \"Buyer (destination)\",\n \"description\": \"Company name of the buyer at final destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"number_of_intermediaries\",\n \"shortId\": \"noi\",\n \"columnName\": \"Intermediaries\",\n \"description\": \"Number of intermediate players involved in the trade\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_country_name\",\n \"shortId\": \"ocn\",\n \"columnName\": \"Country (origin)\",\n \"description\": \"Name of the origin country\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_subcontinent_name\",\n \"shortId\": \"osn\",\n \"columnName\": \"Subcontinent (origin)\",\n \"description\": \"Subcontinent of trade origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_origin_name\",\n \"shortId\": \"con\",\n \"columnName\": \"Continent Origin\",\n \"description\": \"Continent of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_eta_date\",\n \"shortId\": \"oed\",\n \"columnName\": \"Eta (origin)\",\n \"description\": \"Estimated time of arrival at origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_start\",\n \"shortId\": \"ost\",\n \"columnName\": \"Start (origin)\",\n \"description\": \"Start date of the trip\",\n \"deprecated\": false\n },\n {\n \"id\": \"origin_end\",\n \"shortId\": \"oen\",\n \"columnName\": \"End (origin)\",\n \"description\": \"End of the loading process at the origin \",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_country_name\",\n \"shortId\": \"dcn\",\n \"columnName\": \"Country (destination)\",\n \"description\": \"Name of the destination country\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_subcontinent_name\",\n \"shortId\": \"dsn\",\n \"columnName\": \"Subcontinent (destination)\",\n \"description\": \"Subcontinent of trade destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_destination_name\",\n \"shortId\": \"cdn\",\n \"columnName\": \"Continent Destination\",\n \"description\": \"Continent of destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_eta\",\n \"shortId\": \"ded\",\n \"columnName\": \"Eta (destination)\",\n \"description\": \"Estimated time of arrival at destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_start\",\n \"shortId\": \"dsd\",\n \"columnName\": \"Start (destination)\",\n \"description\": \"Start of the discharge process at destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"destination_end\",\n \"shortId\": \"den\",\n \"columnName\": \"End (destination)\",\n \"description\": \"Departure datetime from the destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"vcm\",\n \"columnName\": \"Capacity (vessel m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"vet\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"vct\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_id\",\n \"shortId\": \"tid\",\n \"columnName\": \"Id (Trade)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_origin_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"Zone Origin\",\n \"description\": \"Name of the origin area\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_origin_id\",\n \"shortId\": \"zoi\",\n \"columnName\": \"Zone Origin Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_destination_name\",\n \"shortId\": \"zdn\",\n \"columnName\": \"Zone Destination\",\n \"description\": \"Name of the destination area\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_destination_id\",\n \"shortId\": \"zdi\",\n \"columnName\": \"Zone Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_origin_name\",\n \"shortId\": \"ion\",\n \"columnName\": \"Installation origin\",\n \"description\": \"Name of the origin installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_origin_id\",\n \"shortId\": \"ioi\",\n \"columnName\": \"Installation origin id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_destination_name\",\n \"shortId\": \"idn\",\n \"columnName\": \"Installation Destination\",\n \"description\": \"Name of the destination installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_destination_id\",\n \"shortId\": \"idi\",\n \"columnName\": \"Installation Destination Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"mileage_nautical_miles\",\n \"shortId\": \"mnm\",\n \"columnName\": \"Mileage\",\n \"description\": \"Distance between origin and destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"ton_miles\",\n \"shortId\": \"tom\",\n \"columnName\": \"Ton Miles\",\n \"description\": \"Ton/mile report\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (Voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n }\n ],\n \"Optional Columns\": [\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_sources\",\n \"shortId\": \"cargo_sources\",\n \"columnName\": \"Cargo Sources\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"charterer_name\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current Controller of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_1\",\n \"shortId\": \"stco1\",\n \"columnName\": \"Country STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_2\",\n \"shortId\": \"stco2\",\n \"columnName\": \"Country STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_country_3\",\n \"shortId\": \"stco3\",\n \"columnName\": \"Country STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date1\",\n \"shortId\": \"sted1\",\n \"columnName\": \"Date End STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date2\",\n \"shortId\": \"sted2\",\n \"columnName\": \"Date End STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_end_date3\",\n \"shortId\": \"sted3\",\n \"columnName\": \"Date End STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_1\",\n \"shortId\": \"stsd1\",\n \"columnName\": \"Date Start STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_2\",\n \"shortId\": \"stsd2\",\n \"columnName\": \"Date Start STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_start_date_3\",\n \"shortId\": \"stsd3\",\n \"columnName\": \"Date Start STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_destination_id\",\n \"shortId\": \"pcdid\",\n \"columnName\": \"Destination PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"export_price\",\n \"shortId\": \"epr\",\n \"columnName\": \"Export price\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_location_name\",\n \"shortId\": \"fol\",\n \"columnName\": \"Forecasted origin\",\n \"description\": \"Next origin forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_eta\",\n \"shortId\": \"foe\",\n \"columnName\": \"Forecasted origin ETA\",\n \"description\": \"Next origin ETA forecasted\",\n \"deprecated\": false\n },\n {\n \"id\": \"next_forecasted_origin_confidence\",\n \"shortId\": \"foc\",\n \"columnName\": \"Forecasted origin confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulfur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"product_id\",\n \"shortId\": \"proid\",\n \"columnName\": \"Id (Product)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"import_price\",\n \"shortId\": \"ipr\",\n \"columnName\": \"Import price\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_1\",\n \"shortId\": \"stsi1\",\n \"columnName\": \"Installation STS 1\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_2\",\n \"shortId\": \"stsi2\",\n \"columnName\": \"Installation STS 2\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_installation_3\",\n \"shortId\": \"stsi3\",\n \"columnName\": \"Installation STS 3\",\n \"description\": \"Ship to ship installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_buyer_country_name\",\n \"shortId\": \"b1c\",\n \"columnName\": \"Link1 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_buyer_name\",\n \"shortId\": \"n1b\",\n \"columnName\": \"Link1 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_delivery\",\n \"shortId\": \"t1d\",\n \"columnName\": \"Link1 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_seller_country_name\",\n \"shortId\": \"s1c\",\n \"columnName\": \"Link1 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_seller_name\",\n \"shortId\": \"s1n\",\n \"columnName\": \"Link1 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_1_type\",\n \"shortId\": \"t1t\",\n \"columnName\": \"Link1 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_buyer_country_name\",\n \"shortId\": \"b2c\",\n \"columnName\": \"Link2 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_buyer_name\",\n \"shortId\": \"n2b\",\n \"columnName\": \"Link2 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_delivery\",\n \"shortId\": \"t2d\",\n \"columnName\": \"Link2 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_seller_country_name\",\n \"shortId\": \"s2c\",\n \"columnName\": \"Link2 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_seller_name\",\n \"shortId\": \"s2n\",\n \"columnName\": \"Link2 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_2_type\",\n \"shortId\": \"t2t\",\n \"columnName\": \"Link2 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_buyer_country_name\",\n \"shortId\": \"b3c\",\n \"columnName\": \"Link3 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_buyer_name\",\n \"shortId\": \"n3b\",\n \"columnName\": \"Link3 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_delivery\",\n \"shortId\": \"t3d\",\n \"columnName\": \"Link3 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_seller_country_name\",\n \"shortId\": \"s3c\",\n \"columnName\": \"Link3 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_seller_name\",\n \"shortId\": \"s3n\",\n \"columnName\": \"Link3 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_3_type\",\n \"shortId\": \"t3t\",\n \"columnName\": \"Link3 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_buyer_country_name\",\n \"shortId\": \"b4c\",\n \"columnName\": \"Link4 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_buyer_name\",\n \"shortId\": \"n4b\",\n \"columnName\": \"Link4 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_delivery\",\n \"shortId\": \"t4d\",\n \"columnName\": \"Link4 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_seller_country_name\",\n \"shortId\": \"s4c\",\n \"columnName\": \"Link4 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_seller_name\",\n \"shortId\": \"s4n\",\n \"columnName\": \"Link4 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_4_type\",\n \"shortId\": \"t4t\",\n \"columnName\": \"Link4 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_buyer_country_name\",\n \"shortId\": \"b5c\",\n \"columnName\": \"Link5 buyer country\",\n \"description\": \"Cargo’s buyer country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_buyer_name\",\n \"shortId\": \"n5b\",\n \"columnName\": \"Link5 buyer name\",\n \"description\": \"Cargo’s buyer name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_delivery\",\n \"shortId\": \"t5d\",\n \"columnName\": \"Link5 delivery\",\n \"description\": \"'FOB' =The trade is Free on Board. 'DES' = The trade is Delivery EX Shipped\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_seller_country_name\",\n \"shortId\": \"s5c\",\n \"columnName\": \"Link5 seller country\",\n \"description\": \"Cargo’s seller country of origin\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_seller_name\",\n \"shortId\": \"s5n\",\n \"columnName\": \"Link5 seller name\",\n \"description\": \"Cargo’s seller name\",\n \"deprecated\": false\n },\n {\n \"id\": \"trade_link_5_type\",\n \"shortId\": \"t5t\",\n \"columnName\": \"Link5 type\",\n \"description\": \"Type of trade (contract, portfolio, group, ...)\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"msi\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"export_number_of_trades\",\n \"shortId\": \"ent\",\n \"columnName\": \"Number of trades (export)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"import_number_of_trades\",\n \"shortId\": \"int\",\n \"columnName\": \"Number of trades (import)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_origin_id\",\n \"shortId\": \"pcoid\",\n \"columnName\": \"Origin PortCall Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_1\",\n \"shortId\": \"dwt1\",\n \"columnName\": \"Vessel DWT\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_2\",\n \"shortId\": \"dwt2\",\n \"columnName\": \"Vessel DWT 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_3\",\n \"shortId\": \"dwt3\",\n \"columnName\": \"Vessel DWT 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_dwt_4\",\n \"shortId\": \"dwt4\",\n \"columnName\": \"Vessel DWT 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_2\",\n \"shortId\": \"imo2\",\n \"columnName\": \"Vessel IMO 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_3\",\n \"shortId\": \"imo3\",\n \"columnName\": \"Vessel IMO 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo_4\",\n \"shortId\": \"imo4\",\n \"columnName\": \"Vessel IMO 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_2\",\n \"shortId\": \"vid2\",\n \"columnName\": \"Vessel Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_3\",\n \"shortId\": \"vid3\",\n \"columnName\": \"Vessel Id 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id_4\",\n \"shortId\": \"vid4\",\n \"columnName\": \"Vessel Id 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_2\",\n \"shortId\": \"ven2\",\n \"columnName\": \"Vessel Name 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_3\",\n \"shortId\": \"ven3\",\n \"columnName\": \"Vessel Name 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_name_4\",\n \"shortId\": \"ven4\",\n \"columnName\": \"Vessel Name 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_1\",\n \"shortId\": \"stsv1\",\n \"columnName\": \"Volume STS 1\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_2\",\n \"shortId\": \"stsv2\",\n \"columnName\": \"Volume STS 2\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_volume_3\",\n \"shortId\": \"stsv3\",\n \"columnName\": \"Volume STS 3\",\n \"description\": \"Ship to ship volume\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_2\",\n \"shortId\": \"voyage_id_2\",\n \"columnName\": \"Voyage Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_3\",\n \"shortId\": \"voyage_id_3\",\n \"columnName\": \"Voyage Id 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id_4\",\n \"shortId\": \"voyage_id_4\",\n \"columnName\": \"Voyage Id 4\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"zone_canal_transit\",\n \"shortId\": \"zct\",\n \"columnName\": \"Zone Canal Transit\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_1\",\n \"shortId\": \"st1\",\n \"columnName\": \"Zone STS 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_2\",\n \"shortId\": \"st2\",\n \"columnName\": \"Zone STS 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_3\",\n \"shortId\": \"st3\",\n \"columnName\": \"Zone STS 3\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_1_id\",\n \"shortId\": \"stzid1\",\n \"columnName\": \"Zone STS Id 1\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_2_id\",\n \"shortId\": \"stzid2\",\n \"columnName\": \"Zone STS Id 2\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"super_trade_zone_3_id\",\n \"shortId\": \"stzid3\",\n \"columnName\": \"Zone STS Id 3\",\n \"description\": null,\n \"deprecated\": false\n }\n ]\n}"}],"_postman_id":"e13f30dc-7a1c-4dd1-b699-a6fabc74346b"}],"id":"a12b9553-0729-463c-b14f-ca44427a20ba","description":"The Trades query returns the volumes from one point of interest to another (installation/zone) on a cargo-by-cargo basis.
\nIn order to select specific columns to display, please use the column ids explicited in the example called Columns id, name, description and deprecation status.
\n","event":[{"listen":"prerequest","script":{"id":"405652fc-0d90-4e48-aed6-2279fafcfa4d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2e196f57-912c-4b42-810c-22a119522e37","type":"text/javascript","exec":[""]}}],"_postman_id":"a12b9553-0729-463c-b14f-ca44427a20ba","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Vessels","item":[{"name":"/v1/vessels","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"6685f7ad-53d1-4082-9d9b-4abcb30fe489","exec":[""],"type":"text/javascript"}}],"id":"f2b94ab4-69de-4fa7-809b-2074cbb0276c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/vessels?columns={{columns}}&hash={{hash}}","description":"What is {{HOST_URL}} and where do we find it?
\nWe provide two parameters to retrieve vessels. You must use one of them or you will get an error:
\nRetrieve all available columns when set to \"all\"
\nNote: Please see note above for details
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"description":{"content":"Generate your favorite set of columns using the hash ( Look at the next endpoint to learn more about how to generate the hash code )
\nNote: Please see note above for details
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"}],"variable":[]}},"response":[{"id":"03caceef-4e89-47e2-ac43-0cd47ce8dc73","name":"Columns id, name, description and deprecation status","originalRequest":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/vessels/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"Columns by default\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_name\",\n \"shortId\": \"inn\",\n \"columnName\": \"Installation\",\n \"description\": \"Name of the installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"eta\",\n \"shortId\": \"eta\",\n \"columnName\": \"ETA\",\n \"description\": \"Estimated date and time of arrival at next destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"sta\",\n \"columnName\": \"Start\",\n \"description\": \"Date and Time when the vessel started berthing at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"End\",\n \"description\": \"Date and Time of vessel departure from the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n }\n ],\n \"Optional Columns\": [\n {\n \"id\": \"analyst_date\",\n \"shortId\": \"and\",\n \"columnName\": \"Analyst Date\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"ccm\",\n \"columnName\": \"Capacity (m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"cty\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"chartererName\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current controller of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"confidence\",\n \"shortId\": \"con\",\n \"columnName\": \"Confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_name\",\n \"shortId\": \"ctn\",\n \"columnName\": \"Continent\",\n \"description\": \"Zone location where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"country_name\",\n \"shortId\": \"cyn\",\n \"columnName\": \"Country\",\n \"description\": \"Name of the country\",\n \"deprecated\": false\n },\n {\n \"id\": \"customs_bill_of_lading_date\",\n \"shortId\": \"bol\",\n \"columnName\": \"Customs Bill Of Lading Date\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"customs_clearance_date\",\n \"shortId\": \"ccd\",\n \"columnName\": \"Customs Clearance Date\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"customs_entrance_date\",\n \"shortId\": \"ced\",\n \"columnName\": \"Customs Entrance Date\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"is_forecasted\",\n \"shortId\": \"isf\",\n \"columnName\": \"Forecasted\",\n \"description\": \"TRUE if this port call has been forecasted automatically by our system\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulphur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": \"IMO (vessel)\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_id\",\n \"shortId\": \"iid\",\n \"columnName\": \"Id (installation)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_id\",\n \"shortId\": \"pid\",\n \"columnName\": \"Id (portCall)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_id\",\n \"shortId\": \"zid\",\n \"columnName\": \"Id (zone)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"kpler_estimated_date\",\n \"shortId\": \"ked\",\n \"columnName\": \"Kpler Estimated Date\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"location_name\",\n \"shortId\": \"lon\",\n \"columnName\": \"Location\",\n \"description\": \"Specific location where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"mms\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": \"The Maritime Mobile Service Identity of the vessel (9 digits)\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_partial_cargo\",\n \"shortId\": \"isp\",\n \"columnName\": \"PartialCargo\",\n \"description\": \"TRUE if the vessel is partially loaded\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_reexport\",\n \"shortId\": \"isr\",\n \"columnName\": \"Reexport\",\n \"description\": \"TRUE if re-export has occurred\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_sts\",\n \"shortId\": \"iss\",\n \"columnName\": \"Ship to ship\",\n \"description\": \"TRUE if ship to ship transfer has occurred\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_status\",\n \"shortId\": \"ins\",\n \"columnName\": \"Status (installation)\",\n \"description\": \"Current status of the Installation (Active, Inactive, Under Construction, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_storage_capacity\",\n \"shortId\": \"isc\",\n \"columnName\": \"Storage capacity (installation)\",\n \"description\": \"Storage capacity of the installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"sub_continent_name\",\n \"shortId\": \"scn\",\n \"columnName\": \"SubContinent\",\n \"description\": \"Subcontinent where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_type\",\n \"shortId\": \"ity\",\n \"columnName\": \"Type (installation)\",\n \"description\": \"Specific type of installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"typ\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of vessel (Q-Flex,Q-Max, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"flow_quantity_cubic_meters\",\n \"shortId\": \"fqm\",\n \"columnName\": \"Volume (m3)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"zone_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"zone\",\n \"description\": \"Area where the port call is registered\",\n \"deprecated\": false\n }\n ]\n}"},{"id":"2311a6d4-35b6-4e7e-aeca-0e2a84d0704d","name":"Liquids - List of few vessels return with specific columns (Vessel Name, Vessel Status)","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/vessels?columns=vessel_name, vessel_status","protocol":"https","host":["api","kpler","com"],"path":["v1","vessels"],"query":[{"key":"columns","value":"vessel_name, vessel_status","description":"Optional [String] : Retrieve all available columns when set to \"all\""}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Name;Status\n17 February;Active\nA Elephant;Inactive\nA Melody;Active\nA P Merit;Inactive\nA Star;Inactive\nA Symphony;Active\nA. Dragon;Inactive\nA.K. Raja;Inactive\nAb Guaqueri;Active\nAbai;Active\nAbalone;Active"},{"id":"c786f02d-4d88-4148-93f0-e4e78cb0e9be","name":"CPP - List of few vessels return with all columns","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-cpp.kpler.com/v1/vessels?columns=all","protocol":"https","host":["api-cpp","kpler","com"],"path":["v1","vessels"],"query":[{"key":"columns","value":"all"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Vessel id;Name;IMO;MMSI;Status;Last port-call id;Last port-call;Departure date;Destination;ETA;Destination source;Forecasted Id;Forecasted destination;Forecasted ETA;Forecast confidence;Availability;Availability id;Open from;Open until;Delivery;Redelivery;Volume (bbl);Mass (tons);Last speed (kn);Current controller;Owners;Owners_id;Builders;Builders_id;Operators;Operators_id;Build year;Vessel type;Carrier type;Capacity (m3);Flag name;Engine type;Cargo system;Cargo type;Gross tonnage;Dead weight (t);Last signal received;Floating storage;loaded days in 2016;loaded days in 2017;loaded days in 2018;loaded days in 2019;loaded days in 2020;Last speed;Dead weight;Capacity\n78815;17 February;9380893;248896000;Active;348119265;Waidiao;2020-06-10 04:26;Panama Light.;2020-07-12 00:01;AIS;;;;;;;;;;;;;12.3;Mjolner;GNMTC;7615;;;;;2008;LR3;;173460;Malta;;;;81732;160391;PANPAC PANAMA;false;140;180;89;189;89;12.3;160391;173460\n62169;A Elephant;8608028;;Inactive;;;;;;;;;;;;;;;;;;;;Snow-Drop;TMT;4110;;;;;1987;VLCC;;285545;Liberia;;;;145661;264758;;false;0;0;0;0;0;;264758;285545\n71264;A Melody;9249312;636019335;Active;345772675;Linggi Light.;2020-04-15 14:28;;;;;;;;;;;;;;;;0.0;NGM;NGM;3271;;;;;2001;LR3;;162592;Liberia;;;;79525;149995;SG SIN OPL;true;96;91;149;102;0;0.0;149995;162592"},{"id":"de0e8803-90b4-4de4-a0bb-21c7c871710d","name":"OIL - List of few vessels return with specific columns (Vessel Name, Vessel Status, Last port-call location name)","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/vessels?columns=vessel_name, vessel_status, last_port_call_location_name","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","vessels"],"query":[{"key":"columns","value":"vessel_name, vessel_status, last_port_call_location_name","description":"Optional [String]: Retrieve all available columns when set to \"all\""}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Name;Status;Last port-call\n17 February;Active;Waidiao\nA Elephant;Inactive;\nA Melody;Active;Linggi Light.\nA P Merit;Inactive;\nA Star;Inactive;Chittagong\nA Symphony;Active;Malta Light.\nA. Dragon;Inactive;\nA.K. Raja;Inactive;\nAb Guaqueri;Active;Cabello"}],"_postman_id":"f2b94ab4-69de-4fa7-809b-2074cbb0276c"},{"name":"/v1/vessels/columns","event":[{"listen":"test","script":{"id":"84ac1c73-d15d-4f19-958f-6b9615360839","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"9cc78e7e-79f5-401d-9266-27e28935a94a","exec":[""],"type":"text/javascript"}}],"id":"ef88caff-a9e6-459f-b051-01d960938301","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"description":"Required [String] : Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"Required [String]: application/json or text/json
\n","type":"text"}],"body":{"mode":"raw","raw":"[\n \"vessel_name\",\n \"vessel_status\"\n]"},"url":"{{HOST_URL}}/v1/vessels/columns","description":"To prevent breaking changes, we strongly recommend you to not use the “all” or the default value for the 'column’ parameter as these may occasionally change.
\nTherefore we have added this endpoint which allows you to get a hash code for the set of columns that you wish to add on your query.
\nNote: The set of columns defined with the hash code will never change and will always remain the same.
\nIn this example, we have created a hash code that will always return the following columns:
\nThe Vessels query returns a snapshot of the current status of the fleet, including details on vessel status, last port call and next destination.
\nIn order to select specific columns to display, please use the column ids explicited in the example called Columns id, name, description and deprecation status.
\n","event":[{"listen":"prerequest","script":{"id":"fcbc8997-4f1e-46c0-82aa-1d0a12bbaf07","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3e355b9f-d716-4800-9c8a-cc05e89f9ced","type":"text/javascript","exec":[""]}}],"_postman_id":"798f670b-c5b5-4e8f-90cf-420604527502","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Flows","item":[{"name":"/v1/flows","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"8fcb09c7-2f87-4c13-9703-f93d6d9fba49","exec":[""],"type":"text/javascript","packages":{}}}],"id":"60344138-0478-4098-8bcb-d4299e7e5a96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n","type":"text"}],"url":"https://api.kpler.com/v1/flows?flowDirection={{flowDirection}}&split={{split}}&granularity={{granularity}}&startDate={{startDate}}&endDate={{endDate}}&fromInstallations={{fromInstallations}}&toInstallations={{toInstallations}}&fromZones={{fromZones}}&toZones={{toZones}}&products={{products}}&onlyRealized={{onlyRealized}}&unit={{unit}}&vesselTypes={{vesselTypes}}&vesselTypesAlt={{vesselTypesAlt}}&withIntraCountry={{withIntraCountry}}&withIntraRegion={{withIntraRegion}}&withForecast={{withForecast}}&withProductEstimation={{withProductEstimation}}&snapshotDate={{date}}&splitValues={{splitValues}}","description":"What is {{HOST_URL}} and where do we find it?
\nNote:
\nRequired [String]: Flow direction [\"Import\", \"Export\", \"NetImport\", \"NetExport\"] .
\nNotes: when used with snapshotDate only \"Export\" is available
\n","type":"text/plain"},"key":"flowDirection","value":"{{flowDirection}}"},{"description":{"content":"Required [String]: Use following splits: [\"Total\", \"Grades\", \"Products\", \"Crude Quality\", \"Origin Countries\", \"Destination Countries\", \"Origin Continents\", \"Destination Continents\", \"Origin Subcontinents\", \"Destination Subcontinents\", \"Origin Trading Regions\", \"Destination Trading Regions\", \"Origin Ports\", \"Destination Ports\", \"Origin Padds\", \"Destination Padds\", \"Origin Installations\", \"Destination Installations\", \"Vessel Type\", \"Vessel Type Oil\", \"Vessel Type Cpp\", \"Long Haul Vessel Type\", \"Long Haul Vessel Type Oil\", \"Long Haul Vessel Type Cpp\", \"Trade Status\", \"Sources\", \"Charterers\", \"Buyer\", \"Seller\", \"Routes\"]
\n","type":"text/plain"},"key":"split","value":"{{split}}"},{"description":{"content":"Required [String]: Period [\"annually\", \"monthly\", \"weekly\", \"eia-weekly\", \"daily\"]
\n","type":"text/plain"},"key":"granularity","value":"{{granularity}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Names of installations
\n","type":"text/plain"},"key":"fromInstallations","value":"{{fromInstallations}}"},{"description":{"content":"Optional [String]: Names of installations
\n","type":"text/plain"},"key":"toInstallations","value":"{{toInstallations}}"},{"description":{"content":"Optional [String]: Names of zones [\"port\", \"region\", \"country\", \"continent\"]
\n","type":"text/plain"},"key":"fromZones","value":"{{fromZones}}"},{"description":{"content":"Optional [String]: Names of zones [\"port\", \"region\", \"country\", \"continent\"]
\n","type":"text/plain"},"key":"toZones","value":"{{toZones}}"},{"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [Boolean]: Default to false if not specified. Takes into account only the trades that have been finished. Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"onlyRealized","value":"{{onlyRealized}}"},{"description":{"content":"Optional [String]: Use [\"kbd\", \"bbl\", \"kb\", \"mmbbl\", \"mt\", \"kt\", \"t\", \"cm\"]. By default value is unit=kb.
\n","type":"text/plain"},"key":"unit","value":"{{unit}}"},{"description":{"content":"Optional [String]: For given cpp vessel types\n
\nUse [\"LR2\", \"VLCC\", \"LR3\", \"MR\", \"GP\", \"LR1\"]\n
\nNotes:
Optional [String]: For given oil vessel types\n
\nUse [\"Aframax\", \"Product Tanker\", \"Suezmax\", \"VLCC\", \"Panamax\", \"ULCC\"]\n
\nNotes:
Optional [Boolean]: Default to false if not specified. Takes into account the trades that originate from and are delivered to the same country. Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withIntraCountry","value":"{{withIntraCountry}}"},{"description":{"content":"Optional [Boolean]: Default to true if not specified. Takes into account the trades that originate from and are delivered to a specified region. Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withIntraRegion","value":"{{withIntraRegion}}"},{"description":{"content":"Optional [Boolean]: Default to true if not specified. Include trades predicted by our in-house model when set to \"true\". Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withForecast","value":"{{withForecast}}"},{"description":{"content":"Optional [Boolean]: Default to false if not specified. Activate the product estimation feature for CPP, Fuel Oils and Chem/Bio trades only. When set to true, the estimated product will overwrite the existing product information.
\n","type":"text/plain"},"key":"withProductEstimation","value":"{{withProductEstimation}}"},{"description":{"content":"Optional [Date]: Format Date : YYYY-MM-DD, if empty it's returning the last snapshot
\n","type":"text/plain"},"key":"snapshotDate","value":"{{date}}"},{"description":{"content":"Optional [String]: Fix the values and the order of the split
\n","type":"text/plain"},"key":"splitValues","value":"{{splitValues}}"}],"variable":[]}},"response":[{"id":"3b9eebe6-ade9-44af-be50-1cc476ff0bb3","name":"Liquids - WTI, LSFO, Gasoline import to China splited by Grades","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/flows?unit=kb&flowDirection=import&granularity=monthly&toZones=China&products=WTI, LSFO, Gasoline&split=Grades","protocol":"https","host":["api","kpler","com"],"path":["v1","flows"],"query":[{"key":"unit","value":"kb"},{"key":"flowDirection","value":"import"},{"key":"granularity","value":"monthly"},{"key":"toZones","value":"China"},{"key":"products","value":"WTI, LSFO, Gasoline"},{"key":"split","value":"Grades"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":";92 Gasoline;LSFO;Gasoline;95 Gasoline;PyGas;Avgas;WTI\n2019-08;0;2811.17;118.19;0;0;0;4084.62\n2019-09;0;2702.45;431.72;0;71.46;0;0\n2019-10;0;4809.65;491.1;0;143.34;0;398.94\n2019-11;0;6248.33;184.7;0;0;0;1886.33\n2019-12;0;10898.8;486.27;0;0;56.32;0\n2020-01;546.94;5620.66;452.43;158.64;0;0;0\n2020-02;0;4279.26;0;0;0;0;0\n2020-03;0;3773.81;213.39;0;0;0;0\n2020-04;0;5145.98;539.16;0;0;0;0\n2020-05;0;8919.39;805.85;0;0;0;0\n2020-06;0;5473.42;846.48;0;0;0;700\n2020-07;0;0;0;0;0;0;4825.81"},{"id":"5357d651-699d-4003-820c-79559db547c4","name":"OIL - Crude/co export from United States splited by Origin Countries","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/flows?unit=kb&flowDirection=export&split=Origin Countries&granularity=monthly&products=crude/co&fromZones=United States","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","flows"],"query":[{"key":"unit","value":"kb"},{"key":"flowDirection","value":"export"},{"key":"split","value":"Origin Countries"},{"key":"granularity","value":"monthly"},{"key":"products","value":"crude/co"},{"key":"fromZones","value":"United States"}]}},"_postman_previewlanguage":"text","header":null,"cookie":[],"responseTime":null,"body":";United States\n2019-08;79105.84\n2019-09;84723.87\n2019-10;97381.65\n2019-11;82608.79\n2019-12;104297.78\n2020-01;91840.28\n2020-02;94289.72\n2020-03;101448.21\n2020-04;83292.17\n2020-05;92334.21\n2020-06;72870.81\n2020-07;29220.7"},{"id":"ac0445a9-7a65-4615-9994-110ae12813fd","name":"CPP - Naphtha export from United States splited by Origin Countries","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-cpp.kpler.com/v1/flows?unit=kt&flowDirection=export&split=Origin Countries&granularity=daily&products=naphtha&fromZones=United States","protocol":"https","host":["api-cpp","kpler","com"],"path":["v1","flows"],"query":[{"key":"unit","value":"kt"},{"key":"flowDirection","value":"export"},{"key":"split","value":"Origin Countries"},{"key":"granularity","value":"daily"},{"key":"products","value":"naphtha"},{"key":"fromZones","value":"United States"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":";United States\n2019-08-31;36.59\n2019-09-01;0\n2019-09-02;0\n2019-09-03;2.97\n2019-09-04;50.46\n2019-09-05;0\n2019-09-06;0\n2019-09-07;0\n2019-09-08;30.79\n2019-09-09;38.04"}],"_postman_id":"60344138-0478-4098-8bcb-d4299e7e5a96"}],"id":"c4fc812d-2a75-477e-b652-028471ba878a","description":"The Flows query returns the aggregated flows for a point of interest (installation/zone) on a daily, weekly, weekly EIA (for US), monthly and yearly basis.
\n","event":[{"listen":"prerequest","script":{"id":"2fb2d1da-fd26-48a3-89ac-8de4fb986711","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a694eecf-4c60-4325-bc48-6e9a4f7cbb33","type":"text/javascript","exec":[""]}}],"_postman_id":"c4fc812d-2a75-477e-b652-028471ba878a","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Port-calls","item":[{"name":"/v1/port-calls","event":[{"listen":"test","script":{"id":"62f08e8b-1b3c-47c8-8a67-df95a856cc37","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"26e1f6d4-f537-4d2b-9bf0-f5363d703540","exec":[""],"type":"text/javascript"}}],"id":"68a12bed-3481-4031-953e-2f1ed407d58f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"https://api.kpler.com/v1/port-calls","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","port-calls"],"host":["api","kpler","com"],"query":[{"disabled":true,"description":{"content":"Optional [Integer]: Maximum number of portcalls returned
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"disabled":true,"description":{"content":"Optional [String]: Names/IMOs of vessels
\n","type":"text/plain"},"key":"vessels","value":"{{vessels}}"},{"disabled":true,"description":{"content":"Optional [String]: Names of installations
\n","type":"text/plain"},"key":"installations","value":"{{installations}}"},{"disabled":true,"description":{"content":"Optional [String]: Names of zones [\"port\", \"region\", \"country\", \"continent\"]
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"disabled":true,"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"disabled":true,"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"disabled":true,"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"disabled":true,"description":{"content":"Optional [Boolean]: Default to true if not specified. Include trades predicted by our in-house model when set to \"true\". Use [\"true\", \"false\"]
\n","type":"text/plain"},"key":"withForecast","value":"{{withForecast}}"},{"disabled":true,"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"disabled":true,"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the next endpoint to learn more about how to generate the hash code )
\nNote: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"},{"disabled":true,"description":{"content":"Optional [Boolean]: Default to false if not specified. Provides access to the entire fleet's trades, irrespective of your current cargo subscription. Only available via Freight subscription.
\n","type":"text/plain"},"key":"withFreightView","value":"{{withFreightView}}"},{"disabled":true,"description":{"content":"Optional [Boolean]: Default to false if not specified. Provides access to the empty volume port calls. Only available via Freight subscription.
\n","type":"text/plain"},"key":"withEmptyVolume","value":"{{withEmptyVolume}}"}],"variable":[]}},"response":[{"id":"07012aee-15c2-4859-9989-dea608765b81","name":"Retrieve columns using hash","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/port-calls?hash=YOUR_HASH","protocol":"https","host":["api","kpler","com"],"path":["v1","port-calls"],"query":[{"key":"hash","value":"YOUR_HASH"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null},{"id":"689498a7-adff-4980-ae2e-ea6a33b39554","name":"Liquids - List of few port-calls for Condensate and Blending Comps products","originalRequest":{"method":"GET","header":[{"key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN","description":"Required [String] : Token"}],"url":{"raw":"https://api.kpler.com/v1/port-calls?products=Condensate, Blending Comps","protocol":"https","host":["api","kpler","com"],"path":["v1","port-calls"],"query":[{"key":"products","value":"Condensate, Blending Comps"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Vessel;Installation;ETA;Start;End;Volume (bbl);Family;Group;Product;Grade\nMarkos I;;2020-08-14 23:47;;;-316195;Light Ends;Blendings;Blending Comps;MTBE\nAramon;;2020-08-05 08:38;;;-505782;Dirty;crude/co;condensate;\nBow Pioneer;;2020-08-05 03:15;;;-446299;Light Ends;Blendings;Blending Comps;Reformate\nLake Trout;;2020-08-01 04:19;;;-502599;Dirty;crude/co;condensate;\nTorm Venture;;2020-07-27 10:34;;;-503404;Light Ends;Blendings;Blending Comps;Alkylate\nBesiktas Dardanelles;;2020-07-18 09:12;;;-1076507;Dirty;crude/co;condensate;\nSeaenvoy;;2020-07-15 00:57;;;-407302;Light Ends;Blendings;Clean Condensate;\nMaistros;;2020-07-14 18:02;;;-118443;Clean;;;\nMaistros;;2020-07-14 18:02;;;-382527;Dirty;crude/co;condensate;"},{"id":"cad4ca6e-8f0f-4683-8b52-b22ae605df37","name":"OIL - List of few port-calls in Enterprise Houston, United States, for vessel Eagle Kuantan","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/port-calls?installations=Enterprise Houston&zones=United States&vessels=Eagle Kuantan&columns=all","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","port-calls"],"query":[{"key":"installations","value":"Enterprise Houston"},{"key":"zones","value":"United States"},{"key":"vessels","value":"Eagle Kuantan"},{"key":"columns","value":"all"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Forecasted;Confidence;Id (portCall);Vessel;Location;Installation;zone;Country;ETA;Start;End;Family;Group;Product;Grade;Volume (m3);Volume (bbl);Cargo (tons);Charterer;Reexport;PartialCargo;Ship to ship;IMO (vessel);MMSI (vessel);Capacity (m3);Cargo type (vessel);Vessel type;Id (vessel);Id (installation);Id (zone);Type (installation);SubContinent;Continent;Storage capacity (installation);Status (installation);Id (voyage);Grade API;Grade Sulfur;Berth Name\nfalse;;347335260;Eagle Kuantan;Enterprise Houston;Enterprise Houston;Houston;United States;2020-05-23 18:00;2020-05-24 01:42;2020-05-25 17:18;Dirty;crude/co;;;111291.0;699999;91926;;false;false;false;9417012;565949000;121065;;Aframax;80961;1637;2957;Oil Product Export Terminal;Northern America;Americas;;Active;30317144;;;Enterprise Houston Berth 2\nfalse;;340909376;Eagle Kuantan;Enterprise Houston;Enterprise Houston;Houston;United States;2018-12-26 00:22;2018-12-24 18:03;2018-12-26 13:30;Dirty;crude/co;;;103342.0;650001;85360;;false;false;false;9417012;565949000;121065;;Aframax;80961;1637;2957;Oil Product Export Terminal;Northern America;Americas;;Active;26245714;;;Enterprise Houston Berth"},{"id":"ddfa86b6-3b68-4cb6-8535-e483b64b43e7","name":"CPP - List of few port-calls in West Coast India for Diesel","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-cpp.kpler.com/v1/port-calls?zones=West Coast India&products=Diesel&columns=all","protocol":"https","host":["api-cpp","kpler","com"],"path":["v1","port-calls"],"query":[{"key":"zones","value":"West Coast India"},{"key":"products","value":"Diesel"},{"key":"columns","value":"all"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Forecasted;Confidence;Id (portCall);Vessel;Location;Installation;zone;Country;ETA;Start;End;Family;Group;Product;Grade;Volume (m3);Volume (bbl);Cargo (tons);Charterer;Reexport;PartialCargo;Ship to ship;IMO (vessel);MMSI (vessel);Capacity (m3);Cargo type (vessel);Vessel type;Id (vessel);Id (installation);Id (zone);Type (installation);SubContinent;Continent;Storage capacity (installation);Status (installation);Id (voyage);Grade API;Grade Sulfur;Berth Name\nfalse;;348174697;Spetses Lady;Sikka;;Sikka;India;2020-07-01 00:00;;;Middle Distillates;Gasoil/Diesel;Diesel;ULSD;119897.0;754129;101073;;false;false;false;9831074;563087400;121722;;LR2;102851;;2358;;South-Central Asia;Asia;;;30388437;;;\nfalse;;348221040;Athinea;Sikka;;Sikka;India;2020-06-25 00:00;;;Middle Distillates;Gasoil/Diesel;Diesel;ULSD;115362.0;725605;97250;;false;false;false;9291248;240420000;117119;;LR2;73682;;2358;;South-Central Asia;Asia;;;30407801;;;"},{"id":"ffe94d89-61d3-4c71-a03d-9f1b2254fa9c","name":"Columns id, name, description and deprecation status","originalRequest":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/port-calls/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"Columns by default\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_name\",\n \"shortId\": \"inn\",\n \"columnName\": \"Installation\",\n \"description\": \"Name of the installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"eta\",\n \"shortId\": \"eta\",\n \"columnName\": \"ETA\",\n \"description\": \"Estimated date and time of arrival at next destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"sta\",\n \"columnName\": \"Start\",\n \"description\": \"Date and Time when the vessel started berthing at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"End\",\n \"description\": \"Date and Time of vessel departure from the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n }\n ],\n \"Optional Columns\": [\n {\n \"id\": \"berth_name\",\n \"shortId\": \"bn\",\n \"columnName\": \"Berth Name\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"ccm\",\n \"columnName\": \"Capacity (m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"cty\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"chartererName\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current controller of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"confidence\",\n \"shortId\": \"con\",\n \"columnName\": \"Confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_name\",\n \"shortId\": \"ctn\",\n \"columnName\": \"Continent\",\n \"description\": \"Zone location where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"country_name\",\n \"shortId\": \"cyn\",\n \"columnName\": \"Country\",\n \"description\": \"Name of the country\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_forecasted\",\n \"shortId\": \"isf\",\n \"columnName\": \"Forecasted\",\n \"description\": \"TRUE if this port call has been forecasted automatically by our system\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulphur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": \"IMO (vessel)\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_id\",\n \"shortId\": \"iid\",\n \"columnName\": \"Id (installation)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_id\",\n \"shortId\": \"pid\",\n \"columnName\": \"Id (portCall)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_id\",\n \"shortId\": \"zid\",\n \"columnName\": \"Id (zone)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"location_name\",\n \"shortId\": \"lon\",\n \"columnName\": \"Location\",\n \"description\": \"Specific location where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"mms\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": \"The Maritime Mobile Service Identity of the vessel (9 digits)\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_partial_cargo\",\n \"shortId\": \"isp\",\n \"columnName\": \"PartialCargo\",\n \"description\": \"TRUE if the vessel is partially loaded\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_reexport\",\n \"shortId\": \"isr\",\n \"columnName\": \"Reexport\",\n \"description\": \"TRUE if re-export has occurred\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_sts\",\n \"shortId\": \"iss\",\n \"columnName\": \"Ship to ship\",\n \"description\": \"TRUE if ship to ship transfer has occurred\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_status\",\n \"shortId\": \"ins\",\n \"columnName\": \"Status (installation)\",\n \"description\": \"Current status of the Installation (Active, Inactive, Under Construction, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_storage_capacity\",\n \"shortId\": \"isc\",\n \"columnName\": \"Storage capacity (installation)\",\n \"description\": \"Storage capacity of the installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"sub_continent_name\",\n \"shortId\": \"scn\",\n \"columnName\": \"SubContinent\",\n \"description\": \"Subcontinent where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_type\",\n \"shortId\": \"ity\",\n \"columnName\": \"Type (installation)\",\n \"description\": \"Specific type of installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"typ\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of vessel (Q-Flex,Q-Max, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"flow_quantity_cubic_meters\",\n \"shortId\": \"fqm\",\n \"columnName\": \"Volume (m3)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"zone_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"zone\",\n \"description\": \"Area where the port call is registered\",\n \"deprecated\": false\n }\n ]\n}"}],"_postman_id":"68a12bed-3481-4031-953e-2f1ed407d58f"},{"name":"/v1/port-calls/columns","event":[{"listen":"test","script":{"id":"62f08e8b-1b3c-47c8-8a67-df95a856cc37","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"26e1f6d4-f537-4d2b-9bf0-f5363d703540","exec":[""],"type":"text/javascript"}}],"id":"88feedc1-9353-4bce-99c5-b4ea4f29074e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"Required [String]: application/json or text/json
\n","type":"text"}],"body":{"mode":"raw","raw":"[\n \"berth_name\"\n]"},"url":"{{HOST_URL}}/v1/port-calls/columns","description":"What is {{HOST_URL}} and where do we find it?
\nTo prevent breaking changes, we strongly recommend you to not use the “all” or the default value for the 'column’ parameter as these may occasionally change.
\nTherefore we have added this endpoint which allows you to get a hash code for the set of columns that you wish to add on your query.
\nNote: The set of columns defined with the hash code will never change and will always remain the same.
\nIn this example, we have created a hash code that will always return the following columns:
\nRequired [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"description":"Required [String]: application/json or text/json
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"https://api.kpler.com/v1/port-calls/columns","description":"What is {{HOST_URL}} and where do we find it?
\nThis endpoint returns a recent and updated list of all columns available for the endpoint port-calls.
\n","urlObject":{"protocol":"https","path":["v1","port-calls","columns"],"host":["api","kpler","com"],"query":[],"variable":[]}},"response":[{"id":"cfca072b-9d3d-450c-ba70-54368d02d256","name":"List of all columns","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"description":"**Required [String]**: **application/json** or **text/json**","key":"Content-Type","type":"text","value":"application/json"}],"url":"https://api.kpler.com/v1/port-calls/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"selected\": [\n {\n \"id\": \"vessel_name\",\n \"shortId\": \"ven\",\n \"columnName\": \"Vessel\",\n \"description\": \"Name of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_name\",\n \"shortId\": \"inn\",\n \"columnName\": \"Installation\",\n \"description\": \"Name of the installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"eta\",\n \"shortId\": \"eta\",\n \"columnName\": \"ETA\",\n \"description\": \"Estimated date and time of arrival at next destination\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"sta\",\n \"columnName\": \"Start\",\n \"description\": \"Date and Time when the vessel started berthing at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"End\",\n \"description\": \"Date and Time of vessel departure from the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n }\n ],\n \"unselected\": [\n {\n \"id\": \"berth_name\",\n \"shortId\": \"bn\",\n \"columnName\": \"Berth Name\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_capacity_cubic_meters\",\n \"shortId\": \"ccm\",\n \"columnName\": \"Capacity (m3)\",\n \"description\": \"The maximum capacity of the vessel in cubic meters\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_tons_split_by_product\",\n \"shortId\": \"cotsp\",\n \"columnName\": \"Cargo (tons)\",\n \"description\": \"Quantity (tons) loaded/discharged at the terminal\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_cargo_type\",\n \"shortId\": \"cty\",\n \"columnName\": \"Cargo type (vessel)\",\n \"description\": \"The specific cargo type of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"chartererName\",\n \"shortId\": \"chn\",\n \"columnName\": \"Charterer\",\n \"description\": \"Current controller of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"confidence\",\n \"shortId\": \"con\",\n \"columnName\": \"Confidence\",\n \"description\": \"Confidence (in %) of the system forecast\",\n \"deprecated\": false\n },\n {\n \"id\": \"continent_name\",\n \"shortId\": \"ctn\",\n \"columnName\": \"Continent\",\n \"description\": \"Zone location where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"country_name\",\n \"shortId\": \"cyn\",\n \"columnName\": \"Country\",\n \"description\": \"Name of the country\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_forecasted\",\n \"shortId\": \"isf\",\n \"columnName\": \"Forecasted\",\n \"description\": \"TRUE if this port call has been forecasted automatically by our system\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulphur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_imo\",\n \"shortId\": \"imo\",\n \"columnName\": \"IMO (vessel)\",\n \"description\": \"IMO (vessel)\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_id\",\n \"shortId\": \"iid\",\n \"columnName\": \"Id (installation)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"port_call_id\",\n \"shortId\": \"pid\",\n \"columnName\": \"Id (portCall)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_id\",\n \"shortId\": \"vid\",\n \"columnName\": \"Id (vessel)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"voyage_id\",\n \"shortId\": \"voy\",\n \"columnName\": \"Id (voyage)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_id\",\n \"shortId\": \"zid\",\n \"columnName\": \"Id (zone)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"location_name\",\n \"shortId\": \"lon\",\n \"columnName\": \"Location\",\n \"description\": \"Specific location where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_mmsi\",\n \"shortId\": \"mms\",\n \"columnName\": \"MMSI (vessel)\",\n \"description\": \"The Maritime Mobile Service Identity of the vessel (9 digits)\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_partial_cargo\",\n \"shortId\": \"isp\",\n \"columnName\": \"PartialCargo\",\n \"description\": \"TRUE if the vessel is partially loaded\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_reexport\",\n \"shortId\": \"isr\",\n \"columnName\": \"Reexport\",\n \"description\": \"TRUE if re-export has occurred\",\n \"deprecated\": false\n },\n {\n \"id\": \"is_sts\",\n \"shortId\": \"iss\",\n \"columnName\": \"Ship to ship\",\n \"description\": \"TRUE if ship to ship transfer has occurred\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_status\",\n \"shortId\": \"ins\",\n \"columnName\": \"Status (installation)\",\n \"description\": \"Current status of the Installation (Active, Inactive, Under Construction, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_storage_capacity\",\n \"shortId\": \"isc\",\n \"columnName\": \"Storage capacity (installation)\",\n \"description\": \"Storage capacity of the installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"sub_continent_name\",\n \"shortId\": \"scn\",\n \"columnName\": \"SubContinent\",\n \"description\": \"Subcontinent where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"installation_type\",\n \"shortId\": \"ity\",\n \"columnName\": \"Type (installation)\",\n \"description\": \"Specific type of installation\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_type\",\n \"shortId\": \"typ\",\n \"columnName\": \"Vessel type\",\n \"description\": \"Type of vessel (Q-Flex,Q-Max, etc.)\",\n \"deprecated\": false\n },\n {\n \"id\": \"flow_quantity_cubic_meters\",\n \"shortId\": \"fqm\",\n \"columnName\": \"Volume (m3)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"zone_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"zone\",\n \"description\": \"Area where the port call is registered\",\n \"deprecated\": false\n }\n ]\n}"}],"_postman_id":"0005d918-9039-4caf-abfe-b0ca0e51cd7f"}],"id":"2dc697c8-1953-4d6d-92b4-8a9b099a1805","description":"The Port Calls query returns the cargo-by-cargo details for loadings/discharges taking place in a point of interest (installation/zone). Historical data goes back to 2013.
\nIn order to select specific columns to display, please use the column ids explicited in the example called Columns id, name, description and deprecation status.
\n","event":[{"listen":"prerequest","script":{"id":"8ff82b7e-dc0c-42bc-9c4d-79de12b7c15d","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"afd66a52-c4a2-406b-9981-4006e87896e4","type":"text/javascript","exec":[""]}}],"_postman_id":"2dc697c8-1953-4d6d-92b4-8a9b099a1805","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Ship-to-ships","item":[{"name":"/v1/ship-to-ships","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"6685f7ad-53d1-4082-9d9b-4abcb30fe489","exec":[""],"type":"text/javascript"}}],"id":"71a12e00-cf35-4fdf-a50a-331d1b8ad0e5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"{{HOST_URL}}/v1/ship-to-ships?size={{size}}&vessels={{vessels}}&zones={{zones}}&products={{products}}&startDate={{startDate}}&endDate={{endDate}}&columns={{columns}}&hash={{hash}}","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","ship-to-ships"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Optional [Integer]: Maximum number of sts returned
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"description":{"content":"Optional [String]: Names/IMOs of vessels
\n","type":"text/plain"},"key":"vessels","value":"{{vessels}}"},{"description":{"content":"Optional [String]: Names of zones [\"port\", \"lightering\", \"region\", \"country\", \"continent\"]
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the next endpoint to learn more about how to generate the hash code )
\nNote: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"}],"variable":[]}},"response":[{"id":"779b346a-df95-400e-ae48-c7f80bce5f9b","name":"Liquids - Last Ship to Ship operations in Galveston Light. after 2020-06-01, where exchanged cargo is Crude/co and children [No \"View more\" on the example]","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/ship-to-ships?zones=Galveston Light.&startDate=2020-06-01&products=crude/co&columns=all","protocol":"https","host":["api","kpler","com"],"path":["v1","ship-to-ships"],"query":[{"key":"zones","value":"Galveston Light."},{"key":"startDate","value":"2020-06-01"},{"key":"products","value":"crude/co"},{"key":"columns","value":"all"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Vessel (load);IMO (load);Vessel (discharge);IMO (discharge);Volume (bbl);Family;Group;Product;Grade;Zone;Start;End\nEpiskopi;9205067;Kriti Vigor;9290397;1030824;Dirty;crude/co;;;Dubai Light.;2019-08-11 13:38;2019-08-12 08:08\nKriti Island;9185528;Kriti Vigor;9290397;1030975;Dirty;crude/co;crude;Basrah Lt.;Dubai Light.;2019-08-01 02:03;2019-08-02 14:11\nKriti Diamond;9249075;Kriti Vigor;9290397;999998;Dirty;crude/co;crude;Basrah Lt.;Dubai Light.;2019-07-24 12:21;2019-07-25 21:57\nKriti Breeze;9250737;Kriti Vigor;9290397;953918;Dirty;crude/co;crude;Basrah Lt.;Dubai Light.;2019-07-11 07:15;2019-07-11 23:29\nKriti Spirit;9207027;Kriti Vigor;9290397;997997;Dirty;crude/co;crude;Basrah Hy.;Dubai Light.;2019-06-28 18:59;2019-06-30 13:02"},{"id":"8af73609-f3fe-4325-90c1-e3d786963228","name":"OIL - Last Ship to Ship operations in Galveston Light. after 2020-06-01, where exchanged cargo is Crude/co and children","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/ship-to-ships?zones=Galveston Light.&startDate=2020-06-01&products=crude/co&columns=all","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","ship-to-ships"],"query":[{"key":"zones","value":"Galveston Light."},{"key":"startDate","value":"2020-06-01"},{"key":"products","value":"crude/co"},{"key":"columns","value":"all"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Vessel (load);IMO (load);Vessel (discharge);IMO (discharge);Volume (bbl);Family;Group;Product;Grade;Zone;Start;End;Zone Id;Voyage Id (load);Voyage Id (discharge);Vessel type (load);Vessel type (discharge);Vessel id (load);Vessel id (discharge);Vessel capacity (load);Vessel capacity (discharge);Vessel ETA (load);Vessel ETA (discharge);STS Id;PortCall Id (load);PortCall Id (discharge);Country Id;Country;Grade API;Grade Sulfur\nEsther Spirit;9282053;Wedyan;9524970;769268;Dirty;crude/co;crude;Arab;Galveston Light.;2020-06-16 08:27;2020-06-16 11:14;1293;30407731;30174315;Aframax;ULCC;73002;86938;124167;345974;;;348220841;348220840;348220841;947;United States;;\nYasa Golden Marmara;9337341;Anne;9722936;789924;Dirty;crude/co;crude;Arab;Galveston Light.;2020-06-13 23:23;2020-06-14 20:02;1293;30395057;30405173;Aframax;VLCC;76754;97378;127500;322754;;;348190449;348190448;348190449;947;United States;;"},{"id":"c2fe8dc0-b04b-4e48-bcf1-5802c3a0bc45","name":"CPP - Last Ship to Ship operations in Lome Light. between 2018-06-01 and 2019-01-01","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-cpp.kpler.com/v1/ship-to-ships?zones=Lome Light.&startDate=2018-06-01&endDate=2019-01-01","protocol":"https","host":["api-cpp","kpler","com"],"path":["v1","ship-to-ships"],"query":[{"key":"zones","value":"Lome Light."},{"key":"startDate","value":"2018-06-01"},{"key":"endDate","value":"2019-01-01"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Vessel (load);IMO (load);Vessel (discharge);IMO (discharge);Volume (bbl);Family;Group;Product;Grade;Zone;Start;End\nAvenca;9410002;Lioness;9285744;72458;Clean;;;;Lome Light.;2019-01-01 10:45;2019-01-02 10:14\nHistria Ivory;9356244;Nissos Christiana;9694658;26272;Light Ends;Gasoline/Naphtha;Gasoline;;Lome Light.;2019-01-01 09:01;2019-01-01 22:07\nHistria Ivory;9356244;Sea Shell;9773947;212111;Light Ends;Gasoline/Naphtha;Gasoline;;Lome Light.;2018-12-30 08:01;2019-01-01 06:59\nBsl Elsa;9433901;Avenca;9410002;353625;Light Ends;Gasoline/Naphtha;Gasoline;;Lome Light.;2018-12-30 07:41;2018-12-31 01:16\nSea Shell;9773947;River Shiner;9289752;117556;Light Ends;Gasoline/Naphtha;Gasoline;;Lome Light.;2018-12-27 08:58;2018-12-27 17:54\nSea Shell;9773947;River Shiner;9289752;174561;Middle Distillates;Gasoil/Diesel;Diesel;ULSD;Lome Light.;2018-12-27 08:58;2018-12-27 17:54\nMtm Colorado;9278052;Estia;9327035;341517;Light Ends;Gasoline/Naphtha;Gasoline;;Lome Light.;2018-12-26 02:19;2018-12-27 16:06\nMarlin Ametrine;9697234;River Shiner;9289752;211865;Light Ends;Gasoline/Naphtha;Gasoline;;Lome Light.;2018-12-25 10:46;2018-12-26 13:30\nSea Shell;9773947;Maersk Petrel;9306639;460175;Clean;;;;Lome Light.;2018-12-23 15:00;2018-12-24 17:58"},{"id":"cc3517a6-174f-4151-a5f1-c96292cfcdb5","name":"Columns id, name, description and deprecation status","originalRequest":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/ship-to-ships/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"Columns by default\": [\n {\n \"id\": \"load_vessel_name\",\n \"shortId\": \"lvn\",\n \"columnName\": \"Vessel (load)\",\n \"description\": \"Name of the vessel load\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_imo\",\n \"shortId\": \"lim\",\n \"columnName\": \"IMO (load)\",\n \"description\": \"IMO of the vessel load\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_name\",\n \"shortId\": \"dvn\",\n \"columnName\": \"Vessel (discharge)\",\n \"description\": \"Name of the vessel discharge\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_imo\",\n \"shortId\": \"dim\",\n \"columnName\": \"IMO (discharge)\",\n \"description\": \"IMO of the vessel discharge\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": \"Volume in bbl transfered between the ships\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": \"Product type\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"Zone\",\n \"description\": \"Area where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"sta\",\n \"columnName\": \"Start\",\n \"description\": \"Start Datetime of the ship to ship\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"End\",\n \"description\": \"End Datetime of the ship to ship\",\n \"deprecated\": false\n }\n ],\n \"Optional Columns\": [\n {\n \"id\": \"country_name\",\n \"shortId\": \"con\",\n \"columnName\": \"Country\",\n \"description\": \"Country where the transfer is happening\",\n \"deprecated\": false\n },\n {\n \"id\": \"country_id\",\n \"shortId\": \"cid\",\n \"columnName\": \"Country Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulfur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_port_call_id\",\n \"shortId\": \"did\",\n \"columnName\": \"PortCall Id (discharge)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_port_call_id\",\n \"shortId\": \"lid\",\n \"columnName\": \"PortCall Id (load)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_id\",\n \"shortId\": \"sid\",\n \"columnName\": \"STS Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_eta_discharge\",\n \"shortId\": \"ved\",\n \"columnName\": \"Vessel ETA (discharge)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_eta_load\",\n \"shortId\": \"vel\",\n \"columnName\": \"Vessel ETA (load)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_capacity\",\n \"shortId\": \"dvc\",\n \"columnName\": \"Vessel capacity (discharge)\",\n \"description\": \"Capacity of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_capacity\",\n \"shortId\": \"lvc\",\n \"columnName\": \"Vessel capacity (load)\",\n \"description\": \"Capacity of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_id\",\n \"shortId\": \"dbi\",\n \"columnName\": \"Vessel id (discharge)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_id\",\n \"shortId\": \"lbi\",\n \"columnName\": \"Vessel id (load)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_type\",\n \"shortId\": \"dvt\",\n \"columnName\": \"Vessel type (discharge)\",\n \"description\": \"Type of the vessel discharging\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_type\",\n \"shortId\": \"lvt\",\n \"columnName\": \"Vessel type (load)\",\n \"description\": \"Type of the vessel discharging\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_voyage_id\",\n \"shortId\": \"dvi\",\n \"columnName\": \"Voyage Id (discharge)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_voyage_id\",\n \"shortId\": \"lvi\",\n \"columnName\": \"Voyage Id (load)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_id\",\n \"shortId\": \"zid\",\n \"columnName\": \"Zone Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n }\n ]\n}"},{"id":"f7e386ff-ca5c-43c8-8dab-0faf27c3cc2e","name":"Retrieve columns using hash","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/ship-to-ships?hash=YOUR_HASH","protocol":"https","host":["api","kpler","com"],"path":["v1","ship-to-ships"],"query":[{"key":"hash","value":"YOUR_HASH"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":""}],"_postman_id":"71a12e00-cf35-4fdf-a50a-331d1b8ad0e5"},{"name":"/v1/ship-to-ships/columns","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"6685f7ad-53d1-4082-9d9b-4abcb30fe489","exec":[""],"type":"text/javascript"}}],"id":"8f76ddb9-d5d1-47b3-85d1-0630763fd683","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"Required [String]: application/json or text/json
\n","type":"text"}],"body":{"mode":"raw","raw":"[\n \"load_vessel_name\",\n \"discharge_vessel_name\"\n]"},"url":"{{HOST_URL}}/v1/ship-to-ships/columns","description":"What is {{HOST_URL}} and where do we find it?
\nTo prevent breaking changes, we strongly recommend you to not use the “all” or the default value for the 'column’ parameter as these may occasionally change.
\nTherefore we have added this endpoint which allows you to get a hash code for the set of columns that you wish to add on your query.
\nNote: The set of columns defined with the hash code will never change and will always remain the same.
\nIn this example, we have created a hash code that will always return the following columns:
\nRequired [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"Required [String]: application/json or text/json
\n","type":"text"}],"url":"{{HOST_URL}}/v1/ship-to-ships/columns","description":"What is {{HOST_URL}} and where do we find it?
\nThis endpoint returns a recent and updated list of all columns available for the endpoint ship-to-ships.
\n","urlObject":{"path":["v1","ship-to-ships","columns"],"host":["{{HOST_URL}}"],"query":[],"variable":[]}},"response":[{"id":"bdb88249-3081-487b-b8f5-8d7a9014a9e4","name":"List of all columns","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"**Required [String]**: **application/json** or **text/json**","type":"text"}],"url":"https://api.kpler.com/v1/ship-to-ships/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"selected\": [\n {\n \"id\": \"load_vessel_name\",\n \"shortId\": \"lvn\",\n \"columnName\": \"Vessel (load)\",\n \"description\": \"Name of the vessel load\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_imo\",\n \"shortId\": \"lim\",\n \"columnName\": \"IMO (load)\",\n \"description\": \"IMO of the vessel load\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_name\",\n \"shortId\": \"dvn\",\n \"columnName\": \"Vessel (discharge)\",\n \"description\": \"Name of the vessel discharge\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_imo\",\n \"shortId\": \"dim\",\n \"columnName\": \"IMO (discharge)\",\n \"description\": \"IMO of the vessel discharge\",\n \"deprecated\": false\n },\n {\n \"id\": \"cargo_origin_barrels_split_by_product\",\n \"shortId\": \"cobsp\",\n \"columnName\": \"Volume (bbl)\",\n \"description\": \"Volume in bbl transfered between the ships\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_family\",\n \"shortId\": \"cafam\",\n \"columnName\": \"Family\",\n \"description\": \"Product family\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_group\",\n \"shortId\": \"cagroup\",\n \"columnName\": \"Group\",\n \"description\": \"Product group\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_product\",\n \"shortId\": \"capro\",\n \"columnName\": \"Product\",\n \"description\": \"Product type\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade\",\n \"shortId\": \"cagrade\",\n \"columnName\": \"Grade\",\n \"description\": \"Product grade\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_name\",\n \"shortId\": \"zon\",\n \"columnName\": \"Zone\",\n \"description\": \"Area where the port call is registered\",\n \"deprecated\": false\n },\n {\n \"id\": \"start\",\n \"shortId\": \"sta\",\n \"columnName\": \"Start\",\n \"description\": \"Start Datetime of the ship to ship\",\n \"deprecated\": false\n },\n {\n \"id\": \"end\",\n \"shortId\": \"end\",\n \"columnName\": \"End\",\n \"description\": \"End Datetime of the ship to ship\",\n \"deprecated\": false\n }\n ],\n \"unselected\": [\n {\n \"id\": \"country_name\",\n \"shortId\": \"con\",\n \"columnName\": \"Country\",\n \"description\": \"Country where the transfer is happening\",\n \"deprecated\": false\n },\n {\n \"id\": \"country_id\",\n \"shortId\": \"cid\",\n \"columnName\": \"Country Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_api\",\n \"shortId\": \"cagradeapi\",\n \"columnName\": \"Grade API\",\n \"description\": \"API grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"closest_ancestor_grade_sulfur\",\n \"shortId\": \"cagradesulfur\",\n \"columnName\": \"Grade Sulfur\",\n \"description\": \"Sulfur grade of the product\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_port_call_id\",\n \"shortId\": \"did\",\n \"columnName\": \"PortCall Id (discharge)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_port_call_id\",\n \"shortId\": \"lid\",\n \"columnName\": \"PortCall Id (load)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"ship_to_ship_id\",\n \"shortId\": \"sid\",\n \"columnName\": \"STS Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_eta_discharge\",\n \"shortId\": \"ved\",\n \"columnName\": \"Vessel ETA (discharge)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"vessel_eta_load\",\n \"shortId\": \"vel\",\n \"columnName\": \"Vessel ETA (load)\",\n \"description\": null,\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_capacity\",\n \"shortId\": \"dvc\",\n \"columnName\": \"Vessel capacity (discharge)\",\n \"description\": \"Capacity of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_capacity\",\n \"shortId\": \"lvc\",\n \"columnName\": \"Vessel capacity (load)\",\n \"description\": \"Capacity of the vessel\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_id\",\n \"shortId\": \"dbi\",\n \"columnName\": \"Vessel id (discharge)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_id\",\n \"shortId\": \"lbi\",\n \"columnName\": \"Vessel id (load)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_vessel_type\",\n \"shortId\": \"dvt\",\n \"columnName\": \"Vessel type (discharge)\",\n \"description\": \"Type of the vessel discharging\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_vessel_type\",\n \"shortId\": \"lvt\",\n \"columnName\": \"Vessel type (load)\",\n \"description\": \"Type of the vessel discharging\",\n \"deprecated\": false\n },\n {\n \"id\": \"discharge_voyage_id\",\n \"shortId\": \"dvi\",\n \"columnName\": \"Voyage Id (discharge)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"load_voyage_id\",\n \"shortId\": \"lvi\",\n \"columnName\": \"Voyage Id (load)\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n },\n {\n \"id\": \"zone_id\",\n \"shortId\": \"zid\",\n \"columnName\": \"Zone Id\",\n \"description\": \"Identifier in the database of Kpler\",\n \"deprecated\": false\n }\n ]\n}"}],"_postman_id":"3b8239ed-ba3c-4419-af61-2a6bb209966f"}],"id":"e5ca34c7-0c8d-4ce0-ab1c-4622020534a9","description":"The STS (ship-to-ship) query returns the ship-to-ship loadings/discharges in a given\nzone,with details on the vessels taking part in the operation and crude grades being exchanged for a given time period.
\nIn order to select specific columns to display, please use the column ids explicited in the example called Columns id, name, description and deprecation status.
\n","event":[{"listen":"prerequest","script":{"id":"74896653-714e-484a-8acc-0d1c6693fa32","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"ca9ab749-a813-4cf2-97d5-ebaccacb1e24","type":"text/javascript","exec":[""]}}],"_postman_id":"e5ca34c7-0c8d-4ce0-ab1c-4622020534a9","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Fleet Metrics","item":[{"name":"/v1/fleet-metrics","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"8fcb09c7-2f87-4c13-9703-f93d6d9fba49","exec":[""],"type":"text/javascript"}}],"id":"2e17612c-5d49-4a5e-8de3-4a80d31ca1de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"{{HOST_URL}}/v1/fleet-metrics?metric={{metric}}&zones={{zones}}&floatingStorageDurationMin={{floatingStorageDurationMin}}&floatingStorageDurationMax={{floatingStorageDurationMax}}&period={{period}}&startDate={{startDate}}&endDate={{endDate}}&products={{products}}&unit={{unit}}&split={{split}}&vesselTypes={{vesselTypes}}&vesselTypesAlt={{vesselTypesAlt}}&splitValues={{splitValues}}&withProductEstimation={{withProductEstimation}}","description":"What is {{HOST_URL}} and where do we find it?
\nRetrieve the daily/weekly fleet data aggregated for a given zone.
\nAvailable for all the fleet metrics.
\nWe provide you with a CSV file containing zones available for search. Download file.
\nNote: The units can change according to the metric that you have chosen. Please find below the list of default units if the parameter \"unit\" is not specified in your request:
\nRequired [String]: Use following metrics: \n
Optional [String]: Names of countries/geographical zones. Default to world if not specified.
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"description":{"content":"Minimum floating days [7-10-12-15-20-30-90].
\nNote: Required for metric floating_storage
\n","type":"text/plain"},"key":"floatingStorageDurationMin","value":"{{floatingStorageDurationMin}}"},{"description":{"content":"Maximum floating days [7-10-12-15-20-30-90-Inf].
\nNote: Required for metric floating_storage
\n","type":"text/plain"},"key":"floatingStorageDurationMax","value":"{{floatingStorageDurationMax}}"},{"description":{"content":"Optional [String]: Use [\"daily\", \"weekly\", \"eia\"]. Weekly by default if not specified
\n","type":"text/plain"},"key":"period","value":"{{period}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [String]: Use [\"bbl\", \"kb\", \"mmbbl\", \"mt\", \"kt\", \"t\", \"cm\"]. Default to bbl if not specified.
\n","type":"text/plain"},"key":"unit","value":"{{unit}}"},{"description":{"content":"Optional [String]: Use following splits: [\"Total\", \"Grades\", \"Products\", \"Crude Quality\", \"Origin Countries\", \"Destination Countries\", \"Origin Continents\", \"Destination Continents\", \"Origin Subcontinents\", \"Destination Subcontinents\", \"Origin Trading Regions\", \"Destination Trading Regions\", \"Origin Ports\", \"Destination Ports\", \"Origin Installations\", \"Destination Installations\", \"Vessel Type\", \"Vessel Type Oil\", \"Vessel Type Cpp\", \"Trade Status\", \"Sources\", \"Charterers\", \"Buyer\", \"Seller\", \"Current Continents\", \"Current Subcontinents\", \"Current Countries\", \"Current Subregions\", \"Current Seas\", \"Floating Days\"].\nDefault to Total if not specified.
\n","type":"text/plain"},"key":"split","value":"{{split}}"},{"description":{"content":"Optional [String]: For given cpp vessel types\n
Optional [String]: For given oil vessel types\n
Optional [String]: Fix the values and the order of the split
\n","type":"text/plain"},"key":"splitValues","value":"{{splitValues}}"},{"description":{"content":"Optional [Boolean]: Default to false if not specified. Activate the product estimation feature for CPP and Chem/Bio trades only. When set to true, the estimated product will overwrite the existing product information.
\n","type":"text/plain"},"key":"withProductEstimation","value":"{{withProductEstimation}}"}],"variable":[]}},"response":[{"id":"36b811c8-39fd-41e7-9c6c-040758f82e60","name":"Liquids - World daily floating storage (crude/co, LSFO)","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/fleet-metrics?metric=floating_storage&zones=World&floatingStorageDurationMin=7&floatingStorageDurationMax=Inf&products=crude/co, LSFO&unit=kb&period=daily","protocol":"https","host":["api","kpler","com"],"path":["v1","fleet-metrics"],"query":[{"key":"metric","value":"floating_storage","description":"Required [String] : \"floating_storage\" = floating storage volume ; \"loaded_vessels\" = oil-on-water volume ; \"ballast_vessels\" = capacity of ballast tankers at sea ; \"total_vessels\" = capacity of ballast & loaded tankers at sea ; "},{"key":"zones","value":"World"},{"key":"floatingStorageDurationMin","value":"7","description":"Required [String] : Minimum floating days [7-10-12-15-20-30-90]"},{"key":"floatingStorageDurationMax","value":"Inf","description":"Required [String] : Maximum floating days [10-12-15-20-30-90-Inf]"},{"key":"products","value":"crude/co, LSFO"},{"key":"unit","value":"kb"},{"key":"period","value":"daily","description":"Optional [String] : [\"daily\", \"weekly\", \"eia\"]. Weekly by default if not defined."}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Date;Total\n;\n2016-01-01;54852.32\n2016-01-02;56684.92\n2016-01-03;56388.03\n2016-01-04;55528.72\n2016-01-05;62691.25\n2016-01-06;57584.41\n2016-01-07;53877.1\n2016-01-08;56190.05\n2016-01-09;61571.24"},{"id":"5acff7b4-5e15-4764-93de-8819e34573ed","name":"CPP - World weekly loaded vessels","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-cpp.kpler.com/v1/fleet-metrics?metric=loaded_vessels&zones=World&unit=cm&period=weekly","protocol":"https","host":["api-cpp","kpler","com"],"path":["v1","fleet-metrics"],"query":[{"key":"metric","value":"loaded_vessels"},{"key":"zones","value":"World"},{"key":"unit","value":"cm"},{"key":"period","value":"weekly"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;Total\n;\n2016-W52;17155193\n2017-W01;35877840.02\n2017-W02;38038183.02\n2017-W03;39368166.03\n2017-W04;40470819.03\n2017-W05;43961636.05\n2017-W06;43128142.01\n2017-W07;40150073.02\n2017-W08;41052818.02"},{"id":"9856914c-9810-46e9-82a4-ab11c1394b59","name":"OIL - World daily floating storage (crude/co)","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/fleet-metrics?metric=floating_storage&zones=World&floatingStorageDurationMin=7&floatingStorageDurationMax=Inf&products=crude/co&unit=kb&period=daily","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","fleet-metrics"],"query":[{"key":"metric","value":"floating_storage"},{"key":"zones","value":"World"},{"key":"floatingStorageDurationMin","value":"7"},{"key":"floatingStorageDurationMax","value":"Inf"},{"key":"products","value":"crude/co"},{"key":"unit","value":"kb"},{"key":"period","value":"daily"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;Total\n;\n2016-01-01;54358.69\n2016-01-02;56684.92\n2016-01-03;56388.03\n2016-01-04;55528.72\n2016-01-05;62691.25\n2016-01-06;57584.41\n2016-01-07;53877.1\n2016-01-08;56190.05\n2016-01-09;61571.24\n2016-01-10;74441.39\n2016-01-11;70595.15\n2016-01-12;68736.47\n2016-01-13;70056.09"}],"_postman_id":"2e17612c-5d49-4a5e-8de3-4a80d31ca1de"},{"name":"/v1/fleet-metrics/vessels","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"8fcb09c7-2f87-4c13-9703-f93d6d9fba49","exec":[""],"type":"text/javascript"}}],"id":"d917a113-5551-42ae-98d4-9d1822dd3cc9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"{{HOST_URL}}/v1/fleet-metrics/vessels?metric={{metric}}&floatingStorageDurationMin={{floatingStorageDurationMin}}&floatingStorageDurationMax={{floatingStorageDurationMax}}&zones={{zones}}&products={{products}}&unit={{unit}}&startDate={{startDate}}&endDate={{endDate}}&vesselTypes={{vesselTypes}}&vesselTypesAlt={{vesselTypesAlt}}&withProductEstimation={{withProductEstimation}}","description":"What is {{HOST_URL}} and where do we find it?
\nThrought this endpoint you can retrieve a list of all individual trades that are being used for composing \"Fleet Metrics\" Total numbers and perform more granular analysis.
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","fleet-metrics","vessels"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Required [String]: Use following metrics:\n
Minimum floating days [7-10-12-15-20-30-90]
\nNote: Required for metric floating_storage
\n","type":"text/plain"},"key":"floatingStorageDurationMin","value":"{{floatingStorageDurationMin}}"},{"description":{"content":"Maximum floating days [7-10-12-15-20-30-90-Inf]
\nNote: Required for metric floating_storage
\n","type":"text/plain"},"key":"floatingStorageDurationMax","value":"{{floatingStorageDurationMax}}"},{"description":{"content":"Optional [String]: Names of countries/geographical zones. Default to world if not specified.
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"description":{"content":"Optional [String]: Names of products - Default to all available products if not specified
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [String]: Use ['bbl', 'kb', 'mmbbl', 'mt', 'kt', 't', 'cm']. Default to bbl if not specified.
\n","type":"text/plain"},"key":"unit","value":"{{unit}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: For given cpp vessel types\n
\nUse [\"LR2\", \"VLCC\", \"LR3\", \"MR\", \"GP\", \"LR1\"]\n
\nNotes:
Optional [String]: For given oil vessel types\n
\nUse [\"Aframax\", \"Product Tanker\", \"Suezmax\", \"VLCC\", \"Panamax\", \"ULCC\"]\n
\nNotes:
Optional [Boolean]: Default to false if not specified. Activate the product estimation feature for CPP and Chem/Bio trades only. When set to true, the estimated product will overwrite the existing product information.
\n","type":"text/plain"},"key":"withProductEstimation","value":"{{withProductEstimation}}"}],"variable":[]}},"response":[{"id":"162f9a63-e1d2-4ff0-b958-8af5f5092008","name":"Liquids - September 2020 World LSFO Floating Storage","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/fleet-metrics/vessels?metric=floating_storage&zones=world&unit=kt&products=LSFO&floatingStorageDurationMin=7&floatingStorageDurationMax=Inf&startDate=2020-09-01&endDate=2020-09-30","protocol":"https","host":["api","kpler","com"],"path":["v1","fleet-metrics","vessels"],"query":[{"key":"metric","value":"floating_storage"},{"key":"zones","value":"world"},{"key":"unit","value":"kt"},{"key":"products","value":"LSFO"},{"key":"floatingStorageDurationMin","value":"7"},{"key":"floatingStorageDurationMax","value":"Inf"},{"key":"startDate","value":"2020-09-01"},{"key":"endDate","value":"2020-09-30"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Date;IMO;Name;Dead Weight Tonnage;Quantity (kt);Family;Group;Product;Grade;Current Contient;Current Subcontinent;Current Country;Current Sea;Number of Floating Days;Floating Since\n2020-09-01;9234616;Admiral;23998;2;Middle Distillates;;;LCO;Europe;Western Europe;Netherlands;ARA;16;2020-08-16T00:00:00.000Z\n2020-09-01;9379698;Advantage Virtue;296481;271;Dirty;crude/co;crude;WTI;Europe;Western Europe;Netherlands;ARA;14;2020-08-18T00:00:00.000Z\n2020-09-01;9290335;Aegean Dignity;159081;139;Dirty;crude/co;crude;Forcados;Europe;Southern Europe;Spain;MED Sea;10;2020-08-22T00:00:00.000Z\n2020-09-01;9387920;Aegean Wave;51510;37;Middle Distillates;Gasoil/Diesel;Gasoil;;Asia;Eastern Asia;China;N. Pacific;13;2020-08-19T00:00:00.000Z\n2020-09-01;9430313;Afra Royal;115948;76;Dirty;crude/co;crude;Hamaca;Asia;South-East Asia;Malaysia;Malacca Strait;9;2020-08-23T00:00:00.000Z\n2020-09-01;9259173;Aframax River;107132;24;Dirty;crude/co;crude;Boscan;Americas;South America;Venezuela;Caribbean Sea;135;2020-04-19T00:00:00.000Z\n2020-09-01;9357614;African Ruby;11027;9;Light Ends;Gasoline/Naphtha;Naphtha;;Africa;Western Africa;Angola;West African Gulf;10;2020-08-22T00:00:00.000Z\n2020-09-01;9809368;Aldana;156670;123;Middle Distillates;Kero/Jet;Jet;Jet A-1;Europe;Northern Europe;United Kingdom;N. Atlantic;74;2020-06-19T00:00:00.000Z\n2020-09-01;9236016;Aldus;149994;81;Middle Distillates;Gasoil/Diesel;Gasoil;;Asia;Middle East;United Arab Emirates;Gulf of Oman;12;2020-08-20T00:00:00.000Z\n2020-09-01;9197832;Alisha;281037;255;Dirty;crude/co;;;Asia;Eastern Asia;China;N. Pacific;44;2020-07-19T00:00:00.000Z\n2020-09-01;9583720;Almi Hydra;319357;138;Dirty;crude/co;crude;Lula;Asia;Eastern Asia;China;N. Pacific;14;2020-08-18T00:00:00.000Z\n2020-09-01;9583720;Almi Hydra;319357;136;Dirty;crude/co;crude;Liza;Asia;Eastern Asia;China;N. Pacific;14;2020-08-18T00:00:00.000Z\n2020-09-01;9469687;Alpine Aqualina;105304;90;Middle Distillates;Kero/Jet;Jet;Jet A-1;Europe;Western Europe;Belgium;ARA;75;2020-06-18T00:00:00.000Z\n2020-09-01;9330355;Amalia;73815;57;Light Ends;Gasoline/Naphtha;Naphtha;;Americas;South America;Brazil;S. Atlantic;7;2020-08-25T00:00:00.000Z"},{"id":"4ad89253-fff2-41ac-97d4-75679e6b96cc","name":"OIL - Malacca Strait loaded vessels (crude/co) for today","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/fleet-metrics/vessels?metric=loaded_vessels&zones=Malacca Strait&products=crude/co&unit=kb","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","fleet-metrics","vessels"],"query":[{"key":"metric","value":"loaded_vessels"},{"key":"zones","value":"Malacca Strait"},{"key":"products","value":"crude/co"},{"key":"unit","value":"kb"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;IMO;Name;Dead Weight Tonnage;Quantity (kb);Family;Group;Product;Grade;Current Contient;Current Subcontinent;Current Country;Current Sea\n2020-10-23;9579509;Almi Galaxy;157787;1057;Dirty;crude/co;crude;Sah Bl.;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9610808;Anatoly Kolodkin;118316;792;Dirty;crude/co;;;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9411965;Athenian Harmony;317441;1016;Dirty;crude/co;crude;WAF;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9409247;Athenian Victory;317441;1230;Dirty;crude/co;crude;Ekofisk;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9409247;Athenian Victory;317441;767;Dirty;crude/co;crude;Forties;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9224439;Aurora Borealis;159167;240;Dirty;crude/co;crude;DCO;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9224439;Aurora Borealis;159167;240;Dirty;crude/co;crude;Merey;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9284582;Bunga Kelana 7;105193;566;Dirty;crude/co;crude;Kimanis;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9108647;Cavalier;47629;104;Dirty;crude/co;crude;;Asia;Eastern Asia;Malaysia;Malacca Strait\n2020-10-23;9436020;Crude Centurion;112863;777;Dirty;crude/co;;;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9203277;Dante;298911;1948;Dirty;crude/co;crude;;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9569695;Diona;319297;2131;Dirty;crude/co;;;Asia;Middle East;Malaysia;Malacca Strait\n2020-10-23;9597264;Eagle Verona;320122;1100;Dirty;crude/co;;;Asia;South-East Asia;Malaysia;Malacca Strait\n2020-10-23;9597264;Eagle Verona;320122;981;Dirty;crude/co;crude;SGC;Asia;South-East Asia;Malaysia;Malacca Strait\n"},{"id":"82ef1a02-b71a-4cb9-b88e-1acdc393570e","name":"CPP - World loaded vessels in first half of January 2020","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-cpp.kpler.com/v1/fleet-metrics/vessels?metric=loaded_vessels&unit=kt&startDate=2020-01-01&endDate=2020-01-14","protocol":"https","host":["api-cpp","kpler","com"],"path":["v1","fleet-metrics","vessels"],"query":[{"key":"metric","value":"loaded_vessels"},{"key":"unit","value":"kt"},{"key":"startDate","value":"2020-01-01"},{"key":"endDate","value":"2020-01-14"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;IMO;Name;Dead Weight Tonnage;Quantity (kt);Family;Group;Product;Grade;Current Contient;Current Subcontinent;Current Country;Current Sea\n2020-01-01;9476599;Acacia;13566;5;Clean;;;;Asia;South-East Asia;Indonesia;S. Pacific\n2020-01-01;9298715;Acadian;37515;13;Middle Distillates;Gasoil/Diesel;Gasoil;ULSHO;Americas;Northern America;United States;N. Atlantic\n2020-01-01;9210907;Adebomi 3;36962;12;Light Ends;Gasoline/Naphtha;Gasoline;;Africa;Western Africa;Nigeria;West African Gulf\n2020-01-01;9186704;Adeline;13190;11;Light Ends;Gasoline/Naphtha;Gasoline;;Asia;Middle East;Yemen;Arabian Sea\n2020-01-01;9387918;Adriatic Wave;51476;13;Middle Distillates;Kero/Jet;Jet;;Americas;South America;Colombia;N. Pacific\n2020-01-01;9327384;Advantage Point;37039;35;Middle Distillates;Gasoil/Diesel;Diesel;ULSD;Europe;Western Europe;Netherlands;North Sea\n2020-01-01;9387920;Aegean Wave;51510;43;Light Ends;Gasoline/Naphtha;Gasoline;;Asia;South-East Asia;Philippines;N. Pacific\n2020-01-01;9315800;Aegeas;39378;35;Middle Distillates;Gasoil/Diesel;Diesel;;Europe;Southern Europe;Malta;MED Sea\n2020-01-01;9576818;Aeon;18041;8;Middle Distillates;Gasoil/Diesel;Diesel;;Africa;Eastern Africa;Eritrea;Red Sea\n2020-01-01;9373230;Aethalia;19992;5;Clean;;;;Asia;South-East Asia;Singapore Republic;Singapore Strait\n2020-01-01;9373230;Aethalia;19992;12;Middle Distillates;Gasoil/Diesel;Gasoil;;Asia;South-East Asia;Singapore Republic;Singapore Strait\n2020-01-01;9607734;Ag Neptune;105405;15;Light Ends;Gasoline/Naphtha;Naphtha;;;;;Indian Ocean\n2020-01-01;9464364;Agios Nikolaos Iv;37558;11;Light Ends;Blendings;Blending Comps;Reformate;Europe;Southern Europe;Spain;MED Sea\n2020-01-01;9258600;Agnes Victory;47171;40;Clean;;;;Africa;Eastern Africa;Eritrea;Red Sea"}],"_postman_id":"d917a113-5551-42ae-98d4-9d1822dd3cc9"},{"name":"/v1/fleet-metrics/trades","id":"00ec92e6-4c8b-4c48-9baf-49bb3352771b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n"}],"url":"{{HOST_URL}}/v1/fleet-metrics/trades?date={{date}}&metric={{metric}}&floatingStorageDurationMin={{floatingStorageDurationMin}}&floatingStorageDurationMax={{floatingStorageDurationMax}}&zones={{zones}}&products={{products}}&vesselTypes={{vesselTypes}}&vesselTypesAlt={{vesselTypesAlt}}&size={{size}}&withProductEstimation={{withProductEstimation}}>e={{gte}}<e={{lte}}","description":"What is {{HOST_URL}} and where do we find it?
\nThrough this endpoint you can retrieve a list of all individual trades that are used for composing the \"Fleet Metrics\" Total numbers and grain further insights by performing analysis on more granular data.
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","fleet-metrics","trades"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Required [Date]: Selected date in YYYY-MM-DD format
\n","type":"text/plain"},"key":"date","value":"{{date}}"},{"description":{"content":"Required [String]: Use following metrics:\n
Minimum floating days [7-10-12-15-20-30-90]
\nNote: Required for metric floating_storage
\n","type":"text/plain"},"key":"floatingStorageDurationMin","value":"{{floatingStorageDurationMin}}"},{"description":{"content":"Maximum floating days [7-10-12-15-20-30-90-Inf]
\nNote: Required for metric floating_storage
\n","type":"text/plain"},"key":"floatingStorageDurationMax","value":"{{floatingStorageDurationMax}}"},{"description":{"content":"Optional [String]: Names of countries/geographical zones. Default to world if not specified.
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"description":{"content":"Optional [String]: Names of products - Default to all available products if not specified
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [String]: For given cpp vessel types\n
\nUse [\"LR2\", \"VLCC\", \"LR3\", \"MR\", \"GP\", \"LR1\"]\n
\nNotes:
Optional [String]: For given oil vessel types\n
\nUse [\"Aframax\", \"Product Tanker\", \"Suezmax\", \"VLCC\", \"Panamax\", \"ULCC\"]\n
\nNotes:
Optional [Integer]: Maximum number of trades returned. Default to 100000
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"description":{"content":"Optional [Boolean]: Default to false if not specified. Activate the product estimation feature for CPP, Fuel Oils and Chem/Bio trades only. When set to true, the estimated product will overwrite the existing product information.
\n","type":"text/plain"},"key":"withProductEstimation","value":"{{withProductEstimation}}"},{"description":{"content":"Optional [Integer]: minimum DWT of vessels included. Default to 0
\n","type":"text/plain"},"key":"gte","value":"{{gte}}"},{"description":{"content":"Optional [Integer]: maximum DWT of vessels included. Default to 606550
\n","type":"text/plain"},"key":"lte","value":"{{lte}}"}],"variable":[]}},"response":[{"id":"e6ec5d6b-2bb4-4cc0-855c-1c2fbde53467","name":"Liquids - September 2020 World LSFO Floating Storage","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String] : Token"}],"url":{"raw":"https://api.kpler.com/v1/fleet-metrics/trades?metric=floating_storage&zones=Europe&products=LSFO&floatingStorageDurationMin=7&floatingStorageDurationMax=Inf&date=2023-10-27","protocol":"https","host":["api","kpler","com"],"path":["v1","fleet-metrics","trades"],"query":[{"key":"metric","value":"floating_storage"},{"key":"zones","value":"Europe"},{"key":"products","value":"LSFO"},{"key":"floatingStorageDurationMin","value":"7"},{"key":"floatingStorageDurationMax","value":"Inf"},{"key":"date","value":"2023-10-27"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":"Date;IMO;Name;Dead Weight Tonnage;Quantity (kt);Family;Group;Product;Grade;Current Contient;Current Subcontinent;Current Country;Current Sea;Number of Floating Days;Floating Since\n2020-09-01;9234616;Admiral;23998;2;Middle Distillates;;;LCO;Europe;Western Europe;Netherlands;ARA;16;2020-08-16T00:00:00.000Z\n2020-09-01;9379698;Advantage Virtue;296481;271;Dirty;crude/co;crude;WTI;Europe;Western Europe;Netherlands;ARA;14;2020-08-18T00:00:00.000Z\n2020-09-01;9290335;Aegean Dignity;159081;139;Dirty;crude/co;crude;Forcados;Europe;Southern Europe;Spain;MED Sea;10;2020-08-22T00:00:00.000Z\n2020-09-01;9387920;Aegean Wave;51510;37;Middle Distillates;Gasoil/Diesel;Gasoil;;Asia;Eastern Asia;China;N. Pacific;13;2020-08-19T00:00:00.000Z\n2020-09-01;9430313;Afra Royal;115948;76;Dirty;crude/co;crude;Hamaca;Asia;South-East Asia;Malaysia;Malacca Strait;9;2020-08-23T00:00:00.000Z\n2020-09-01;9259173;Aframax River;107132;24;Dirty;crude/co;crude;Boscan;Americas;South America;Venezuela;Caribbean Sea;135;2020-04-19T00:00:00.000Z\n2020-09-01;9357614;African Ruby;11027;9;Light Ends;Gasoline/Naphtha;Naphtha;;Africa;Western Africa;Angola;West African Gulf;10;2020-08-22T00:00:00.000Z\n2020-09-01;9809368;Aldana;156670;123;Middle Distillates;Kero/Jet;Jet;Jet A-1;Europe;Northern Europe;United Kingdom;N. Atlantic;74;2020-06-19T00:00:00.000Z\n2020-09-01;9236016;Aldus;149994;81;Middle Distillates;Gasoil/Diesel;Gasoil;;Asia;Middle East;United Arab Emirates;Gulf of Oman;12;2020-08-20T00:00:00.000Z\n2020-09-01;9197832;Alisha;281037;255;Dirty;crude/co;;;Asia;Eastern Asia;China;N. Pacific;44;2020-07-19T00:00:00.000Z\n2020-09-01;9583720;Almi Hydra;319357;138;Dirty;crude/co;crude;Lula;Asia;Eastern Asia;China;N. Pacific;14;2020-08-18T00:00:00.000Z\n2020-09-01;9583720;Almi Hydra;319357;136;Dirty;crude/co;crude;Liza;Asia;Eastern Asia;China;N. Pacific;14;2020-08-18T00:00:00.000Z\n2020-09-01;9469687;Alpine Aqualina;105304;90;Middle Distillates;Kero/Jet;Jet;Jet A-1;Europe;Western Europe;Belgium;ARA;75;2020-06-18T00:00:00.000Z\n2020-09-01;9330355;Amalia;73815;57;Light Ends;Gasoline/Naphtha;Naphtha;;Americas;South America;Brazil;S. Atlantic;7;2020-08-25T00:00:00.000Z"}],"_postman_id":"00ec92e6-4c8b-4c48-9baf-49bb3352771b"}],"id":"c024e52d-f7cf-4f9c-98cd-4c30c33a0ec8","description":"The fleet metrics endpoint returns fleet data for a given zone.
\nFollowing metrics are available:
\nThe granularity of the data is on a daily, weekly and EIA-weekly basis, with the ability to modify floating days for the floating storage query.
\n","event":[{"listen":"prerequest","script":{"id":"07a359f3-5029-45d9-9516-f8481350fb76","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d7c2717c-2214-4716-b611-4e5d8fbbb9e6","type":"text/javascript","exec":[""]}}],"_postman_id":"c024e52d-f7cf-4f9c-98cd-4c30c33a0ec8","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Inventories","item":[{"name":"/v1/inventories/columns","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"8fcb09c7-2f87-4c13-9703-f93d6d9fba49","exec":[""],"type":"text/javascript"}}],"id":"63c09cab-dfae-4dd5-a362-77b6191cdc4d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"description":"Required [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"key":"Content-Type","value":"application/json","description":"Required [String]: application/json or text/json
\n","type":"text"}],"body":{"mode":"raw","raw":"[\n \"date\",\n \"zone_name\"\n]"},"url":"{{HOST_URL}}/v1/inventories/columns","description":"What is {{HOST_URL}} and where do we find it?
\nTo prevent breaking changes, we strongly recommend you to not use the “all” or the default value for the 'column’ parameter as these may occasionally change.
\nTherefore we have added this endpoint which allows you to get a hash code for the set of columns that you wish to add on your query.
\nNote: The set of columns defined with the hash code will never change and will always remain the same.
\nIn this example, we have created a hash code that will always return the following columns:
\nRequired [String] : Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"{{HOST_URL}}/v1/inventories?zones={{zones}}&installations={{installations}}&startDate={{startDate}}&endDate={{endDate}}&period={{period}}&cargoTrackingEnhancement={{cargoTrackingEnhancement}}&split={{split}}&addCommoditiesOnWater={{addCommoditiesOnWater}}&floatingStorageDurationMin={{floatingStorageDurationMin}}&floatingStorageDurationMax={{floatingStorageDurationMax}}&columns={{columns}}&hash={{hash}}&withoutEiaAdjustment={{withoutEiaAdjustment}}&splitValues={{splitValues}}","description":"What is {{HOST_URL}} and where do we find it?
\nFor the best performance, we recommend limiting 'daily' period requests to two years.
\n","urlObject":{"path":["v1","inventories"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Optional [String]: Names of the zones [\"port\", \"region\", \"country\", \"continent\"]
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"description":{"content":"Optional [String]: Name of installation
\n","type":"text/plain"},"key":"installations","value":"{{installations}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Period [\"annually\", \"monthly\", \"weekly\", \"eia-weekly\", \"daily\"]
\n","type":"text/plain"},"key":"period","value":"{{period}}"},{"description":{"content":"Optional [Boolean]: Use cargo tracking data to fill the blanks in between satellite images (default: False)
\n","type":"text/plain"},"key":"cargoTrackingEnhancement","value":"{{cargoTrackingEnhancement}}"},{"description":{"content":"Optional [String]: Splits the inventories data per: [\"byCountry\", \"byInstallation\", \"byOnshoreOffshoreStatus\", \"byPlayer\", \"byTankType\", \"total\"]
\nBy default if not specified the value is total.
\nNote:
\nOptional [Boolean]: Provides total volume of inventories including offshore and offshore. Default to false if not specified.
\nMore information in this article: Analyse crude inventories and oil-on-water using one single function.
\n","type":"text/plain"},"key":"addCommoditiesOnWater","value":"{{addCommoditiesOnWater}}"},{"description":{"content":"Optional [String]: Minimum floating days [7-10-12-15-20-30-90]. Default to 7 if not specified.
\nNote
\nThis parameter is only taken into consideration when addCommoditiesOnWater is set to true
\n","type":"text/plain"},"key":"floatingStorageDurationMin","value":"{{floatingStorageDurationMin}}"},{"description":{"content":"Optional [String]: Maximum floating days [7-10-12-15-20-30-90-Inf]. Default to Inf if not specified.
\nNote
\nThis parameter is only taken into consideration when addCommoditiesOnWater is set to true
\n","type":"text/plain"},"key":"floatingStorageDurationMax","value":"{{floatingStorageDurationMax}}"},{"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the next endpoint to learn more about how to generate the hash code )
\nNote: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"},{"description":{"content":"Optional [Boolean]: Provides the ability to remove the EIA adjustment factor from inventory and capacity values. Default to false if not specified.
\nMore information in this article: Crude Inventories EIA Data Integration.
\n","type":"text/plain"},"key":"withoutEiaAdjustment","value":"{{withoutEiaAdjustment}}"},{"description":{"content":"Optional [String]: Fix the values and the order of the split
\n","type":"text/plain"},"key":"splitValues","value":"{{splitValues}}"}],"variable":[]}},"response":[{"id":"06300ef4-a93d-4d4d-8bfb-7fb500fbd6ad","name":"OIL - China annually inventories (by installation)","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/inventories?split=byInstallation&zones=China&period=annually","protocol":"https","host":["api","kpler","com"],"path":["v1","inventories"],"query":[{"key":"split","value":"byInstallation"},{"key":"zones","value":"China"},{"key":"period","value":"annually"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;Zone;Installation;Level (kb);Local Supply (kbd);Local Demand (kbd);Cargoes (kbd);Capacity (kb);Relative Fill Level;Country;Continent;Revisit Rate;Aoshan Level (kb);Beihai Level (kb);Beilun Suansha Level (kb);CNPC Qinzhou Refinery Level (kb);Caofeidian Level (kb);Cezixiang Level (kb);Dalian Level (kb);Daqing Level (kb);Dongying Level (kb);Dushanzi Level (kb);Gudaozhen Level (kb);Hekou Level (kb);Hengli Refinery Level (kb);Huangdao Level (kb);Huangdao Underground SPR Level (kb);Huangze Level (kb);Huizhou Refinery Level (kb);Huizhou Underground SPR Level (kb);Jigujiao Level (kb);Jinshan Refinery Level (kb);Jinxi Refinery Level (kb);Jinzhou Underground SPR Level (kb);Lanzhou Level (kb);Lanzhou SPR Level (kb);Liuheng Terminal Level (kb);Longkou Chemicals Level (kb);Maoming Refinery Level (kb);Mercuria Storage Level (kb);Panjin Level (kb);Qingdao Huangdao Level (kb);Qinzhou SPR Level (kb);Quanzhou Refinery Level (kb);Rizhao Level (kb);Rongsheng Refinery Level (kb);SINOPEC Yangpu Refinery Level (kb);Shihua Level (kb);Sinopec Tianjin Level (kb);Sinopec Zhanjiang Level (kb);Turpan Level (kb);Urumqi Level (kb);Vopak Yangpu Level (kb);Waidiao Level (kb);Weifang Refinery Level (kb);Xian Ren Dao Terminal Level (kb);Yangpu SPR Level (kb);Yangshan Level (kb);Yantai Level (kb);Zhangjiang Underground SPR Level (kb);Zhenhai Level (kb)\n2017-12-31 23:59;China;;675362;0;7362;7475;1209448;0.558;China;Asia;0.955;60391;15977;4754;10268;22204;9969;68572;18349;11980;25762;0;7251;0;17472;16000;1588;14610;0;11598;10185;4773;0;8721;17313;756;5220;10320;13859;2727;17346;21753;3873;26126;0;2553;11626;26332;12745;11483;2766;418;2341;42188;15152;28591;1366;4242;0;53844\n2018-12-31 23:59;China;;712494;0;7670;8030;1226429;0.581;China;Asia;1.0;59834;11983;4778;10448;21261;6731;68648;15981;11903;29910;0;7412;33774;17427;16000;1575;12950;0;19058;9894;7169;3200;8095;18271;616;6031;11051;14861;2423;22293;21553;5043;23321;0;4135;14281;29211;17270;11730;1820;326;2770;36717;13458;24026;723;6892;85;45554\n2019-12-31 23:59;China;;749992;0;8092;8501;1226869;0.611;China;Asia;1.0;61702;13163;4303;8259;22686;5597;59526;18284;10459;30208;0;8423;32545;17423;16000;1687;16999;0;27107;8917;6921;14905;8115;17505;1233;5633;10291;15797;2785;20932;21406;6994;21025;8230;3974;12879;39392;17075;11449;1358;551;4700;36572;18614;26429;1009;6896;85;43949\n2020-12-31 23:59;China;;831730;0;8186;8959;1226995;0.678;China;Asia;1.0;64866;17439;5702;10823;24013;9189;72928;18535;11386;29485;0;7239;42357;17642;16000;3669;16618;0;25074;10519;9930;14903;11105;19003;1233;5591;11122;21901;3185;24316;23842;8215;26468;8146;5134;14285;41660;19876;11544;2166;588;4120;36816;18784;31765;1229;8493;403;42424"},{"id":"58ae9b92-3c1e-4a9f-8901-0d7cb791a5cf","name":"Liquids - United States weekly inventories (by tank type)","originalRequest":{"method":"GET","header":[{"key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN","description":"Required [String] : Token"}],"url":{"raw":"https://api.kpler.com/v1/inventories?zones=United States&period=weekly&split=byTankType","protocol":"https","host":["api","kpler","com"],"path":["v1","inventories"],"query":[{"key":"zones","value":"United States"},{"key":"period","value":"weekly"},{"key":"split","value":"byTankType"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Date;Zone;Installation;Level (kb);Local Supply (kbd);Local Demand (kbd);Cargoes (kbd);Capacity (kb);Relative Fill Level;Country;Continent;Revisit Rate;Level Commercial (kb);Level Refinery (kb);Level SPR (kb)\n2017-01-01 23:59;United States;;1133442;280;3314;3308;1370951;0.827;United States;Americas;0.271;223121;215238;695083\n2017-01-08 23:59;United States;;1133839;178;3329;3927;1370951;0.827;United States;Americas;0.484;225816;212939;695083\n2017-01-15 23:59;United States;;1139573;65;2845;2932;1370951;0.831;United States;Americas;0.49;226311;218180;695082\n2017-01-22 23:59;United States;;1143620;14;3091;3329;1370951;0.834;United States;Americas;0.632;229376;219162;695082\n2017-01-29 23:59;United States;;1137927;53;3424;4042;1370951;0.83;United States;Americas;0.54;224528;218319;695080"},{"id":"915d2d05-2fb2-4179-b9a5-b1fe04afaa31","name":"Retrieve columns using hash","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api-oil.kpler.com/v1/inventories?hash=YOUR_HASH","protocol":"https","host":["api-oil","kpler","com"],"path":["v1","inventories"],"query":[{"key":"hash","value":"YOUR_HASH"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null},{"id":"b7e02a02-b204-4337-b424-f39787162cc5","name":"Liquids - Europe inventories splitted byOnshoreOffshoreStatus","originalRequest":{"method":"GET","header":[{"description":"Required [String] : Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":{"raw":"https://api.kpler.com/v1/inventories?zones=Europe&addCommoditiesOnWater=true&split=byOnshoreOffshoreStatus","protocol":"https","host":["api","kpler","com"],"path":["v1","inventories"],"query":[{"key":"zones","value":"Europe"},{"key":"addCommoditiesOnWater","value":"true"},{"key":"split","value":"byOnshoreOffshoreStatus"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;Zone;Installation;Level (kb);Local Supply (kbd);Local Demand (kbd);Cargoes (kbd);Capacity (kb);Relative Fill Level;Country;Continent;Revisit Rate;Floating Storage Level (kb);Oil in Transit on Ships Level (kb);Onshore Level (kb)\n2017-01-01 23:59;Europe;;435717;4844;9051;5903;668124;0.652;;Europe;0.156;10537;99100;435717\n2017-01-02 23:59;Europe;;443086;4786;9002;7407;674375;0.657;;Europe;0.145;11573;104315;443086\n2017-01-03 23:59;Europe;;433858;4801;9421;9356;665077;0.652;;Europe;0.081;10860;95730;433858\n2017-01-04 23:59;Europe;;428118;4649;9538;9613;655886;0.653;;Europe;0.243;8123;89275;428118\n2017-01-05 23:59;Europe;;420956;4581;9191;7365;647406;0.65;;Europe;0.153;13876;75043;420956\n2017-01-06 23:59;Europe;;426391;4369;9004;3382;649296;0.657;;Europe;0.199;7473;83335;426391\n2017-01-07 23:59;Europe;;436034;4411;8545;5085;657838;0.663;;Europe;0.15;5462;93889;436034\n2017-01-08 23:59;Europe;;428429;4382;8683;5826;649612;0.66;;Europe;0.142;9379;81745;428429\n(truncated response)\n"}],"_postman_id":"890e68f0-074b-4a80-8206-3a786660c091"},{"name":"/v1/inventories/tank-levels","event":[{"listen":"test","script":{"id":"e6dab6d1-208d-44a2-a59f-2fe998326417","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"cb084fae-02d0-4bdc-903c-a957973709e7","exec":[""],"type":"text/javascript"}}],"id":"7d4df865-84b8-411e-9902-495efde432a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String] : Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"{{HOST_URL}}/v1/inventories/tank-levels?zones={{zones}}&installations={{installations}}&startDate={{startDate}}&endDate={{endDate}}","description":"What is {{HOST_URL}} and where do we find it?
\nListed below the behavior if you are using startDate and endDate:
\n*Please note if using to aggregate tank inventories at installation level__*
\nIf you find there is no measurement for a tank within the query window [startDate - endDate equal to or less than 31 days], then there is a possibility that the satellite may not have revisted the installation
\nNo satellite revisit results in no image, as a consequence the tank measurements are unable to be calculated
\nIf this scenario appears then the last known measurement of the tank should be taken for aggregation purposes
\nRequired [String]: Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"description":"Required [String]: application/json or text/json
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"https://api-lng.kpler.com/v1/inventories/columns","description":"What is {{HOST_URL}} and where do we find it?
\nThis endpoint returns a recent and updated list of all columns available for the endpoint inventories.
\n","urlObject":{"protocol":"https","path":["v1","inventories","columns"],"host":["api-lng","kpler","com"],"query":[],"variable":[]}},"response":[{"id":"cb348ccd-b4b8-45cf-87b0-984ed7f41ac3","name":"List of all columns","originalRequest":{"method":"GET","header":[{"description":"**Required [String]**: Token","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"},{"description":"**Required [String]**: **application/json** or **text/json**","key":"Content-Type","type":"text","value":"application/json"}],"url":"https://api.kpler.com/v1/inventories/columns"},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"selected\": [\n {\n \"id\": \"date\",\n \"shortId\": \"date\",\n \"columnName\": \"Date\",\n \"description\": \"Date for which values are provided\",\n \"deprecated\": false,\n \"type\": \"date yyyy-MM-dd\"\n },\n {\n \"id\": \"zone_name\",\n \"shortId\": \"zone_name\",\n \"columnName\": \"Zone\",\n \"description\": \"Name of the area of interest\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"installation_name\",\n \"shortId\": \"installation_name\",\n \"columnName\": \"Installation\",\n \"description\": \"Name of the installation\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"level_barrels\",\n \"shortId\": \"level_barrels\",\n \"columnName\": \"Level (kb)\",\n \"description\": \"Amount of crude oil stored in kb\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"local_suply_barrels\",\n \"shortId\": \"local_suply_barrels\",\n \"columnName\": \"Local Supply (kbd)\",\n \"description\": \"Net Overland Inflow of crude oil (due to local Oilfields, or Pipelines) in kbd\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"local_demand_barrels\",\n \"shortId\": \"local_demand_barrels\",\n \"columnName\": \"Local Demand (kbd)\",\n \"description\": \"Net Overland Outflow of crude oil (due to local refineries or pipelines)\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"portCall_io_barrels\",\n \"shortId\": \"portCall_io_barrels\",\n \"columnName\": \"Cargoes (kbd)\",\n \"description\": \"Net import value of waterborne imports (including intraflows) for the given period\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"capacity_barrels\",\n \"shortId\": \"capacity_barrels\",\n \"columnName\": \"Capacity (kb)\",\n \"description\": \"Storage capacity of the area of interest\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"capacity_relative_barrels\",\n \"shortId\": \"capacity_relative_barrels\",\n \"columnName\": \"Relative Fill Level\",\n \"description\": \"Fill level of the area of interest\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"country\",\n \"shortId\": \"country\",\n \"columnName\": \"Country\",\n \"description\": \"Specific country where the port call is registered\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"continent\",\n \"shortId\": \"continent\",\n \"columnName\": \"Continent\",\n \"description\": \"Specific continent where the port call is registered\",\n \"deprecated\": false,\n \"type\": \"string\"\n },\n {\n \"id\": \"revisit_rate\",\n \"shortId\": \"revisit_rate\",\n \"columnName\": \"Revisit Rate\",\n \"description\": \"Proportion of the total volume revisited by imagery\",\n \"deprecated\": false,\n \"type\": \"double\"\n },\n {\n \"id\": \"last_image\",\n \"shortId\": \"last_image\",\n \"columnName\": \"Last Image\",\n \"description\": \"Date of the last satellite image (if applicable)\",\n \"deprecated\": false,\n \"type\": \"date yyyy-MM-dd\"\n }\n ],\n \"unselected\": [\n {\n \"id\": \"delta_level\",\n \"shortId\": \"delta_level\",\n \"columnName\": \"Delta level (kb)\",\n \"description\": \"Difference in kb from the previous date (depending on granularity) for crude\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"eia_adjustment_capacity\",\n \"shortId\": \"eia_adjustment_capacity\",\n \"columnName\": \"EIA adjustment capacity (kb)\",\n \"description\": \"Difference between EIA capacity and Kpler capacity in kb\",\n \"deprecated\": false,\n \"type\": \"long\"\n },\n {\n \"id\": \"eia_adjustment_level\",\n \"shortId\": \"eia_adjustment_level\",\n \"columnName\": \"EIA adjustment level (kb)\",\n \"description\": \"Difference between EIA level and Kpler Level in kb\",\n \"deprecated\": false,\n \"type\": \"long\"\n }\n ]\n}"}],"_postman_id":"ab8f30b9-3c18-44de-9444-e7419152c136"},{"name":"/v1/inventories/cushing-drone","id":"2bd01444-2698-4d4d-ad40-6aeade974c05","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.kpler.com/v1/inventories/cushing-drone?period={{period}}&startDate={{startDate}}&endDate={{endDate}}&split={{split}}","urlObject":{"protocol":"https","path":["v1","inventories","cushing-drone"],"host":["api","kpler","com"],"query":[{"description":{"content":"Optional [String]: Period [\"daily\", \"eiaweekly\", \"midweekly\"]
\n","type":"text/plain"},"key":"period","value":"{{period}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Splits the inventories data per: [\"byInstallation\", \"byPlayer\", \"byTankType\"]
\n","type":"text/plain"},"key":"split","value":"{{split}}"}],"variable":[]}},"response":[{"id":"d21c7fd0-20fc-41b5-b402-a64fbc8f779a","name":"/v1/inventories/cushing-drone","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.kpler.com/v1/inventories/cushing-drone?period=daily&startDate=2022-10-01&endDate=2022-12-01&split=total","protocol":"https","host":["api","kpler","com"],"path":["v1","inventories","cushing-drone"],"query":[{"key":"period","value":"daily","description":"Optional [String]: Period [\"daily\", \"eiaweekly\", \"midweekly\"]"},{"key":"startDate","value":"2022-10-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD)"},{"key":"endDate","value":"2022-12-01","description":"Optional [Date]: End of the period (YYYY-MM-DD)"},{"key":"split","value":"total","description":"Optional [String]: Splits the inventories data per: [\"byInstallation\", \"byPlayer\"]\n"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Date;Level (kb);Capacity (kb);capacity_utilization\r\n2022-10-05;32327.08755749;98109.87418492;0.329\r\n2022-10-07;31699.49698261;98109.87418492;0.323\r\n2022-10-12;32478.62475768;98109.87418492;0.331\r\n2022-10-14;32002.81293648;98109.87418492;0.326\r\n2022-10-19;33015.70495047;98109.87418492;0.337\r\n2022-10-21;33273.51790187;98109.87418492;0.339\r\n2022-10-26;33187.33498803;98109.87418492;0.338\r\n2022-10-28;34047.88021362;98109.87418492;0.347\r\n2022-11-02;34044.65602210;98109.87418492;0.347\r\n2022-11-04;33575.53180081;98109.87418492;0.342\r\n2022-11-09;31143.47788432;98109.87418492;0.317\r\n2022-11-11;31290.92271888;98109.87418492;0.319\r\n2022-11-16;30953.32726801;98109.87418492;0.315\r\n2022-11-18;30681.26936696;98109.87418492;0.313\r\n2022-11-23;29984.89471356;98109.87418492;0.306\r\n2022-11-25;30250.42225712;98109.87418492;0.308\r\n2022-11-30;29549.73860865;98109.87418492;0.301"}],"_postman_id":"2bd01444-2698-4d4d-ad40-6aeade974c05"},{"name":"/v1/tanks","id":"ce4de811-2f10-43d9-b8c4-af760ec994f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String] : Token
\n","type":"text"}],"url":"{{HOST_URL}}/v1/tanks?updatedAfter={{date}}","description":"What is {{HOST_URL}} and where do we find it?
\nReturns all the tanks that have changed operational status or have been added to our coverage after a given date.
\nNOTE:
\nMandatory [Date]: Lower boundary date to retrieve tanks updates. Upper boundary is today. \nNote: limited to one year
\n","type":"text/plain"},"key":"updatedAfter","value":"{{date}}"}],"variable":[]}},"response":[],"_postman_id":"ce4de811-2f10-43d9-b8c4-af760ec994f6"},{"name":"/v1/inventories/snapshot","event":[{"listen":"test","script":{"id":"e139e277-20d5-4e9a-898a-98365e81b00d","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"8fcb09c7-2f87-4c13-9703-f93d6d9fba49","exec":[""],"type":"text/javascript"}}],"id":"40afd536-4a6c-4580-978b-2ab0923a33a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"description":"Required [String] : Token
\n","key":"Authorization","type":"text","value":"Bearer YOUR_TOKEN"}],"url":"{{HOST_URL}}/v1/inventories/snapshot?zones={{zones}}&installations={{installations}}&startDate={{startDate}}&endDate={{endDate}}&period={{period}}&cargoTrackingEnhancement={{cargoTrackingEnhancement}}&split={{split}}&addCommoditiesOnWater={{addCommoditiesOnWater}}&floatingStorageDurationMin={{floatingStorageDurationMin}}&floatingStorageDurationMax={{floatingStorageDurationMax}}&columns={{columns}}&hash={{hash}}&withoutEiaAdjustment={{withoutEiaAdjustment}}&splitValues={{splitValues}}&snapshotDate={{date}}","description":"What is {{HOST_URL}} and where do we find it?
\nFor the best performance, we recommend limiting 'daily' period requests to two years.
\nThe Point In Time feature allows users to access Inventories data snapshots. A snapshot is a picture of the data at a given moment. Retrieving past snapshot provides the ability to know what were previous states of the data.
\nThe data collection methodology and pipeline are robust and once satellite images are received, they are processed ensuring data points are available to customers quickly and efficiently. On occasions when a new tank or storage site is identified, the data is backfilled to 2017, ensuring full representation of inventories capacity and levels.
\nThanks to the Point In Time feature, the data before and after backfills can be retrieved, for users to access past estimations of crude oil Inventories.
\nThe first retrievable snapshot is 2022-10-09 and they are done at least weekly from that day onward, with some additional ones made available as well in late 2022.
\n","urlObject":{"path":["v1","inventories","snapshot"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Optional [String]: Names of the zones [\"port\", \"region\", \"country\", \"continent\"]
\n","type":"text/plain"},"key":"zones","value":"{{zones}}"},{"description":{"content":"Optional [String]: Name of installation
\n","type":"text/plain"},"key":"installations","value":"{{installations}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [String]: Period [\"annually\", \"monthly\", \"weekly\", \"eia-weekly\", \"daily\"]
\n","type":"text/plain"},"key":"period","value":"{{period}}"},{"description":{"content":"Optional [Boolean]: Use cargo tracking data to fill the blanks in between satellite images (default: False)
\n","type":"text/plain"},"key":"cargoTrackingEnhancement","value":"{{cargoTrackingEnhancement}}"},{"description":{"content":"Optional [String]: Splits the inventories data per: [\"byCountry\", \"byInstallation\", \"byOnshoreOffshoreStatus\", \"byPlayer\", \"byTankType\", \"total\"]
\nBy default if not specified the value is total.
\nNote:
\nOptional [Boolean]: Provides total volume of inventories including offshore and offshore. Default to false if not specified.
\nMore information in this article: Analyse crude inventories and oil-on-water using one single function.
\n","type":"text/plain"},"key":"addCommoditiesOnWater","value":"{{addCommoditiesOnWater}}"},{"description":{"content":"Optional [String]: Minimum floating days [7-10-12-15-20-30-90]. Default to 7 if not specified.
\nNote
\nThis parameter is only taken into consideration when addCommoditiesOnWater is set to true
\n","type":"text/plain"},"key":"floatingStorageDurationMin","value":"{{floatingStorageDurationMin}}"},{"description":{"content":"Optional [String]: Maximum floating days [7-10-12-15-20-30-90-Inf]. Default to Inf if not specified.
\nNote
\nThis parameter is only taken into consideration when addCommoditiesOnWater is set to true
\n","type":"text/plain"},"key":"floatingStorageDurationMax","value":"{{floatingStorageDurationMax}}"},{"description":{"content":"Optional [String]: Retrieve all available columns when set to \"all\"
\n","type":"text/plain"},"key":"columns","value":"{{columns}}"},{"description":{"content":"Optional [String]: Generate your favorite set of columns using the hash ( Look at the next endpoint to learn more about how to generate the hash code )
\nNote: You cannot use it simultaneously with the ‘columns’ parameter
\n","type":"text/plain"},"key":"hash","value":"{{hash}}"},{"description":{"content":"Optional [Boolean]: Provides the ability to remove the EIA adjustment factor from inventory and capacity values. Default to false if not specified.
\nMore information in this article: Crude Inventories EIA Data Integration.
\n","type":"text/plain"},"key":"withoutEiaAdjustment","value":"{{withoutEiaAdjustment}}"},{"description":{"content":"Optional [String]: Fix the values and the order of the split
\n","type":"text/plain"},"key":"splitValues","value":"{{splitValues}}"},{"description":{"content":"Optional [Date]: Date of the snapshot. \nFormat Date : YYYY-MM-DD. If empty it's returning the last snapshot. If there is no snapshot available on the input date, closest snapshot dates will be suggested.
\n","type":"text/plain"},"key":"snapshotDate","value":"{{date}}"}],"variable":[]}},"response":[],"_postman_id":"40afd536-4a6c-4580-978b-2ab0923a33a8"}],"id":"5de9da5e-b5de-47ae-bbd1-4249c134e44c","description":"The Inventories function returns inland crude oil stocks of a given point of interest, with a specific periodicity over a period of time. Waterborne Cargoes, local Supply and Demand will also be returned for the given point of interest.
\nIn order to select specific columns to display, please use the column ids explicited in the example called Columns id, name, description and deprecation status.
\n","event":[{"listen":"prerequest","script":{"id":"cc05057a-0be2-447b-99ca-f0df91ee3a80","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"14009130-44ac-4a24-99b0-5b5dd6c62a13","type":"text/javascript","exec":[""]}}],"_postman_id":"5de9da5e-b5de-47ae-bbd1-4249c134e44c","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Supply & Demand","item":[{"name":"/v1/supply-demand","id":"f6ca4b03-f336-46aa-99f8-3e548ecd412c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n"}],"url":"{{HOST_URL}}/v1/supply-demand?product={{product}}&metrics={{metrics}}&split={{split}}&zones={{zones}}&startDate={{startDate}}&endDate={{endDate}}&snapshotDate={{snapshotDate}}","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","supply-demand"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Required [String]: Name of the product to retrieve data for
\n","type":"text/plain"},"key":"product","value":"{{product}}"},{"description":{"content":"Required [String]: List of metrics to retrieve.\nThe list of metrics available per product can be retrieved from the /v1/supply-demand/products route
Required [String]: How to split the data [\"total\", \"country\"]
\n","type":"text/plain"},"key":"split","value":"{{split}}"},{"description":{"content":"Optional [String]: Names of the zones (region/country/continent). Default to world when not provided.\nNeeds to be percent-encoded if it contains special characters (like [, ], &)
Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 18 month from today
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"},{"description":{"content":"Optional [Date]: Date of the snapshot (YYYY-MM-DD). If no snapshot is present on the provided date, uses the last snapshot before the provided date
\n","type":"text/plain"},"key":"snapshotDate","value":"{{snapshotDate}}"}],"variable":[]}},"response":[{"id":"1db4d695-8c53-4bf2-9253-91a75d2a991b","name":"Crude/Co – World – Supply & Demand metrics","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand?product=Crude/Co&metrics=supply,demand&split=total&startDate=2022-08-01&endDate=2022-08-31","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"metrics","value":"supply,demand","description":"**Required [String]**: List of metrics to retrieve. The list of metrics available per product can be retrieved from the `/v1/supply-demand/products` route"},{"key":"split","value":"total","description":"**Required [String]**: How to split the data [\"total\", \"country\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-08-31","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 18 month from today"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-10-06;2022-08-01;Crude/Co;demand;World;81298;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;World;80941;kbd\n"},{"id":"bb349e46-019f-42d8-b3b1-c050f484c535","name":"Crude/Co – Europe – Supply & Demand metrics, split by country","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand?product=Crude/Co&metrics=supply,demand&split=country&zones=Europe&startDate=2022-08-01&endDate=2022-08-31","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"metrics","value":"supply,demand","description":"**Required [String]**: List of metrics to retrieve. The list of metrics available per product can be retrieved from the `/v1/supply-demand/products` route"},{"key":"split","value":"country","description":"**Required [String]**: How to split the data [\"total\", \"country\"]"},{"key":"zones","value":"Europe","description":"Optional [String]: Names of the zones (region/country/continent). Default to world when not provided"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-08-31","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 18 month from today"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-10-06;2022-08-01;Crude/Co;demand;Poland;531;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Czech Republic;167;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Belarus;247;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Ireland;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Netherlands;900;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Norway;1838;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Bulgaria;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Austria;35;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Ireland;66;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Belgium;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;France;854;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Spain;1318;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Albania;11;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Denmark;56;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Georgia;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Belgium;620;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Italy;1406;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Lithuania;192;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Hungary;72;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Turkey;68;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Hungary;14;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Kazakhstan;372;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Greece;469;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;United Kingdom;1032;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Georgia;0;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Sweden;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Croatia;79;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Italy;96;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Poland;18;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Romania;61;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Austria;10;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Sweden;413;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Portugal;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Norway;193;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Finland;204;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;France;12;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Germany;1731;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Ukraine;14;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Spain;0;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Finland;0;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Turkey;759;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Romania;238;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;United Kingdom;571;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Ukraine;1;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Slovak Republic;123;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Switzerland;0;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Croatia;11;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Albania;12;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Denmark;166;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Czech Republic;1;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Slovak Republic;0;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Lithuania;1;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Portugal;168;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Germany;33;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Kazakhstan;1469;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Greece;2;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Switzerland;63;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Belarus;29;kbd\n2022-10-06;2022-08-01;Crude/Co;demand;Bulgaria;152;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Netherlands;9;kbd\n"},{"id":"b264f017-7314-4f47-96d8-32c1dc506ad4","name":"Crude/Co – Europe – Supply & Demand metrics","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand?product=Crude/Co&metrics=supply,demand&split=total&zones=Europe&startDate=2022-08-01&endDate=2022-08-31","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"metrics","value":"supply,demand","description":"**Required [String]**: List of metrics to retrieve. The list of metrics available per product can be retrieved from the `/v1/supply-demand/products` route"},{"key":"split","value":"total","description":"**Required [String]**: How to split the data [\"total\", \"country\"]"},{"key":"zones","value":"Europe","description":"Optional [String]: Names of the zones (region/country/continent). Default to world when not provided"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-08-31","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 18 month from today"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-10-06;2022-08-01;Crude/Co;demand;Europe;12583;kbd\n2022-10-06;2022-08-01;Crude/Co;supply;Europe;4324;kbd\n"},{"id":"1923d5b1-c7e7-45c6-a0e1-b6f7b0755d85","name":"Crude/Co – SnapshotDate","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand?product=Crude/Co&metrics=supply,demand&split=total&zones=Europe,China&startDate=2022-08-01&endDate=2022-08-31&snapshotDate=2022-09-10","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"metrics","value":"supply,demand","description":"**Required [String]**: List of metrics to retrieve. The list of metrics available per product can be retrieved from the `/v1/supply-demand/products` route"},{"key":"split","value":"total","description":"**Required [String]**: How to split the data [\"total\", \"country\"]"},{"key":"zones","value":"Europe,China","description":"Optional [String]: Names of the zones (region/country/continent). Default to world when not provided"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-08-31","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 18 month from today"},{"key":"snapshotDate","value":"2022-09-10","description":"Optional [Date]: Date of the snapshot (YYYY-MM-DD). If no snapshot is present on the provided date, uses the last snapshot before the provided date"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-09-02;2022-08-01;Crude/Co;demand;China, Europe;25179;kbd\n2022-09-02;2022-08-01;Crude/Co;supply;China, Europe;8319;kbd\n"}],"_postman_id":"f6ca4b03-f336-46aa-99f8-3e548ecd412c"},{"name":"/v1/supply-demand/snapshots","id":"0f64641e-d7aa-48c0-9f89-8bbee6827013","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n"}],"url":"{{HOST_URL}}/v1/supply-demand/snapshots?product={{product}}&startDate={{startDate}}&endDate={{endDate}}","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","supply-demand","snapshots"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Required [String]: Name of the product to retrieve data for
\n","type":"text/plain"},"key":"product","value":"{{product}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"}],"variable":[]}},"response":[{"id":"fb96db51-749c-4ffa-8692-2cde945bc3ca","name":"Crude/Co – No date limit","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/snapshots?product=Crude/Co","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","snapshots"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Date;Product\n2022-06-14;Crude/Co\n2022-06-24;Crude/Co\n2022-07-04;Crude/Co\n2022-07-12;Crude/Co\n2022-07-22;Crude/Co\n2022-08-02;Crude/Co\n2022-08-12;Crude/Co\n2022-08-22;Crude/Co\n2022-09-02;Crude/Co\n2022-09-12;Crude/Co\n2022-09-22;Crude/Co\n2022-10-03;Crude/Co\n2022-10-06;Crude/Co\n"},{"id":"b59d88ef-25d9-45be-bde6-ef4f86d81950","name":"Crude/Co – Start date limit","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/snapshots?product=Crude/Co&startDate=2022-08-06","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","snapshots"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"startDate","value":"2022-08-06","description":"Optional [Date]: Start of the period (YYYY-MM-DD)"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Date;Product\n2022-08-12;Crude/Co\n2022-08-22;Crude/Co\n2022-09-02;Crude/Co\n2022-09-12;Crude/Co\n2022-09-22;Crude/Co\n2022-10-03;Crude/Co\n2022-10-06;Crude/Co\n"},{"id":"f1833cc7-0111-4051-aba5-e612a88c3952","name":"Crude/Co – End date limit","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/snapshots?product=Crude/Co&endDate=2022-09-23","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","snapshots"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"endDate","value":"2022-09-23","description":"Optional [Date]: End of the period (YYYY-MM-DD)"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Date;Product\n2022-06-14;Crude/Co\n2022-06-24;Crude/Co\n2022-07-04;Crude/Co\n2022-07-12;Crude/Co\n2022-07-22;Crude/Co\n2022-08-02;Crude/Co\n2022-08-12;Crude/Co\n2022-08-22;Crude/Co\n2022-09-02;Crude/Co\n2022-09-12;Crude/Co\n2022-09-22;Crude/Co\n"},{"id":"c60d8116-ec7b-4fe1-99ff-0fb543977aea","name":"Crude/Co – Start and end date limit","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/snapshots?product=Crude/Co&startDate=2022-08-06&endDate=2022-09-23","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","snapshots"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for"},{"key":"startDate","value":"2022-08-06","description":"Optional [Date]: Start of the period (YYYY-MM-DD)"},{"key":"endDate","value":"2022-09-23","description":"Optional [Date]: End of the period (YYYY-MM-DD)"}]}},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Date;Product\n2022-08-12;Crude/Co\n2022-08-22;Crude/Co\n2022-09-02;Crude/Co\n2022-09-12;Crude/Co\n2022-09-22;Crude/Co\n"}],"_postman_id":"0f64641e-d7aa-48c0-9f89-8bbee6827013"},{"name":"/v1/supply-demand/products","id":"42c8c4e9-c2f6-485f-bf1f-132133b66dcb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n"}],"url":"{{HOST_URL}}/v1/supply-demand/products","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","supply-demand","products"],"host":["{{HOST_URL}}"],"query":[],"variable":[]}},"response":[{"id":"6a196c8d-1206-411c-997c-79c4e0cf8db1","name":"List products","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":"https://api.kpler.com/v1/supply-demand/products"},"code":200,"_postman_previewlanguage":null,"header":[],"cookie":[],"responseTime":null,"body":"Product;Metrics;Snapshot Start Date;Snapshot End Date\nCrude/Co;supply,demand,refineryRun,directCrudeUse,balance,netExport,stockChange,balancingFactor;2022-06-14;2022-10-06\n"}],"_postman_id":"42c8c4e9-c2f6-485f-bf1f-132133b66dcb"},{"name":"/v1/supply-demand/us-balances","id":"0b1973b2-dea1-4f2f-a8d2-0fc18c33a0f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n"}],"url":"{{HOST_URL}}/v1/supply-demand/us-balances?product={{product}}&metrics={{metrics}}&granularity={{granularity}}&startDate={{startDate}}&endDate={{endDate}}","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","supply-demand","us-balances"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Required [String]: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]
\n","type":"text/plain"},"key":"product","value":"{{product}}"},{"description":{"content":"Required [String]: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]
\n","type":"text/plain"},"key":"metrics","value":"{{metrics}}"},{"description":{"content":"Required [String]: Which granularity of data to retrieve [\"weeks\", \"months\"]
\n","type":"text/plain"},"key":"granularity","value":"{{granularity}}"},{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"}],"variable":[]}},"response":[{"id":"1e364260-65ba-406d-929f-8a9b5853d683","name":"Crude/Co – US – All metrics – monthly","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-balances?product=Crude/Co&metrics=ADJUSTMENT,CANADA,NET_IMPORT,NET_INPUT,PRODUCTION,STOCK_CHANGE&granularity=months&startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-balances"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]"},{"key":"metrics","value":"ADJUSTMENT,CANADA,NET_IMPORT,NET_INPUT,PRODUCTION,STOCK_CHANGE","description":"**Required [String]**: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]"},{"key":"granularity","value":"months","description":"**Required [String]**: Which granularity of data to retrieve [\"weeks\", \"months\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2023-06-06;2022-08-01;Crude/Co;NET_INPUT;United States;16389;kbd\n2023-06-06;2022-08-01;Crude/Co;CANADA;United States;3938;kbd\n2023-06-06;2022-08-01;Crude/Co;ADJUSTMENT;United States;19900;kbd\n2023-06-06;2022-08-01;Crude/Co;NET_IMPORT;United States;2910;kbd\n2023-06-06;2022-08-01;Crude/Co;PRODUCTION;United States;12232;kbd\n2023-06-06;2022-08-01;Crude/Co;STOCK_CHANGE (kb);United States;-18757;kbd\n2023-06-06;2022-09-01;Crude/Co;PRODUCTION;United States;12229;kbd\n2023-06-06;2022-09-01;Crude/Co;STOCK_CHANGE (kb);United States;-2640;kbd\n2023-06-06;2022-09-01;Crude/Co;ADJUSTMENT;United States;26100;kbd\n2023-06-06;2022-09-01;Crude/Co;NET_IMPORT;United States;2770;kbd\n2023-06-06;2022-09-01;Crude/Co;NET_INPUT;United States;15957;kbd\n2023-06-06;2022-09-01;Crude/Co;CANADA;United States;3942;kbd\n"},{"id":"fa2acd4d-cf7f-440a-a5b6-19e916923619","name":"Crude/Co – US – All metrics – weekly","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-balances?product=Crude/Co&metrics=ADJUSTMENT,CANADA,NET_IMPORT,NET_INPUT,PRODUCTION,STOCK_CHANGE&granularity=weeks&startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-balances"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]"},{"key":"metrics","value":"ADJUSTMENT,CANADA,NET_IMPORT,NET_INPUT,PRODUCTION,STOCK_CHANGE","description":"**Required [String]**: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]"},{"key":"granularity","value":"weeks","description":"**Required [String]**: Which granularity of data to retrieve [\"weeks\", \"months\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2023-06-06;2022-08-05;Crude/Co;ADJUSTMENT;United States;5300;kbd\n2023-06-06;2022-08-05;Crude/Co;PRODUCTION;United States;12283;kbd\n2023-06-06;2022-08-05;Crude/Co;STOCK_CHANGE (kb);United States;2339;kbd\n2023-06-06;2022-08-05;Crude/Co;CANADA;United States;3838;kbd\n2023-06-06;2022-08-05;Crude/Co;NET_INPUT;United States;16186;kbd\n2023-06-06;2022-08-05;Crude/Co;NET_IMPORT;United States;3480;kbd\n2023-06-06;2022-08-12;Crude/Co;NET_INPUT;United States;16456;kbd\n2023-06-06;2022-08-12;Crude/Co;ADJUSTMENT;United States;3400;kbd\n2023-06-06;2022-08-12;Crude/Co;PRODUCTION;United States;12230;kbd\n2023-06-06;2022-08-12;Crude/Co;CANADA;United States;3838;kbd\n2023-06-06;2022-08-12;Crude/Co;STOCK_CHANGE (kb);United States;-7023;kbd\n2023-06-06;2022-08-12;Crude/Co;NET_IMPORT;United States;2737;kbd\n2023-06-06;2022-08-19;Crude/Co;STOCK_CHANGE (kb);United States;-5844;kbd\n2023-06-06;2022-08-19;Crude/Co;PRODUCTION;United States;12230;kbd\n2023-06-06;2022-08-19;Crude/Co;NET_INPUT;United States;16318;kbd\n2023-06-06;2022-08-19;Crude/Co;ADJUSTMENT;United States;8100;kbd\n2023-06-06;2022-08-19;Crude/Co;NET_IMPORT;United States;2096;kbd\n2023-06-06;2022-08-19;Crude/Co;CANADA;United States;3838;kbd\n2023-06-06;2022-08-26;Crude/Co;STOCK_CHANGE (kb);United States;-6669;kbd\n2023-06-06;2022-08-26;Crude/Co;NET_INPUT;United States;16342;kbd\n2023-06-06;2022-08-26;Crude/Co;NET_IMPORT;United States;2445;kbd\n2023-06-06;2022-08-26;Crude/Co;PRODUCTION;United States;12230;kbd\n2023-06-06;2022-08-26;Crude/Co;ADJUSTMENT;United States;5000;kbd\n2023-06-06;2022-08-26;Crude/Co;CANADA;United States;3838;kbd\n"},{"id":"13425466-806d-4ed4-9311-c4b703e2de0e","name":"Crude/Co – US – Single metric – monthly","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-balances?product=Crude/Co&metrics=PRODUCTION&granularity=months&startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-balances"],"query":[{"key":"product","value":"Crude/Co","description":"**Required [String]**: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]"},{"key":"metrics","value":"PRODUCTION","description":"**Required [String]**: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]"},{"key":"granularity","value":"months","description":"**Required [String]**: Which granularity of data to retrieve [\"weeks\", \"months\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-11-28;2022-08-01;Crude/Co;PRODUCTION;United States;12232;kbd\n2022-11-28;2022-09-01;Crude/Co;PRODUCTION;United States;12229;kbd\n"},{"id":"492c2831-bf2b-4308-949e-7836ed9cd597","name":"Gasoline – US PADD 1 – All metrics – monthly","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-balances?product=Gasoline&metrics=BLENDER,DEMAND,IMPORT,NET_RECEIPT,PIPE_IN,PIPE_OUT,REFINERY,WATERBORNE&granularity=months&startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-balances"],"query":[{"key":"product","value":"Gasoline","description":"**Required [String]**: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]"},{"key":"metrics","value":"BLENDER,DEMAND,IMPORT,NET_RECEIPT,PIPE_IN,PIPE_OUT,REFINERY,WATERBORNE","description":"**Required [String]**: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]"},{"key":"granularity","value":"months","description":"**Required [String]**: Which granularity of data to retrieve [\"weeks\", \"months\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-11-25;2022-08-01;Gasoline;REFINERY;United States;60;kbd\n2022-11-25;2022-08-01;Gasoline;WATERBORNE;United States;517;kbd\n2022-11-25;2022-08-01;Gasoline;BLENDER;United States;3180;kbd\n2022-11-25;2022-08-01;Gasoline;NET_RECEIPT;United States;1780;kbd\n2022-11-25;2022-08-01;Gasoline;IMPORT;United States;641;kbd\n2022-11-25;2022-08-01;Gasoline;DEMAND;United States;5725;kbd\n2022-11-25;2022-08-01;Gasoline;PIPE_IN;United States;1557;kbd\n2022-11-25;2022-08-01;Gasoline;PIPE_OUT;United States;229;kbd\n2022-11-25;2022-09-01;Gasoline;NET_RECEIPT;United States;1780;kbd\n2022-11-25;2022-09-01;Gasoline;DEMAND;United States;5476;kbd\n2022-11-25;2022-09-01;Gasoline;REFINERY;United States;58;kbd\n2022-11-25;2022-09-01;Gasoline;WATERBORNE;United States;424;kbd\n2022-11-25;2022-09-01;Gasoline;PIPE_IN;United States;1490;kbd\n2022-11-25;2022-09-01;Gasoline;BLENDER;United States;3090;kbd\n2022-11-25;2022-09-01;Gasoline;PIPE_OUT;United States;208;kbd\n2022-11-25;2022-09-01;Gasoline;IMPORT;United States;653;kbd\n"},{"id":"50ddfae9-3d9f-428a-bb13-dd4ecdaeac47","name":"Gasoline – US PADD 1 – All metrics – weekly","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-balances?product=Gasoline&metrics=BLENDER,DEMAND,IMPORT,NET_RECEIPT,padd1astock,padd1bstock,padd1cstock,PIPE_IN,PIPE_OUT,REFINERY,WATERBORNE&granularity=weeks&startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-balances"],"query":[{"key":"product","value":"Gasoline","description":"**Required [String]**: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]"},{"key":"metrics","value":"BLENDER,DEMAND,IMPORT,NET_RECEIPT,padd1astock,padd1bstock,padd1cstock,PIPE_IN,PIPE_OUT,REFINERY,WATERBORNE","description":"**Required [String]**: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]"},{"key":"granularity","value":"weeks","description":"**Required [String]**: Which granularity of data to retrieve [\"weeks\", \"months\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-08-29;2022-08-05;Gasoline;PIPE_IN;United States;1524;kbd\n2022-08-29;2022-08-05;Gasoline;PIPE_OUT;United States;226;kbd\n2022-08-29;2022-08-05;Gasoline;DEMAND;United States;5771;kbd\n2022-08-29;2022-08-05;Gasoline;REFINERY;United States;61;kbd\n2022-08-29;2022-08-05;Gasoline;BLENDER;United States;3157;kbd\n2022-08-29;2022-08-05;Gasoline;padd1cstock;United States;24935;kbd\n2022-08-29;2022-08-05;Gasoline;padd1astock;United States;3063;kbd\n2022-08-29;2022-08-05;Gasoline;IMPORT;United States;488;kbd\n2022-08-29;2022-08-05;Gasoline;NET_RECEIPT;United States;1841;kbd\n2022-08-29;2022-08-05;Gasoline;WATERBORNE;United States;455;kbd\n2022-08-29;2022-08-05;Gasoline;padd1bstock;United States;24398;kbd\n2022-08-29;2022-08-12;Gasoline;BLENDER;United States;3173;kbd\n2022-08-29;2022-08-12;Gasoline;DEMAND;United States;5684;kbd\n2022-08-29;2022-08-12;Gasoline;PIPE_OUT;United States;227;kbd\n2022-08-29;2022-08-12;Gasoline;WATERBORNE;United States;539;kbd\n2022-08-29;2022-08-12;Gasoline;padd1cstock;United States;23397;kbd\n2022-08-29;2022-08-12;Gasoline;IMPORT;United States;518;kbd\n2022-08-29;2022-08-12;Gasoline;padd1astock;United States;2998;kbd\n2022-08-29;2022-08-12;Gasoline;padd1bstock;United States;23658;kbd\n2022-08-29;2022-08-12;Gasoline;REFINERY;United States;56;kbd\n2022-08-29;2022-08-12;Gasoline;NET_RECEIPT;United States;1848;kbd\n2022-08-29;2022-08-12;Gasoline;PIPE_IN;United States;1524;kbd\n2022-08-29;2022-08-19;Gasoline;REFINERY;United States;49;kbd\n2022-08-29;2022-08-19;Gasoline;WATERBORNE;United States;391;kbd\n2022-08-29;2022-08-19;Gasoline;NET_RECEIPT;United States;1737;kbd\n2022-08-29;2022-08-19;Gasoline;padd1astock;United States;2860;kbd\n2022-08-29;2022-08-19;Gasoline;padd1cstock;United States;23566;kbd\n2022-08-29;2022-08-19;Gasoline;padd1bstock;United States;23029;kbd\n2022-08-29;2022-08-19;Gasoline;IMPORT;United States;606;kbd\n2022-08-29;2022-08-19;Gasoline;DEMAND;United States;5734;kbd\n2022-08-29;2022-08-19;Gasoline;PIPE_OUT;United States;227;kbd\n2022-08-29;2022-08-19;Gasoline;BLENDER;United States;3251;kbd\n2022-08-29;2022-08-19;Gasoline;PIPE_IN;United States;1524;kbd\n2022-08-29;2022-08-26;Gasoline;PIPE_OUT;United States;227;kbd\n2022-08-29;2022-08-26;Gasoline;WATERBORNE;United States;514;kbd\n2022-08-29;2022-08-26;Gasoline;PIPE_IN;United States;1524;kbd\n2022-08-29;2022-08-26;Gasoline;BLENDER;United States;3193;kbd\n2022-08-29;2022-08-26;Gasoline;DEMAND;United States;5684;kbd\n2022-08-29;2022-08-26;Gasoline;padd1astock;United States;2979;kbd\n2022-08-29;2022-08-26;Gasoline;padd1bstock;United States;24554;kbd\n2022-08-29;2022-08-26;Gasoline;IMPORT;United States;623;kbd\n2022-08-29;2022-08-26;Gasoline;padd1cstock;United States;25273;kbd\n2022-08-29;2022-08-26;Gasoline;NET_RECEIPT;United States;1915;kbd\n2022-08-29;2022-08-26;Gasoline;REFINERY;United States;53;kbd\n"},{"id":"0ab0e85f-7304-4d20-b03b-74479420d90f","name":"Gasoline – US PADD1 – Single metric – monthly","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-balances?product=Gasoline&metrics=DEMAND&granularity=months&startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-balances"],"query":[{"key":"product","value":"Gasoline","description":"**Required [String]**: Name of the product to retrieve data for [\"Crude/Co\", \"Gasoline\"]"},{"key":"metrics","value":"DEMAND","description":"**Required [String]**: List of metrics to retrieve.\nFor Crude/Co: [\"ADJUSTMENT\", \"CANADA\", \"NET_IMPORT\", \"NET_INPUT\", \"PRODUCTION\", \"STOCK_CHANGE\"]\nFor Gasoline: [\"BLENDER\", \"DEMAND\", \"IMPORT\", \"NET_RECEIPT\", \"padd1astock\", \"padd1bstock\", \"padd1cstock\", \"PIPE_IN\", \"PIPE_OUT\", \"REFINERY\", \"WATERBORNE\"]"},{"key":"granularity","value":"months","description":"**Required [String]**: Which granularity of data to retrieve [\"weeks\", \"months\"]"},{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;Product;Metric;Zones;Value;Unit\n2022-11-25;2022-08-01;Gasoline;DEMAND;United States;5725;kbd\n2022-11-25;2022-09-01;Gasoline;DEMAND;United States;5476;kbd\n"}],"_postman_id":"0b1973b2-dea1-4f2f-a8d2-0fc18c33a0f8"},{"name":"/v1/supply-demand/us-stocks","id":"26a3e66f-257a-4f3c-9c0e-dd433505487c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"Required [String]: Token
\n"}],"url":"{{HOST_URL}}/v1/supply-demand/us-stocks?startDate={{startDate}}&endDate={{endDate}}","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","supply-demand","us-stocks"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01
\n","type":"text/plain"},"key":"startDate","value":"{{startDate}}"},{"description":{"content":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today
\n","type":"text/plain"},"key":"endDate","value":"{{endDate}}"}],"variable":[]}},"response":[{"id":"df4be322-32fe-4b51-9fa5-427ccc109c30","name":"Crude/Co – Stock projections","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer YOUR_TOKEN","description":"**Required [String]**: Token"}],"url":{"raw":"https://api.kpler.com/v1/supply-demand/us-stocks?startDate=2022-08-01&endDate=2022-09-01","protocol":"https","host":["api","kpler","com"],"path":["v1","supply-demand","us-stocks"],"query":[{"key":"startDate","value":"2022-08-01","description":"Optional [Date]: Start of the period (YYYY-MM-DD), must be after 2017-01-01"},{"key":"endDate","value":"2022-09-01","description":"Optional [Date]: End of the period (YYYY-MM-DD), maximum of 12 month from today"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":null,"cookie":[],"responseTime":null,"body":"Snapshot Date;Date;EIA Stocks;Stocks\n2022-08-05;2022-08-05;432010;430397\n2022-08-08;2022-08-05;432010;428892\n2022-08-12;2022-08-12;424954;427609\n2022-08-15;2022-08-12;424954;424987\n2022-08-19;2022-08-19;421672;418733\n2022-08-22;2022-08-19;421672;419110\n2022-08-26;2022-08-26;418346;420687\n2022-08-29;2022-08-26;418346;415003\n"}],"_postman_id":"26a3e66f-257a-4f3c-9c0e-dd433505487c"}],"id":"09be83c4-55fe-426d-8b1a-976105d2966c","_postman_id":"09be83c4-55fe-426d-8b1a-976105d2966c","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Fixtures","item":[{"name":"/v1/fixtures","id":"cd1a825b-fb03-4645-86bc-13f3d837c4e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{HOST_URL}}/v1/fixtures?size={{size}}&reportedDateAfter={{reportedDateAfter}}&reportedDateBefore={{reportedDateBefore}}&layCanStartAfter={{layCanStartAfter}}&layCanStartBefore={{layCanStartBefore}}&fromZones={{fromZones}}&toZones={{toZones}}&products={{products}}&dwtMin={{dwtMin}}&dwtMax={{dwtMax}}&statuses={{statuses}}&vesselTypesCpp={{vesselTypesCpp}}&vesselTypesOil={{vesselTypesOil}}&vessels={{vessels}}","description":"What is {{HOST_URL}} and where do we find it?
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"path":["v1","fixtures"],"host":["{{HOST_URL}}"],"query":[{"description":{"content":"Optional [Integer]: By default: size=1000 Maximum number of results returned.
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"description":{"content":"Optional [Date]: Get fixtures reported on or after this date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"reportedDateAfter","value":"{{reportedDateAfter}}"},{"description":{"content":"Optional [Date]: Get fixtures reported on or before this date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"reportedDateBefore","value":"{{reportedDateBefore}}"},{"description":{"content":"Optional [Date]: Get fixtures with loading window start date after this date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"layCanStartAfter","value":"{{layCanStartAfter}}"},{"description":{"content":"Optional [Date]: Get fixtures with loading window start date before this date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"layCanStartBefore","value":"{{layCanStartBefore}}"},{"description":{"content":"Optional [String]: From names of zones (port/region/country/continent). eg: China,Gulf of Oman
\n","type":"text/plain"},"key":"fromZones","value":"{{fromZones}}"},{"description":{"content":"Optional [String]: To names of zones (port/region/country/continent). eg: China,Gulf of Oman
\n","type":"text/plain"},"key":"toZones","value":"{{toZones}}"},{"description":{"content":"Optional [String]: Names of products
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Optional [Integer]: Get vessels with deadweight greater or equal to this value by default 0
\n","type":"text/plain"},"key":"dwtMin","value":"{{dwtMin}}"},{"description":{"content":"Optional [Integer]: Get vessels with deadweight lower or equal to this value by default 606550
\n","type":"text/plain"},"key":"dwtMax","value":"{{dwtMax}}"},{"description":{"content":"Optional [String]: Status of the fixture (On Subs/In Progress/Fully Fixed/Finished/Failed/Cancelled)
\n","type":"text/plain"},"key":"statuses","value":"{{statuses}}"},{"description":{"content":"Optional [String]: For given cpp vessel types\n
Optional [String]: For given oil vessel types\n
Optional [String]: Names of the vessel
\n","type":"text/plain"},"key":"vessels","value":"{{vessels}}"}],"variable":[]}},"response":[{"id":"9a6677d1-8ca4-43ff-afa3-bcddc7007ca5","name":"Liquids - List of fixtures","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.kpler.com/v1/fixtures?toZones=Singapore&layCanStartAfter=2000-01-01&layCanStartBefore=2021-12-08&size=100&reportedDateAfte=2020-12-01&reportedDateBefore=2020-12-31","protocol":"https","host":["api","kpler","com"],"path":["v1","fixtures"],"query":[{"key":"toZones","value":"Singapore"},{"key":"layCanStartAfter","value":"2000-01-01"},{"key":"layCanStartBefore","value":"2021-12-08"},{"key":"size","value":"100"},{"key":"reportedDateAfte","value":"2020-12-01"},{"key":"reportedDateBefore","value":"2020-12-31"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Reported date;Vessel;IMO;Quantity (t);Deadweight (t);Family;Group;Product;Charterer;Vessel owner;Laycan start;Laycan end;Origin;Destination;Rates ($ price);Status;Vessel Type Cpp;Vessel Type Oil\n2020-12-09;Nautical Janine;9794848;60000.0;75111;;;Alkylate;CSSA;Nautical Bulk Holding;2020-12-25;2020-12-25;Sikka;Europe, Singapore;;On Subs;LR1;Panamax\n2020-12-09;Aura M.;9595333;130000.0;156245;;;Fuel Oils;Mercuria;Yangzijiang Shipping;2020-12-19;2020-12-19;Augusta;Singapore;;Fully Fixed;LR3;Suezmax\n2020-12-09;Sanmar Sruthi;9181869;60000.0;73980;;;Gasoil;Lukoil;UNION MARITIME LTD;2020-12-17;2020-12-17;Sikka;Western Africa, Singapore;;On Subs;LR1;Panamax\n2020-12-09;Vinalines Galaxy;9337339;35000.0;50530;;;Gasoil;UNIPEC;VINALINES;2020-12-17;2020-12-17;Sikka;Singapore;152.5;On Subs;MR;Product Tanker\n2020-12-09;Sti Solidarity;9708576;90000.0;109999;;;Alkylate;BP;Bank of Communications;2020-12-16;2020-12-16;Daesan;Singapore;;Fully Fixed;LR2;Aframax\n2020-12-09;Cielo Di Londra;9791872;60000.0;74999;;;Gasoline;ENOC;D'AMICO TANKERS DAC;2020-12-14;2020-12-14;Shandong;Singapore;375000.0;Fully Fixed;LR1;Panamax"}],"_postman_id":"cd1a825b-fb03-4645-86bc-13f3d837c4e4"}],"id":"ba6d3694-a7c6-417a-96c2-dc0e3a02d283","_postman_id":"ba6d3694-a7c6-417a-96c2-dc0e3a02d283","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Products","item":[{"name":"/v1/products","id":"415e16ad-3029-403d-9aa8-5328d3492e7a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/products?size={{size}}&ancestorFamilyIds={{ancestorFamilyIds}}&ancestorFamilyNames={{ancestorFamilyNames}}&ancestorGroupIds={{ancestorGroupIds}}&ancestorGroupNames={{ancestorGroupNames}}&ancestorProductIds={{ancestorProductIds}}&ancestorProductNames={{ancestorProductNames}}&ancestorGradeIds={{ancestorGradeIds}}&ancestorGradeNames={{ancestorGradeNames}}&products={{products}}&productIds={{productIds}}","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","products"],"host":["api","kpler","com"],"query":[{"key":"size","value":"{{size}}"},{"description":{"content":"IDs of a product Family. Can be separated by a coma.
\n","type":"text/plain"},"key":"ancestorFamilyIds","value":"{{ancestorFamilyIds}}"},{"description":{"content":"Default to the whole tree if not specified. Possible values are : Light Ends, NPC, DPP, Middle Distillate, Dirty
\n","type":"text/plain"},"key":"ancestorFamilyNames","value":"{{ancestorFamilyNames}}"},{"description":{"content":"IDs of a product Group. Can be separated by a coma.
\n","type":"text/plain"},"key":"ancestorGroupIds","value":"{{ancestorGroupIds}}"},{"description":{"content":"Default to the whole tree if not specified. Possible values are : Kero/Jet, Crude/Co, , Fuel Oils, etc...
\n","type":"text/plain"},"key":"ancestorGroupNames","value":"{{ancestorGroupNames}}"},{"description":{"content":"IDs of a product Product. Can be separated by a coma.
\n","type":"text/plain"},"key":"ancestorProductIds","value":"{{ancestorProductIds}}"},{"description":{"content":"Default to the whole tree if not specified. Possible values are : Jet, Crude, Clean Condensate, etc ...
\n","type":"text/plain"},"key":"ancestorProductNames","value":"{{ancestorProductNames}}"},{"description":{"content":"IDs of a product Grade. Can be separated by a coma.
\n","type":"text/plain"},"key":"ancestorGradeIds","value":"{{ancestorGradeIds}}"},{"description":{"content":"Default to the whole tree if not specified. Possible values are : RBOB, Solvent Naphtha, LSHO, 91 Gasoline,...
\n","type":"text/plain"},"key":"ancestorGradeNames","value":"{{ancestorGradeNames}}"},{"description":{"content":"Names of Products of all different tree levels (Family, Group, Product, Grade)
\n","type":"text/plain"},"key":"products","value":"{{products}}"},{"description":{"content":"Ids of possible products. Can be separated by a coma
\n","type":"text/plain"},"key":"productIds","value":"{{productIds}}"}],"variable":[]}},"response":[{"id":"8f93ec2e-c895-4c3a-9c3e-afb1fbc95d21","name":"Liquids- products","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.kpler.com/v1/products?size=100&ancestorFamilyNames=DPP","protocol":"https","host":["api","kpler","com"],"path":["v1","products"],"query":[{"key":"size","value":"100"},{"key":"ancestorFamilyNames","value":"DPP"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"415e16ad-3029-403d-9aa8-5328d3492e7a"}],"id":"7233417d-cc21-47fc-94c8-92db52d27415","description":"The Products query requests the product tree of Kpler and the relationship between these different layers. This is a static table and works using our following layers Families > Groups > Products > Grades.
\n","_postman_id":"7233417d-cc21-47fc-94c8-92db52d27415","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Zones","item":[{"name":"/v1/zones","id":"8d6b90ee-549c-4d38-89c1-affeafab6f25","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/zones?ancestorId={{ancestorId}}&ancestorName={{ancestorName}}&ancestorType={{ancestorType}}&descendantId={{descendantId}}&descendantName={{descendantName}}&descendantType={{descendantType}}","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","zones"],"host":["api","kpler","com"],"query":[{"description":{"content":"IDs ancestor zones. Can be separated by a coma.
\n","type":"text/plain"},"key":"ancestorId","value":"{{ancestorId}}"},{"description":{"content":"Names ancestor zones. Can be separated by a coma.
\n","type":"text/plain"},"key":"ancestorName","value":"{{ancestorName}}"},{"description":{"content":"Type of ancestor zones. Can be separated by a coma. e.g. continent, subcontinent,region, subregion, country, port, custom, bay, cape, gulf, ocean, sea, strait, ...
\n","type":"text/plain"},"key":"ancestorType","value":"{{ancestorType}}"},{"description":{"content":"IDs descendant zones. Can be separated by a coma.
\n","type":"text/plain"},"key":"descendantId","value":"{{descendantId}}"},{"description":{"content":"Names descendant zones. Can be separated by a coma.
\n","type":"text/plain"},"key":"descendantName","value":"{{descendantName}}"},{"description":{"content":"Type of descendant zones. Can be separated by a coma. e.g. continent, subcontinent,region, subregion, country, port, custom, bay, cape, gulf, ocean, sea, strait, ...
\n","type":"text/plain"},"key":"descendantType","value":"{{descendantType}}"}],"variable":[]}},"response":[{"id":"95a7a21a-d671-4c94-b35f-dd2560de4ad0","name":"Liquids- get all ports in the Baltic Sea","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.kpler.com/v1/zones?ancestorName=Baltic Sea&descendantType=port","protocol":"https","host":["api","kpler","com"],"path":["v1","zones"],"query":[{"key":"ancestorName","value":"Baltic Sea"},{"key":"descendantType","value":"port"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null},{"id":"e3476b40-f169-4707-99bf-4ceb084c5c7d","name":"Liquids- get based on Descendant ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.kpler.com/v1/zones?descendantId=87","protocol":"https","host":["api","kpler","com"],"path":["v1","zones"],"query":[{"key":"descendantId","value":"87"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"8d6b90ee-549c-4d38-89c1-affeafab6f25"}],"id":"4e77d55d-a032-4202-9909-41c2e19d56f8","description":"The Zones query returns the Zones Hierarchy of Kpler and the relationship between these different layers. This is a static table and works using an ancestor/desdendant relationship.
\n","_postman_id":"4e77d55d-a032-4202-9909-41c2e19d56f8","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}},{"name":"Bills-of-lading","item":[{"name":"/v1/bills-of-lading","id":"38c76ecc-28dc-48a5-8768-74987011df70","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.kpler.com/v1/bills-of-lading?source={{source}}&billDateStart={{billDateStart}}&billDateEnd={{billDateEnd}}&size={{size}}&billNumber={{billNumber}}&movementDateStart={{movementDateStart}}&movementDateEnd={{movementDateEnd}}&portCalls={{portCalls}}","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","bills-of-lading"],"host":["api","kpler","com"],"query":[{"description":{"content":"Optional [String]: \"US Import BL\" or \"US Export BL\"
\n","type":"text/plain"},"key":"source","value":"{{source}}"},{"description":{"content":"Optional [Date]: Start of the period when BL was issued (YYYY-MM-DD)
\n","type":"text/plain"},"key":"billDateStart","value":"{{billDateStart}}"},{"description":{"content":"Optional [Date]: End of the period when BL was issued (YYYY-MM-DD)
\n","type":"text/plain"},"key":"billDateEnd","value":"{{billDateEnd}}"},{"description":{"content":"Optional [Integer]: Maximum number of BLs returned
\n","type":"text/plain"},"key":"size","value":"{{size}}"},{"description":{"content":"Optional [String]: Bill of Lading Number
\n","type":"text/plain"},"key":"billNumber","value":"{{billNumber}}"},{"description":{"content":"Optional [Date]: Start of the period when export or import took place (YYYY-MM-DD) as reported on the Bill of Lading. \nIf no export/import date is reported on the Bill of Lading, the movementDate is defaulted to the BL issue date
\n","type":"text/plain"},"key":"movementDateStart","value":"{{movementDateStart}}"},{"description":{"content":"Optional [Date]: End of the period when export or import took place (YYYY-MM-DD) as reported on the Bill of Lading. \nIf no export/import date is reported on the Bill of Lading, the movementDate is defaulted to the BL issue date
\n","type":"text/plain"},"key":"movementDateEnd","value":"{{movementDateEnd}}"},{"description":{"content":"Optional [Integer]: Port Call IDs
\n","type":"text/plain"},"key":"portCalls","value":"{{portCalls}}"}],"variable":[]}},"response":[],"_postman_id":"38c76ecc-28dc-48a5-8768-74987011df70"}],"id":"1c9d9aa7-fd9a-4f27-89e3-e6325660bedb","description":"The BoL (bills-of-lading) endpoint returns all the U.S. Import & Export Bills of Lading details as well as a corresponding Port Call ID registered in Kpler system.
\n","_postman_id":"1c9d9aa7-fd9a-4f27-89e3-e6325660bedb","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"ca98fde2-6222-4bb0-9569-550b4621baee","id":"ca98fde2-6222-4bb0-9569-550b4621baee","name":"Liquids API Direct Access User Guide","type":"collection"}}}],"auth":{"type":"oauth2","oauth2":{"basicConfig":[]}},"event":[{"listen":"prerequest","script":{"id":"bd6ea240-ff34-4f32-a1a5-ba5c93549ed0","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"fcc98dc6-c069-4d9f-877c-9fdc1f11165a","type":"text/javascript","requests":{},"exec":[""]}}]}