---
title: "KRX 시장 핫 — 거래대금/등락 상위"
method: GET
path: "/api/v1/public/krx/market-leaders"
tags: ["Public — KRX"]
---

# KRX 시장 핫 — 거래대금/등락 상위

`GET /api/v1/public/krx/market-leaders`

## Request

- Base URL: `https://api.decker-ai.com`
- URL: `https://api.decker-ai.com/api/v1/public/krx/market-leaders`
- Auth: none declared

krx_master 전체에서 거래대금·등락 정렬. 시그널 발화 X 종목 포함. 각 종목별 user_state + portfolio_action 매핑 (judgment_signals 있으면). type: value(거래대금) | gainers(상승) | losers(하락). period: 1d(전일) | 1w(전주, 5 거래일). X-API-Key 필수.

## Query parameters

- `type` string: value | gainers | losers
- `period` string: 1d | 1w
- `market` string: KOSPI | KOSDAQ | ALL
- `limit` integer

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/decker-ai/apis/decker-public-api.md) · [All operations](https://skmtc.dev/decker-ai/apis/decker-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decker-ai/apis/decker-public-api/revisions/fc19ddf728bf?raw)