---

name: eptr2-market-operations description: Query Turkish electricity market operations data including Day-Ahead Market (GÖP) orders and clearing, Intraday Market (GİP) transactions and order books, bilateral contracts (İA), and Balancing Power Market (DGP) instructions. Use when asking about market volumes, trading activity, order books, block bids, flexible offers, or bilateral agreements in Turkey. Triggers on: GÖP, GİP, DGP, gün öncesi piyasası, gün içi piyasası, ikili anlaşmalar, market orders, block bids, YAL, YAT. allowed-tools: Read, Bash(python:*)

Turkish Electricity Market Operations with eptr2

Overview

This skill helps you query electricity market trading data from Turkey's EPIAS Transparency Platform, covering the Day-Ahead Market (GÖP), Intraday Market (GİP), Bilateral Contracts (İA), and Balancing Power Market (DGP).

Quick Start

from eptr2 import EPTR2

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

# Get DAM clearing quantity
dam_clearing = eptr.call("dam-clearing", start_date="2024-07-29", end_date="2024-07-29")
print(dam_clearing)

Market Structure Overview

Market	Turkish	Abbreviation	Timing
Day-Ahead Market	Gün Öncesi Piyasası	GÖP	D-1 (day before delivery)
Intraday Market	Gün İçi Piyasası	GİP	Until 1h before delivery
Balancing Power Market	Dengeleme Güç Piyasası	DGP	Real-time balancing
Bilateral Contracts	İkili Anlaşmalar	İA	OTC agreements

---

Day-Ahead Market (GÖP) Endpoints

Quantities & Clearing

Call	Description (EN)	Description (TR)
dam-clearing	DAM Matching Quantity	GÖP Eşleşme Miktarı
dam-volume	DAM Trade Value	GÖP İşlem Hacmi
dam-bid	DAM Submitted Bid Volume	GÖP Teklif Edilen Alış Miktarları
dam-offer	DAM Submitted Sales Volume	GÖP Teklif Edilen Satış Miktarları

Block & Flexible Orders

Call	Description (EN)	Description (TR)
dam-block-bid	DAM Block Bid	GÖP Blok Alış Miktarı
dam-block-offer	DAM Block Offer	GÖP Blok Satış Miktarı
dam-flexible-bid	DAM Flexible Buying Offer	GÖP Esnek Alış Teklif
dam-flexible-offer	DAM Flexible Selling Offer	GÖP Esnek Satış Teklif
dam-flexible-matching	DAM Matched Flexible Offers	GÖP Esnek Teklif Eşleşme

Price Independent Orders

Call	Description (EN)	Description (TR)
pi-bid	Price Independent Bid Order	Fiyattan Bağımsız Alış Teklifi
pi-offer	Price Independent Sales Order	Fiyattan Bağımsız Satış Teklifi

Supply-Demand

Call	Description
supply-demand	DAM Supply-Demand curves at each price step

---

Intraday Market (GİP) Endpoints

Quantities & Prices

Call	Description (EN)	Description (TR)
idm-qty	IDM Matching Quantity	GİP Eşleşme Miktarı
idm-volume	IDM Trade Value	GİP İşlem Hacmi
wap	IDM Weighted Average Price	GİP Ağırlıklı Ortalama Fiyat

Min-Max Prices

Call	Description
idm-mm-bid	IDM Min-Max Bid Price
idm-mm-offer	IDM Min-Max Offer Price
idm-mm-matching	IDM Min-Max Matching Price

Transaction & Order Data

Call	Description
idm-log	IDM Transaction History (işlem akışı)
idm-order-list	IDM Order List
idm-contract-list	IDM Contract List
idm-summary	IDM Contract Summary
idm-ob-qty	IDM Bid/Offer Quantities

---

Balancing Power Market (DGP) Endpoints

Call	Description (EN)	Description (TR)
bpm-up	Up Regulation Instructions	Yük Alma (YAL) Talimat
bpm-down	Down Regulation Instructions	Yük Atma (YAT) Talimat
bpm-orders-w-avg	BPM Instructions (Weighted Avg)	DGP Talimatları (AOF)
smp-dir	System Direction	Sistem Yönü

---

Bilateral Contracts (İA) Endpoints

Call	Description (EN)	Description (TR)
bi-long	Bilateral Contracts Bid Quantity	İA Alış Miktarı
bi-short	Bilateral Contracts Offer Quantity	İA Satış Miktarı
bi-euas	EÜAŞ - Authorized Retailers Bilaterals	EÜAŞ - GTŞ İkili Anlaşmalar

---

Common Use Cases

1. DAM Trading Activity

# Get DAM clearing and volume for a day
clearing = eptr.call("dam-clearing", start_date="2024-07-15", end_date="2024-07-15")
volume = eptr.call("dam-volume", start_date="2024-07-15", end_date="2024-07-15")

print(f"Total Cleared: {clearing['matchedQuantity'].sum():,.0f} MWh")
print(f"Total Volume: {volume['volume'].sum():,.0f} TL")

2. IDM Transaction History

# Get intraday market transaction log
idm_log = eptr.call("idm-log", start_date="2024-07-15", end_date="2024-07-15")

# Analyze by contract
print(f"Total Transactions: {len(idm_log)}")
print(f"Total IDM Volume: {idm_log['quantity'].sum():,.0f} MWh")

3. Balancing Instructions

# Get up and down regulation instructions
yal = eptr.call("bpm-up", start_date="2024-07-15", end_date="2024-07-15")
yat = eptr.call("bpm-down", start_date="2024-07-15", end_date="2024-07-15")

print(f"Total Up Regulation (YAL): {yal['upRegulationNet'].sum():,.0f} MWh")
print(f"Total Down Regulation (YAT): {yat['downRegulationNet'].sum():,.0f} MWh")

4. Bilateral Contracts Volume

bi_long = eptr.call("bi-long", start_date="2024-07-15", end_date="2024-07-15")
bi_short = eptr.call("bi-short", start_date="2024-07-15", end_date="2024-07-15")

print(f"Bilateral Purchases: {bi_long['quantity'].sum():,.0f} MWh")
print(f"Bilateral Sales: {bi_short['quantity'].sum():,.0f} MWh")

---

Market Volume Breakdown

Get comprehensive market volumes:

# All market volumes in one call
market_volumes = eptr.call(
    "electricity-market-quantity",
    start_date="2024-07-15",
    end_date="2024-07-15"
)
print(market_volumes)

---

Date Format

Always use ISO format: YYYY-MM-DD (e.g., "2024-07-29")

Authentication

Set credentials in .env file:

EPTR_USERNAME=your_email@example.com
EPTR_PASSWORD=your_password

For More Details

• See examples.md for additional code examples