Since this page is automatically translated by the machine, it may be less accurate than human being's work.
Korea Power Exchange_System Marginal Price Inquiry
The system marginal price refers to the electricity market price (KRW/kWh) for the amount of electricity applied by trading hour. You can search for hourly system marginal price information for the mainland and Jeju regions. Note 1: The 0:00 trading hour of the API indicates the period starting immediately after 0:00 and ending at 01:00. Note 2: This API will be deleted in the future, and we recommend using the Korea Power Exchange_System Marginal Price and Demand Forecast (for day-ahead power generation planning) API. Updated to OPENAPI User Guide v1.5 on November 29, 2024.
※ Application for use is only available on the PC version.
About OpenAPI
Download metadata
Provides schema.org based metadata.
About OpenAPI
Download metadata
Provides schema.org based metadata.
| Classified | Industry·Trade·Small and Medium Business - Energy and resource development | Provided By | |
|---|---|---|---|
| Department | Department No | ||
| API Type | REST | Data Format | XML |
| Usage | 657 | Keyword | System marginal price, SMP, electricity market, power quantity, inquiry |
| Registered | 2021-01-18 | Edited | 2025-11-25 |
| Deliberation Type | dev : disallow / run : disallow | ||
| Payment | free | ||
| Scope of License | |||
| References | 전력거래소 OpenAPI 활용자가이드(ver1.6).hwp | ||
Function
- Application for Use Development level : Not allowed / Operation level : Not allowed
- Available traffic 100000 / Operational account can increase traffic by applying for use case registration
- Requested Link
- Service URL https://openapi.kpx.or.kr/openapi/smp1hToday/getSmp1hToday
Request Parameter
Request Parameter
| Category(Korean) | Category(English) | Size | Division | Sample Data | Description |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | Essential | - | Authentication key received from public data portal |
| 지역코드 | areaCd | 1 | Essential | 1 | Land:1, Jeju:9 |
Response Element
Response Element
| Category(Korean) | Category(English) | Size | Division | Sample Data | Description |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | Essential | 00 | result code |
| 결과메시지 | resultMsg | 50 | Essential | OK | result message |
| 페이지 번호 | pageNo | 4 | Essential | 1 | page number |
| 한 페이지 결과 수 | numOfRows | 4 | Essential | 1000 | number of results per page |
| 전체 결과 수 | totalCount | 4 | Essential | 3 | total number of results |
| 페이지사이즈 | PageSize | 1 | Essential | 1 | page size |
| 시작페이지 | StartPage | 1 | Essential | 1 | start page |
| 거래일자 | tradeDay | 8 | Essential | 20210118 | year month date |
| 거래시간대 | tradHour | 11 | Essential | 0 | hour |
| 지역코드 | areaCd | 1 | Essential | 1 | Land:1, Jeju:9 |
| 계통한계가격 | smp | 20 | Essential | 93.47 | Unit: Won |
Sample Code
Please check the sample code on your PC.
