Analytics Vortexa

From Data Analyst to Python Developer

  1. Mentors on my team who I could turn to when I was having an issue — Vortexa’s data scientists and engineers were more than willing to take time out of their day to help me build a complex query.
  2. Practice. The more queries I did the easier it became.

In the office raising money for Movember with two of my mentors Tino von Stegmann (left) and Kit Burgess (middle)

Finding Answers to Hot Topics in the Oil Market

Getting Started

In the SDK documentation, there is a setup FAQ section, found here. It covers everything you need to know to get started using the SDK on your machine; including where to request a demo.

Importing Modules and Libraries

At the start of the notebook, we have to import the libraries and modules which we are going to be using. In this notebook, we use three of the Vortexa SDK’s endpoints, the DateTime library, Pandas and Matplotlib. To use them in the notebook, we have to import them like this:

from vortexasdk import Products, CargoTimeSeries, Geographies
from datetime import datetime
import pandas as pd
import matplotlib.pyplot as plt

Products Endpoint Tutorial

First I’m going to show you how to get the Vortexa ID for a product you are interested in studying from the products endpoint. Whilst there are many ways of doing this, I will show you just one example that I believed was the best option. In the documentation for the products endpoint, we can see an example line of code which shows us how to look in for different products in a list.

df = Products().search(term=[‘diesel’, ‘fuel oil’, ‘grane’]).to_df()
crude_search_df = Products().search(term=[‘crude’]).to_df()
pd.set_option(‘max_colwidth’, 75)

CargoTimeSeries Endpoint Tutorial

First, let’s look at the example in the documentation:

Screenshot 2020-07-15 at 17.21.04CargoTimeSeries endpoint example from the SDK documentation
Screenshot 2020-07-15 at 17.21.24CargoTimeSeries endpoint example query changed to return floating storage in China

Exporting your data as a CSV

If you would like to export the final DataFrame as a CSV, use the following :


Final Thoughts

Today we’ve learned how to take example code from Vortexa’s Python SDK documentation and change it to fit a real-world example. This is a skill you can translate to any Python package. If you would like to look into more examples for the Vortexa SDK you can find all of the documentation here.


Jul 30, 2020

Heavy-sour crude tightness: Is it here to stay?

Tightness in global heavy sour crude markets has led to firming differentials for these grades in recent months, despite weaker demand sentiment in the overall crude complex.

Jul 29, 2020

Clean VLCC loading activity peaks in July

Diesel and jet fuel loadings onto newbuild very large crude carriers (VLCCs) have hit a peak for this year in July.

Our newsletter

Subscribe below to receive Vortexa news and updates