ANTOOZA-BACKEND/Application/Features/Api/Stocks/GetMarketMovers/Response.cs

namespace Application.Features.Api.Stocks.GetMarketMovers;

public sealed class Response
{
    /// <summary>기준 거래일 (yyyy-MM-dd) — 데이터 없으면 빈 문자열</summary>
    public required string TradeDate { get; init; }

    /// <summary>상승 (등락률 &gt; 0, 상한 제외) 상위</summary>
    public required Group Advances { get; init; }

    /// <summary>하락 (등락률 &lt; 0, 하한 제외) 상위</summary>
    public required Group Declines { get; init; }

    /// <summary>상한 (등락률 ≥ +29.5% 근사) 상위</summary>
    public required Group LimitUp { get; init; }

    /// <summary>하한 (등락률 ≤ -29.5% 근사) 상위</summary>
    public required Group LimitDown { get; init; }

    public sealed class Group
    {
        /// <summary>그룹 전체 종목 수 — 상승/하락은 상한·하한을 포함한 전체 방향 카운트, 상한/하한은 해당 카운트</summary>
        public required int Total { get; init; }

        public required IReadOnlyList<Item> Items { get; init; }
    }

    public sealed class Item
    {
        public required string Code { get; init; }
        public required string Name { get; init; }

        /// <summary>시장 (1 KOSPI / 2 KOSDAQ / 3 KONEX)</summary>
        public required int Market { get; init; }

        public required int Close { get; init; }

        /// <summary>전일 대비 (원)</summary>
        public required int ChangeVal { get; init; }

        /// <summary>등락률 basis point (%×100)</summary>
        public required int FlucRateBp { get; init; }

        /// <summary>최근 종가 스파크라인 (과거→최신). 데이터 없으면 빈 배열.</summary>
        public required IReadOnlyList<int> Spark { get; init; }
    }
}