Practical patterns for programmatically accessing LSEG financial data with Python - cleaner requests, faster workflows, and fewer surprises once you know how the library works.

First time here? Read on - this page explains what the series covers, how examples work, and where to start. 

About This Series

A practical, volume-by-volume guide to the LSEG Data Library for Python (the lseg-data package) - the patterns, behaviours, and details that make your code cleaner, faster, and more predictable once you're past your first call.

lseg-data is LSEG's unified Python interface to financial data - pricing, fundamentals, news, estimates, ESG, and more. It is the successor to the Refinitiv Data Library for Python (refinitiv-data).

The official documentation already covers quick-starts, API reference, and cookbooks. This series complements those - it focuses on the things that aren't difficult once you know them, but aren't obvious the first time you meet them.

Who This Series Is For

This series assumes you've already made your first successful API call - you've installed lseg-data package, opened a session, and retrieved some data.

Now you're asking the questions that come after that:

• Am I using the right call for this?
• Is there a cleaner way to structure this request?
• Why did this return something I didn't expect?
• How do I handle this at scale?
• What's the fastest way to find the right field or instrument?

If those questions sound familiar, you're in the right place.

Not there yet? Start with the Quick Start Guide and come back once you've made your first successful call.

The Access Layers

The library connects in three ways. Most examples in this series use Desktop. For detailed documentation and access, please read the official documentation. 

Where behaviour differs meaningfully by layer, that's called out explicitly.

How Code Examples Work

To keep examples focused, most snippets assume a session is already open. The standard setup used throughout the series is:

• All examples use import lseg.data as ld as the import convention
• Outputs are shown as they appear in a Jupyter or Codebook environment
• DataFrames are rendered with default pandas display unless noted otherwise
• Where a snippet depends on earlier code in the same section, it says so explicitly

The Volumes

The series moves from a single call outward - to precision, then scale, then discovery etc.  Each volume is self-contained: dip into any one directly, or read them in order for the full picture.

Vol. 1 - Calls That Do More

Every workflow begins with a call. This volume covers what get_data() and get_history() actually do, how to control parameters inline and globally, how to retrieve metadata in the same request, how to shape your output for code rather than just reading, how to debug, and two shortcuts that quietly cut development time.

Vol. 2 - Asking What You Mean

Dates are simple until they're not. This volume covers relative versus absolute dates, pushing calculations to the server rather than post-processing, knowing exactly what a field supports before you request it, and structured news retrieval patterns.

Vol. 3 - Calls That Survives Scale

The same code that works perfectly for ten instruments can behave very differently when scaled to thousands. This volume covers the three patterns that make the difference: splitting requests safely, running them concurrently, and staying inside platform limits without babysitting the code.

Vol. 4 - Finding What to Fetch (to be published soon)

Not every workflow begins with a known RIC. This volume focuses on the discovery tools and retrieval methods that help you find instruments, build universes, navigate chains, and work with identifiers across time.

Elsewhere In The Official Docs

This series complements the official documentation - it doesn't replace it. For foundational reference and comprehensive coverage, these are the primary resources:

• Quick Start Guide - first-call walkthrough, session setup, access layer overview
• Data Item Browser (DIB) - the authoritative reference app for every field, its parameters, and propagation attributes. Search for DIB on LSEG Workspace to open it.
• Developer Community Forum - questions, answers, and discussion
• LSEG Developers GitHub - working code examples and notebooks

Feedback

Found an error, have a question, or want to suggest a topic for a future volume? Post it on the Developer Community Forum. 

Consolidated Series Index