KrxDerivativeSyncService.cs 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
  1. using Application.Abstractions.Data;
  2. using Application.Helpers;
  3. using Domain.Entities.Stocks;
  4. using Domain.Entities.Stocks.ValueObject;
  5. using Microsoft.EntityFrameworkCore;
  6. using Microsoft.Extensions.DependencyInjection;
  7. using Microsoft.Extensions.Logging;
  8. using Microsoft.Extensions.Options;
  9. using SharedKernel;
  10. namespace Infrastructure.StockData;
  11. /// <summary>
  12. /// 파생상품(선물 3 + 옵션 3) 일별매매 수집 (KRX OpenAPI drv) — fut/eqsfu/eqkfu_bydd_trd + opt/eqsop/eqkop_bydd_trd.
  13. /// 기본 19:00 KST 실행(장 마감 15:30 이후 확정, 채권 수집 18:40 이 3ep×백필로 5분 슬롯을 넘을 수 있어 여유). 공용 KrxBackfill 로 최근 BackfillYears(기본 3)년치를
  14. /// endDate(직전 영업일)부터 과거로 훑으며 미적재일만 채운다. quota 보호를 위해 1회 실행당 BackfillMaxPerRun(기본 60)일까지만 fetch.
  15. /// 각 날짜는 선물 3개 + 옵션 3개 엔드포인트를 모두 수집해 FuturesDailyTrade / OptionsDailyTrade 두 테이블에 각각 upsert
  16. /// (선물 UQ = FuturesKind+IsuCode+TradeDate+Session, 옵션 UQ = OptionsKind+IsuCode+TradeDate+Session).
  17. /// 일반선물/일반옵션은 동일 ISU_CD 로 정규·야간 세션 행이 각각 오므로 Session 을 upsert 키에 포함해 둘 다 저장한다.
  18. /// existsForDate 는 6개 상품군(FuturesKind 3 + OptionsKind 3)이 유형별 데이터 시작일 기준으로 전부 적재됐을 때만 skip
  19. /// (일부 상품군만 성공한 부분 적재 날짜는 재수집 — 영구 결손 방지). ApiKey 미설정 시 로그만 남기고 skip.
  20. /// </summary>
  21. internal sealed class KrxDerivativeSyncService(
  22. IServiceScopeFactory scopeFactory,
  23. IHttpClientFactory httpClientFactory,
  24. IOptions<AppSettings> settings,
  25. ILogger<KrxDerivativeSyncService> logger
  26. ) : DailyScheduledService(logger)
  27. {
  28. // (상품군, 엔드포인트 경로) — 선물: 일반/주식유가/주식코스닥
  29. private static readonly (FuturesKind Kind, string Path)[] FuturesEndpoints =
  30. [
  31. (FuturesKind.General, "/svc/apis/drv/fut_bydd_trd"),
  32. (FuturesKind.StockKospi, "/svc/apis/drv/eqsfu_stk_bydd_trd"),
  33. (FuturesKind.StockKosdaq, "/svc/apis/drv/eqkfu_ksq_bydd_trd")
  34. ];
  35. // (상품군, 엔드포인트 경로) — 옵션: 일반/주식유가/주식코스닥
  36. private static readonly (OptionsKind Kind, string Path)[] OptionsEndpoints =
  37. [
  38. (OptionsKind.General, "/svc/apis/drv/opt_bydd_trd"),
  39. (OptionsKind.StockKospi, "/svc/apis/drv/eqsop_bydd_trd"),
  40. (OptionsKind.StockKosdaq, "/svc/apis/drv/eqkop_bydd_trd")
  41. ];
  42. // 상품군별 데이터 시작일 (docs/KRX/readme.md) — 시작일 이전 날짜는 해당 상품군 미존재가 정상이라 완전성 판정에서 제외
  43. private static readonly (FuturesKind Kind, DateOnly DataStartDate)[] FuturesKindStartDates =
  44. [
  45. (FuturesKind.General, new DateOnly(2010, 1, 4)),
  46. (FuturesKind.StockKospi, new DateOnly(2010, 1, 4)),
  47. (FuturesKind.StockKosdaq, new DateOnly(2015, 8, 3))
  48. ];
  49. private static readonly (OptionsKind Kind, DateOnly DataStartDate)[] OptionsKindStartDates =
  50. [
  51. (OptionsKind.General, new DateOnly(2010, 1, 4)),
  52. (OptionsKind.StockKospi, new DateOnly(2010, 1, 4)),
  53. (OptionsKind.StockKosdaq, new DateOnly(2017, 6, 26))
  54. ];
  55. protected override string JobName => "KrxDerivativeSync";
  56. protected override TimeOnly TargetTime => ParseTime(settings.Value.KRXCoKr.DerivativeSyncTime, new TimeOnly(19, 0));
  57. protected override int MaxRetryCount => 2;
  58. protected override TimeSpan RetryDelay => TimeSpan.FromHours(2);
  59. protected override async Task<bool> RunOnceAsync(DateOnly todayKst, CancellationToken ct)
  60. {
  61. var cfg = settings.Value.KRXCoKr;
  62. if (string.IsNullOrWhiteSpace(cfg.ApiKey))
  63. {
  64. Logger.LogWarning("[{Job}] KRXCoKr:ApiKey 미설정 — 수집 skip", JobName);
  65. return true;
  66. }
  67. using var scope = scopeFactory.CreateScope();
  68. var db = scope.ServiceProvider.GetRequiredService<IAppDbContext>();
  69. var client = httpClientFactory.CreateClient(KrxCoKrHttp.ClientName);
  70. var endDate = await MarketCalendar.GetPreviousBusinessDayAsync(db, todayKst.AddDays(1), ct);
  71. var years = cfg.BackfillYears > 0 ? cfg.BackfillYears : 3;
  72. var startDate = todayKst.AddYears(-years);
  73. // 백필 창 전체의 휴장일을 한 번에 로드 (KrxBackfill 은 주말은 자동 제외, 휴장일만 필요)
  74. var holidays = (await db.MarketHoliday.AsNoTracking()
  75. .Where(c => c.Date >= startDate && c.Date <= endDate)
  76. .Select(c => c.Date)
  77. .ToListAsync(ct)).ToHashSet();
  78. var maxPerRun = cfg.BackfillMaxPerRun > 0 ? cfg.BackfillMaxPerRun : 60;
  79. // 상품군(6종)별 완전성 판정 — 일부 엔드포인트만 성공한 부분 적재 날짜는 skip 하지 않고 재수집한다
  80. async Task<bool> ExistsForDateAsync(DateOnly day, CancellationToken token)
  81. {
  82. var futuresKinds = await db.FuturesDailyTrade.AsNoTracking().Where(c => c.TradeDate == day).Select(c => c.FuturesKind).Distinct().ToListAsync(token);
  83. if (!BackfillCompleteness.IsComplete(futuresKinds, FuturesKindStartDates, day))
  84. {
  85. return false;
  86. }
  87. var optionsKinds = await db.OptionsDailyTrade.AsNoTracking().Where(c => c.TradeDate == day).Select(c => c.OptionsKind).Distinct().ToListAsync(token);
  88. return BackfillCompleteness.IsComplete(optionsKinds, OptionsKindStartDates, day);
  89. }
  90. var fetched = await KrxBackfill.RunAsync(
  91. existsForDate: ExistsForDateAsync,
  92. fetchAndUpsertForDate: (day, token) => FetchAndUpsertAsync(db, client, cfg.BaseUrl, cfg.ApiKey, day, token),
  93. startDate: startDate,
  94. endDate: endDate,
  95. holidays: holidays,
  96. maxPerRun: maxPerRun,
  97. delayMs: 300,
  98. ct: ct);
  99. Logger.LogInformation("[{Job}] 완료 — 창=[{Start}~{End}], 이번 실행 fetch={Fetched}일 (maxPerRun={Max})",
  100. JobName, startDate, endDate, fetched, maxPerRun);
  101. // 최신 영업일(endDate) 데이터가 이번 실행에서도 미적재면 false → 베이스가 RetryDelay 후 재시도 (KRX T+0 마감 데이터 미반영 대비)
  102. if (!await ExistsForDateAsync(endDate, ct))
  103. {
  104. Logger.LogWarning("[{Job}] 최신 영업일 {End} 데이터 미적재 — {Delay} 후 재시도 (최대 {Max}회)", JobName, endDate, RetryDelay, MaxRetryCount);
  105. return false;
  106. }
  107. return true;
  108. }
  109. /// <summary>한 날짜에 대해 선물 3개 + 옵션 3개 엔드포인트를 모두 수집하고 두 테이블에 각각 upsert.</summary>
  110. private async Task FetchAndUpsertAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  111. {
  112. await FetchAndUpsertFuturesAsync(db, client, baseUrl, apiKey, day, ct);
  113. await FetchAndUpsertOptionsAsync(db, client, baseUrl, apiKey, day, ct);
  114. }
  115. private async Task FetchAndUpsertFuturesAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  116. {
  117. var rows = new List<KrxFuturesParser.FuturesRow>();
  118. foreach (var (kind, path) in FuturesEndpoints)
  119. {
  120. var url = $"{baseUrl.TrimEnd('/')}{path}?basDd={day:yyyyMMdd}";
  121. var json = await KrxCoKrHttp.GetStringWithRetryAsync(client, url, apiKey, Logger, ct);
  122. var parsed = KrxFuturesParser.ParseDaily(json, kind);
  123. Logger.LogInformation("[{Job}] 선물 {Kind} basDd={Day} rows={Rows}", JobName, kind, day, parsed.Count);
  124. rows.AddRange(parsed);
  125. }
  126. if (rows.Count == 0)
  127. {
  128. Logger.LogInformation("[{Job}] basDd={Day} 선물 미반영 (0건)", JobName, day);
  129. return;
  130. }
  131. var existing = await db.FuturesDailyTrade.Where(c => c.TradeDate == day).ToListAsync(ct);
  132. var existingByKey = existing.ToDictionary(c => (c.FuturesKind, c.IsuCode, c.Session));
  133. var inserted = 0;
  134. var updated = 0;
  135. foreach (var row in rows)
  136. {
  137. if (existingByKey.TryGetValue((row.FuturesKind, row.IsuCode, row.Session), out var trade))
  138. {
  139. trade.Update(row.IsuName, row.Close, row.Open, row.High, row.Low, row.ChangeAmount, row.SpotPrice, row.SettlePrice, row.Volume, row.TradeValue, row.OpenInterest, row.ProductName, row.MarketName);
  140. updated++;
  141. }
  142. else
  143. {
  144. var created = FuturesDailyTrade.Create(row.FuturesKind, row.IsuCode, row.IsuName, row.TradeDate, row.Session, row.Close, row.Open, row.High, row.Low, row.ChangeAmount, row.SpotPrice, row.SettlePrice, row.Volume, row.TradeValue, row.OpenInterest, row.ProductName, row.MarketName);
  145. await db.FuturesDailyTrade.AddAsync(created, ct);
  146. existingByKey[(row.FuturesKind, row.IsuCode, row.Session)] = created;
  147. inserted++;
  148. }
  149. }
  150. await db.SaveChangesAsync(ct);
  151. Logger.LogInformation("[{Job}] basDd={Day} 선물 적재 — rows={Rows}, inserted={Inserted}, updated={Updated}",
  152. JobName, day, rows.Count, inserted, updated);
  153. }
  154. private async Task FetchAndUpsertOptionsAsync(IAppDbContext db, HttpClient client, string baseUrl, string apiKey, DateOnly day, CancellationToken ct)
  155. {
  156. var rows = new List<KrxOptionsParser.OptionsRow>();
  157. foreach (var (kind, path) in OptionsEndpoints)
  158. {
  159. var url = $"{baseUrl.TrimEnd('/')}{path}?basDd={day:yyyyMMdd}";
  160. var json = await KrxCoKrHttp.GetStringWithRetryAsync(client, url, apiKey, Logger, ct);
  161. var parsed = KrxOptionsParser.ParseDaily(json, kind);
  162. Logger.LogInformation("[{Job}] 옵션 {Kind} basDd={Day} rows={Rows}", JobName, kind, day, parsed.Count);
  163. rows.AddRange(parsed);
  164. }
  165. if (rows.Count == 0)
  166. {
  167. Logger.LogInformation("[{Job}] basDd={Day} 옵션 미반영 (0건)", JobName, day);
  168. return;
  169. }
  170. var existing = await db.OptionsDailyTrade.Where(c => c.TradeDate == day).ToListAsync(ct);
  171. var existingByKey = existing.ToDictionary(c => (c.OptionsKind, c.IsuCode, c.Session));
  172. var inserted = 0;
  173. var updated = 0;
  174. foreach (var row in rows)
  175. {
  176. if (existingByKey.TryGetValue((row.OptionsKind, row.IsuCode, row.Session), out var trade))
  177. {
  178. trade.Update(row.IsuName, row.RightType, row.StrikePrice, row.Close, row.Open, row.High, row.Low, row.ChangeAmount, row.ImpliedVolatility, row.NextDayBasePrice, row.Volume, row.TradeValue, row.OpenInterest, row.ProductName);
  179. updated++;
  180. }
  181. else
  182. {
  183. var created = OptionsDailyTrade.Create(row.OptionsKind, row.IsuCode, row.IsuName, row.TradeDate, row.Session, row.RightType, row.StrikePrice, row.Close, row.Open, row.High, row.Low, row.ChangeAmount, row.ImpliedVolatility, row.NextDayBasePrice, row.Volume, row.TradeValue, row.OpenInterest, row.ProductName);
  184. await db.OptionsDailyTrade.AddAsync(created, ct);
  185. existingByKey[(row.OptionsKind, row.IsuCode, row.Session)] = created;
  186. inserted++;
  187. }
  188. }
  189. await db.SaveChangesAsync(ct);
  190. Logger.LogInformation("[{Job}] basDd={Day} 옵션 적재 — rows={Rows}, inserted={Inserted}, updated={Updated}",
  191. JobName, day, rows.Count, inserted, updated);
  192. }
  193. }