공모주 달력 API v1

from/to 는 종목의 일정(수요예측·청약·환불·상장) 중 하나라도 그 기간에 걸리면 포함합니다.

페이지네이션은 없습니다. offset·page 같은 파라미터가 없고 limit 상한이 100입니다. 응답의 total 이 limit 적용 전 건수라 잘렸는지는 알 수 있으니, total 이 100을 넘으면 from/to/status 로 범위를 좁혀 주세요.

정렬은 sub_start → demand_start → listing_date 중 처음 있는 값의 오름차순입니다(셋 다 없으면 맨 뒤). limit 은 이 순서의 앞에서부터 자릅니다.

최상위

items[]

날짜는 YYYY-MM-DD 문자열입니다. 미정·미수집 값은 필드를 빼지 않고 null 로 옵니다.

호환성

필드는 추가될 수 있습니다. 모르는 필드는 무시하도록 만들어 주세요. 기존 필드를 삭제하거나 이름·타입을 바꾸지 않습니다. 그런 변경이 필요하면 /v2 를 새로 냅니다.

이번 달 일정 (스팩 제외)

curl -s -H "X-API-Key: $NKS_API_KEY" \
  "https://squvwhyjaiyqtxnqmdlz.supabase.co/functions/v1/api_v1/upcoming-ipos?from=2026-09-01&to=2026-09-30&spac=false&limit=100"

응답 예

{
  "version": "v1",
  "updated_at": "2026-08-24T00:05:12.481Z",
  "count": 1,
  "total": 3,
  "items": [
    {
      "id": "0f8c...",
      "corp_name": "케이스타반도체",
      "stock_code": null,
      "market": "KOSDAQ",
      "is_spac": false,
      "status": "청약",
      "demand_start": "2026-08-10",
      "demand_end": "2026-08-11",
      "sub_start": "2026-08-17",
      "sub_end": "2026-08-18",
      "refund_date": "2026-08-20",
      "listing_date": "2026-08-27",
      "price_low": 14000,
      "price_high": 16000,
      "price_final": 16000,
      "lead_managers": ["한국투자증권", "NH투자증권"],
      "industry": "전자부품·컴퓨터·영상·음향 및 통신장비 제조업",
      "ceo": "김상우",
      "est_date": "2015-03-12",
      "homepage": "https://kstar-semi.co.kr",
      "dart_url": "https://dart.fss.or.kr/dsaf001/main.do?rcpNo=2026...",
      "detail_url": null,
      "subscription_brokers": ["한국투자증권", "NH투자증권", "유안타증권"]
    }
  ]
}

응답에 ETag 와 Cache-Control 이 붙습니다. 받은 ETag 를 그대로 If-None-Match 에 넣어 재요청하면 데이터가 그대로일 때 304 가 옵니다. 앞에 W/ 가 붙어 있어도 떼지 말고 받은 그대로 보내세요.

Cache-Control 은 private 입니다 — 응답이 키마다 다르므로 (X-RateLimit-*) 공유 캐시(CDN·프록시)에는 저장하지 마세요. 클라이언트 로컬 캐시는 그대로 쓰시면 됩니다.

304 는 본문 전송이 없어 빠르지만 호출 수에는 포함됩니다. 하루 몇 회 수준이면 굳이 쓰지 않아도 됩니다 — 아껴지는 것은 대역폭뿐입니다.

날짜 경계는 서버가 처리합니다. status 는 저장된 값이 아니라 응답 시점의 한국 날짜로 계산하는데, 그 날짜가 ETag 와 캐시 수명에 함께 반영됩니다. 자정을 넘기면 새 본문이 옵니다.

다만 최상위 updated_at 은 원본이 마지막으로 바뀐 시각이라 신선도 판정에는 부족합니다(수집이 하루 쉬면 어제 값 그대로입니다) — 받은 시각은 소비하는 쪽에서 따로 기록해 주세요.

모든 오류는 같은 형태입니다.

{ "error": { "code": "rate_limited", "message": "일 한도 초과. 상향은 문의: ..." } }

잔여 호출량 헤더

한도가 걸린 키로 호출하면 응답에 아래 헤더가 함께 옵니다. 브라우저에서도 읽을 수 있게 노출돼 있으니, 한도에 부딪히기 전에 미리 조절하는 데 쓰세요.

키에 따라 한도가 없을 수 있습니다. 그런 키에는 위 두 헤더가 붙지 않고 429 도 발생하지 않습니다 — 헤더가 없다고 오류로 처리하지 마세요.