Skip to content

eptr2

PyPI Version PyPI Downloads Python Version License

eptr2 is a Python client for EPIAS Transparency Platform v2.0 - the official Turkish electricity market data platform.

Live Demo

Try the live demo at https://eptr2demo.streamlit.app/

Features

  • 🔌 213+ API Endpoints - Access comprehensive Turkish electricity market data
  • 📊 Pandas Integration - Returns data as DataFrames for easy analysis
  • 🤖 AI Agent Ready - Built-in MCP server for Claude and other AI assistants
  • 🔑 Easy Authentication - Simple credential management with .env files
  • ♻️ TGT Recycling - Automatic ticket management for efficient API calls
  • 📈 Composite Functions - Pre-built functions for common data analysis tasks

Quick Example

from eptr2 import EPTR2

# Initialize with credentials
eptr = EPTR2(use_dotenv=True, recycle_tgt=True)

# Get Market Clearing Price (MCP/PTF)
df = eptr.call("mcp", start_date="2024-07-29", end_date="2024-07-29")
print(df)

What Data is Available?

eptr2 provides access to various Turkish electricity market data:

Category Description Example Calls
Prices Market clearing, system marginal, imbalance prices mcp, smp, imbalance-price
Consumption Real-time consumption, load forecasts rt-consumption, load-plan
Generation Real-time generation by source type rt-generation, uevm
Market Operations Day-ahead, intraday market data dpp, kgup

Installation

pip install "eptr2[allextras]"

uv pip install "eptr2[allextras]"

Next Steps

  • Getting Started

    Set up authentication and make your first API call

    Quick Start

  • API Reference

    Explore the full API documentation

    API Reference

  • AI Integration

    Use eptr2 with Claude and other AI assistants

    MCP Server

  • Composite Functions

    Pre-built functions for common analysis tasks

    Composite Functions

License

eptr2 is licensed under the Apache License 2.0.