Claude-skill-registry eptr2-market-operations

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.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/eptr2-market-operations" ~/.claude/skills/majiayu000-claude-skill-registry-eptr2-market-operations && rm -rf "$T"

manifest: skills/data/eptr2-market-operations/SKILL.md

source content

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