kpler

Automate Kpler oil and gas data retrieval with reusable Python client for notebooks and ETL pipelines.

Updated Aug 29, 2025
One-click install
npx skills add https://github.com/data-desk-eco/afungi-logistics --skill kpler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kpler
Source: https://github.com/data-desk-eco/afungi-logistics/tree/main/.claude/skills/kpler
Command: npx skills add https://github.com/data-desk-eco/afungi-logistics --skill kpler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, pyjwt, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

The Kpler data workflow is fragmented and manual; this Skill centralizes authentication, data retrieval, and basic ETL operations for Kpler's trade, flow, vessel, and fleet information.

Core Features & Use Cases

  • Authentication & session management: handles login, token refresh, and automatic token storage.
  • Data access & search: supports entity search across zones, installations, players, vessels, and products.
  • Trade & flow queries: fetches trades and flows with configurable filters, time ranges, and splits.
  • Vessel positions & fleet data: retrieves AIS positions and company fleet details for analytics.
  • Use case: Build notebooks or ETL pipelines to populate a local analytics database with Russia export flows and Shell trades.

Quick Start

Run the Kpler client in notebooks to fetch trades, flows, and vessel data for your zones and players.

Frequently Asked Questions about kpler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Kpler oil and gas data retrieval for an ETL pipeline?

You can automate Kpler oil and gas data retrieval by using a reusable Python client that handles login, token refresh, and request signing to fetch trades, flows, and vessel positions directly within your ETL pipelines. It manages session authentication automatically for continuous data workflows.

What is the best way to fetch vessel positions and fleet data from the Kpler API?

The best way to fetch vessel positions and fleet data from the Kpler API is through a Python client that executes entity searches and retrieves AIS positions with configurable filters. It manages the underlying API authentication and retry logic automatically for reliable data access.

Can I use Python to query Kpler trades and flows with custom time ranges?

Yes, you can use Python to query Kpler trades and flows with configurable filters, time ranges, and splits. The client manages token refresh and request signing, allowing you to retrieve specific trade data without manual authentication overhead.

Does the Kpler client handle token refresh automatically?

Yes, the Kpler client handles token refresh automatically. It manages login, automatic token storage, and request signing against the Kpler API, ensuring your data retrieval processes remain uninterrupted without requiring manual re-authentication.

How do I search for specific installations and players in the Kpler database?

You search for specific installations and players by using the client's entity search functionality across zones, installations, players, vessels, and products. This feature allows targeted queries within the Kpler database to identify specific market participants.

Why does my Kpler API request fail during high-volume data extraction?

Kpler API requests may fail during high-volume extraction due to token expiration or network timeouts. The client implements automatic token refresh and built-in retry logic to handle these transient failures and ensure reliable data retrieval.