모든 API

상장 종목을 위한 주가 API

상장 주식의 가격과 기업 이벤트를 받을 수 있으며 시가총액과 밸류에이션 비율이 포함됩니다. 모든 요청에 Bearer 키를 사용하세요. REST와 MCP는 하나의 계정 잔액을 함께 씁니다.

정상 운영 중100.00% uptime, last 30일566 ms 일반 응답 시간

첫 요청

최신 가격 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/price" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "id": "XNAS:MSFT",
  "symbol": "MSFT",
  "currency": "USD",
  "price": "421.35",
  "previous_close": "418.90",
  "change": "2.45",
  "change_percent": "0.58",
  "volume": "18234100",
  "market_session": "open",
  "timestamp": "2026-10-26T15:42:00Z",
  "stale": false
}

엔드포인트

GET티커 또는 이름으로 주식 검색/v1/equities/search

티커 또는 이름이 q로 시작하는 상장 종목이며, 대소문자는 구분하지 않습니다. 정확히 일치하는 티커, 그 외 티커, 이름 순으로 정렬됩니다.

매개변수

  • q필수

    티커 또는 회사 이름의 앞부분이며, 대소문자는 구분하지 않고 2자 이상이어야 합니다(예: ms 또는 micro). 정렬 순서는 정확히 일치하는 티커, 그 외 티커, 이름의 앞부분, 이름 중 뒤쪽 단어의 앞부분이며, 각 구간 안에서는 미국 주 상장 종목이 먼저 나옵니다.

  • country선택

    해당 국가의 종목만 반환합니다. 3글자 코드(USA, KOR).

  • type선택

    해당 종류의 종목만 반환합니다.

  • cursor선택

    이전 페이지의 next_cursor이며, 나머지 매개변수는 동일하게 사용합니다.

응답 필드

  • results객체 목록

    한 페이지에 최대 50건.

  • next_cursor문자열

    다음 페이지를 읽으려면 이 값을 다시 전달합니다. 마지막 페이지에서는 null입니다.


전체 레퍼런스 →
GET주식 한 종목의 프로필/v1/equities/{id}

상장 종목 정보(심볼, 이름, 유형, 거래소, 국가, 통화), 회사의 섹터, 업종, 웹사이트, 그리고 해당 상장 종목이 당사 공시의 회사와 일치할 경우 company_id입니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

응답 필드

  • id문자열

    정식 종목 ID.

  • symbol문자열

    해당 거래소의 티커.

  • mic문자열

    거래소의 4자리 코드.

  • country문자열

    종목의 국가, 3글자 코드.

  • sector문자열

    섹터. 프로필 텍스트가 없는 일본 종목에서는 제외됩니다.

  • industry문자열

    업종. 일본 종목에서는 제외됩니다.

  • website문자열

    기업의 웹사이트. 일본 종목에서는 제외됩니다.

  • logo_url문자열

    당사가 보관 중인 기업 로고 사본. 없으면 제외됩니다.

  • company_id문자열

    종목이 하나의 기업과 명확히 일치할 때 해당 기업의 공시 ID.


전체 레퍼런스 →
GET주식 한 종목의 최신 시세/v1/equities/{id}/price

한 상장 종목의 최신 가격입니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

주요 응답 필드

  • id문자열

    요청한 주식에 대해 반환되는 정규 종목 id입니다.

  • symbol문자열

    거래소에서 이 주식에 쓰이는 티커입니다.

  • currency문자열

    모든 가격 필드의 통화이며, 펜스는 파운드로 환산됩니다.

  • price문자열

    currency 단위의 십진 문자열로 반환되는 주식 마지막 가격입니다.

  • previous_close문자열

    직전 세션의 종가이며, 알 수 없으면 생략됩니다.

  • change문자열

    price에서 previous_close를 뺀 값이며, previous_close가 생략되면 함께 생략됩니다.

  • change_percent문자열

    previous_close 대비 변동률(%)입니다. 1.5는 1.5%를 뜻합니다.

  • volume문자열

    오늘 거래된 주식 수로, 알 수 없으면 생략됩니다.

  • market_session다음 중 하나: pre, open, post, closed

    timestamp 시점의 거래소 상태입니다: pre, open, post, closed 중 하나이며, pre와 post는 미국 거래소에만 있습니다.

  • timestamp날짜·시간

    가격이 유효했던 시각이며, UTC 기준 초 단위로 표시됩니다.


전체 레퍼런스 →
GET최대 50개 주식의 최신 시세/v1/equities/prices

등록된 각 id의 최신 가격입니다.

매개변수

  • ids필수

    쉼표로 구분한 종목 ID, 중복 제거 후 최대 50개. 각 ID는 단일 시세 경로와 같은 규칙을 따릅니다. 시세를 반환한 ID마다 1회 호출로 계산됩니다.

응답 필드

  • prices객체 목록

    확인된 ID별 시세 하나씩.

  • errors객체 목록

    시세를 반환하지 않은 ID. 과금되지 않습니다.


전체 레퍼런스 →
GET미국 주식 상위 등락 종목/v1/equities/movers

방향별 미국 주식 및 ETF 상위 25개: gainers, losers 또는 active(전체 시장이 아니라 당일 상승 및 하락폭이 가장 큰 종목 중 거래대금이 가장 큰 종목).

매개변수

  • market선택

    순위를 매길 시장입니다. 현재는 us만 지원하며, 다른 시장은 404 not_covered입니다.

  • direction선택

    gainers(상승폭 최대), losers(하락폭 최대) 또는 active(전체 시장이 아니라 당일 상승 및 하락폭이 가장 큰 종목 중 거래대금이 가장 큰 종목). 그 외의 값은 400 invalid_query입니다.

응답 필드

  • market항상 "us"

    순위를 매긴 시장.

  • direction다음 중 하나: gainers, losers, active

    요청한 순위.

  • movers객체 목록

    최대 25개, 상위 순. 가격이 $1 이상이고 오늘 거래량 100,000주 이상, 거래대금 $1 million 이상인 보통주와 ETF만 포함합니다.

  • timestamp날짜·시간

    목록에서 가장 최신인 가격이 유효했던 시각(UTC).


전체 레퍼런스 →
GET주식 한 종목의 가격 봉/v1/equities/{id}/bars

일간(1d) 또는 1분(1m) 막대이며, 오래된 순으로 정렬되고 주식 분할과 배당이 반영되어 조정됩니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

  • interval선택

    session) or 1m (one-minute bars).당 1d (one bar Anything else is 400 invalid_interval.

  • start선택

    첫 번째 막대입니다. 1d: 날짜(YYYY-MM-DD), 해당 날짜 포함이며, 생략하면 가장 오래된 막대부터입니다. 1m: UTC 시각(YYYY-MM-DDTHH:MM:SSZ, 또는 00:00 UTC를 뜻하는 날짜), 해당 시각 포함이며, 생략하면 end의 하루 전입니다.

  • end선택

    마지막 막대입니다. 1d: 날짜, 해당 날짜 포함이며, 생략하면 막대가 나온 가장 최근 세션입니다. 1m: UTC 시각, 해당 시각 미포함이며, 생략하면 현재 시각 또는 start로부터 5일 뒤입니다. 1m에서 start와 end의 간격은 최대 5일입니다(400 range_too_large).

  • cursor선택

    이전 페이지의 next_cursor이며, 나머지 매개변수는 동일하게 사용합니다. 커서 뒤의 가격이 변경되면(주식 분할 또는 배당) 커서가 더 이상 작동하지 않습니다: 409 cursor_expired.

응답 필드

  • id문자열

    정식 종목 ID.

  • currency문자열

    모든 가격의 통화. 펜스는 파운드가 됩니다.

  • adjusted불리언

    항상 true: 가격은 분할과 배당이 반영되어 조정됩니다. 한 페이지와 다음 페이지는 항상 일치하며, 두 페이지 사이에 분할이나 배당으로 이력이 바뀌면 둘을 섞지 않고 커서가 작동하지 않습니다(409 cursor_expired).

  • start문자열

    전송되지 않으며, start는 이동하지 않습니다.

  • end문자열

    전송되지 않음: 일봉은 잘리지 않습니다.

  • bars객체 목록

    한 페이지에 최대 5,000개의 봉.

  • next_cursor문자열

    다음 페이지를 읽으려면 이 값을 다시 전달합니다. 마지막 페이지에서는 null입니다.


전체 레퍼런스 →
GET주식 한 종목의 배당/v1/equities/{id}/dividends

한 상장 종목의 현금 배당이며, 배당락일이 최신인 순으로 정렬되고 페이지로 나뉩니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

  • cursor선택

응답 필드

  • id문자열

    정식 종목 ID.

  • start날짜

    전송되지 않음: 모든 계정에 전체 이력을 제공합니다.

  • dividends객체 목록

    배당락일 최신 순. 발표된 미래 항목이 포함될 수 있습니다.

  • next_cursor문자열

    다음 페이지를 위해 cursor로 전달합니다. 마지막 페이지에서는 null입니다.


전체 레퍼런스 →
GET주식 한 종목의 분할/v1/equities/{id}/splits

한 상장 종목의 주식 분할이며, 최신 순으로 정렬됩니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

응답 필드

  • id문자열

    정식 종목 ID.

  • start날짜

    전송되지 않음: 모든 계정에 전체 이력을 제공합니다.

  • splits객체 목록

    최신 순.


전체 레퍼런스 →
GET주식 한 종목의 실적/v1/equities/{id}/earnings

한 상장 종목의 과거 실적 발표(거래소 기준 오늘 또는 그 이전 날짜)로, 추정치, 실제치, 서프라이즈를 포함하며 최신 순으로 정렬되고 페이지로 나뉩니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

  • cursor선택

응답 필드

  • id문자열

    정식 종목 ID.

  • start날짜

    전송되지 않음: 모든 계정에 전체 이력을 제공합니다.

  • earnings객체 목록

    과거 보고만, 최신 순. 예정된 보고일은 아직 포함되지 않습니다.

  • next_cursor문자열

    다음 페이지를 위해 cursor로 전달합니다. 마지막 페이지에서는 null입니다.


전체 레퍼런스 →
GET주식 한 종목의 시가총액, P/E, P/S, P/B, 배당수익률/v1/equities/{id}/valuation

미국 또는 한국 상장 종목 하나의 시가총액(최신 가격 곱하기 발행주식수), P/E(최신 가격을 회사 공시의 최근 12개월 희석 EPS로 나눈 값, 보고된 GAAP 또는 IFRS 기준), P/S(시가총액을 최근 12개월 매출로 나눈 값), P/B(시가총액을 최신 대차대조표의 총자본으로 나눈 값), 배당수익률(최근 12개월 주당 배당금을 가격으로 나눈 값, 퍼센트)이며, 산출에 쓰인 입력값과 기준일을 함께 제공합니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

주요 응답 필드

  • id문자열

    정식 종목 ID.

  • currency문자열

    market_cap과 pe_ratio에 사용된 가격의 통화입니다.

  • market_cap문자열

    currency 기준의 최신 가격 곱하기 shares_outstanding이며, 전체 단위입니다. shares_as_of 이후에 주식 분할이 있었을 때, 회사에 여러 주식 종류가 있는데 각각의 수량이 없을 때, 예탁증서 또는 외국 공시 기업일 때는 생략됩니다. 한국은 아직 시가총액이 없으며, 한국 상장 종목은 현재 P/E만 표시됩니다.

  • pe_ratio문자열

    최신 가격을 eps_ttm으로 나눈 값이며, 소수점 둘째 자리까지입니다. eps_ttm이 음수이거나 0.01 미만일 때, 보고 통화가 currency와 다를 때, eps_period_end 이후에 주식 분할이 있었을 때, 예탁증서일 때는 생략됩니다.

  • ps_ratio문자열

    주가매출비율(Price to sales): market_cap을 revenue_ttm으로 나눈 값이며, 소수점 둘째 자리까지입니다. market_cap이 생략될 때마다 함께 생략되며, 매출이 0 이하일 때, 매출이 currency와 다른 통화로 보고될 때도 생략됩니다.

  • pb_ratio문자열

    주가순자산비율(Price to book): market_cap을 total_equity로 나눈 값이며, 소수점 둘째 자리까지입니다. market_cap이 생략될 때마다 함께 생략되며, 총자본이 0이거나 음수일 때, 총자본이 currency와 다른 통화로 보고될 때도 생략됩니다.

  • dividend_yield문자열

    최근 12개월 주당 배당금을 최신 가격으로 나눈 값이며, 퍼센트 단위입니다(0.71은 0.71%를 뜻함). 소수점 둘째 자리까지입니다. 해당 12개월 동안 기록된 배당이 없을 때(배당을 하지 않는 회사 포함), dividends_period_end 이후에 주식 분할이 있었을 때, 배당이 currency와 다른 통화일 때, 예탁증서일 때는 생략됩니다.

  • shares_outstanding문자열

    기업 주력 보통주의 발행 주식 수. 우선주 같은 다른 종류의 종목에는 여기에 주식 수가 없으므로 제외됩니다.

  • shares_as_of날짜

    shares_outstanding을 집계한 기준일입니다. 수량이 표시될 때는 항상 표시됩니다.

  • eps_ttm문자열

    회사 공시 기준 최근 12개월 희석 EPS입니다(보고된 GAAP 또는 IFRS 기준). 4분기는 연간 수치에서 1분기부터 3분기를 뺀 값입니다. 산출할 수 있으면 항상 표시되며, 같은 회사의 다른 주식 종류인 상장 종목에서는 생략됩니다. 시장 데이터 기준인 주식 실적의 eps_actual과 다를 수 있습니다.


전체 레퍼런스 →
GET주식 한 종목의 베타, 자기자본비용, 부채비용, WACC/v1/equities/{id}/cost-of-capital

미국 또는 한국 주식 하나의 벤치마크 ETF 대비 베타(기본적으로 2년간의 주간 수익률, 주식 분할과 배당을 반영해 조정한 가격 기준), 무위험 수익률(해당 국가 국채 수익률 곡선의 10년 지점 또는 사용자가 지정한 값), 자기자본비용(무위험 수익률 더하기 베타 곱하기 주식 위험 프리미엄: erp로 지정한 값, 또는 기본값으로 해당 국가에 대해 당사가 공표한 총 프리미엄), 부채비용(회사 공시의 이자비용을 평균 총부채로 나눈 값이며, 이를 사용할 수 없으면 무위험 수익률에 회사의 이자보상배율에 대한 공개 표의 기본 스프레드를 더한 값; 세전 및 세후이며, 세율은 tax_rate를 보내지 않는 한 공개 표의 해당 국가 법인세율), 그리고 시가총액과 총부채로 가중한 WACC를 제공합니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

  • erp선택

    사용자의 주식 위험 프리미엄, 퍼센트 단위(5는 5%를 의미). 생략하면 당사가 공표하는 해당 국가의 총 주식 위험 프리미엄입니다(응답에 날짜와 기준이 표시됨). 당사가 공표하지 않는 국가에서는 이 값이 없으면 400 erp_required입니다. 0보다 크고 25 이하.

  • benchmark선택

    베타를 측정할 기준이 되는 시장 대용 종목의 ID: 해당 주식과 같은 통화로 거래되는 ETF, 펀드 또는 주식. 생략하면 미국 주식은 ARCX:SPY, 한국 주식은 XKRX:069500, 일본 주식은 XTKS:1306이며, 그 외 시장은 이 값이 필요합니다.

  • window선택

    수익률을 계산하는 과거 기간입니다: 2y(기본값) 또는 5y.

  • frequency선택

    수익률 간격입니다: weekly(기본값, 각 ISO 주의 마지막 공통 거래일) 또는 monthly.

  • beta선택

    자기자본비용에 사용할 베타입니다: raw(기본값) 또는 adjusted(원시 베타 0.67에 0.33을 더한 값). 두 값 모두 항상 응답에 포함됩니다.

  • risk_free선택

    사용자가 지정하는 무위험 이자율, 퍼센트 단위. 생략하면 해당 국가 국채 수익률 곡선의 10년물 시점입니다. 곡선이 없는 곳(한국)에서 필요하며, 없으면 422 risk_free_unavailable입니다.

  • tax_rate선택

    부채의 절세 효과에 사용할 세율, 퍼센트 단위. 생략하면 Damodaran의 공개 표(PwC 세율)에 있는 해당 주식 국가의 법인세율입니다. 0에서 60 사이.

  • period선택

    이자비용의 기간입니다: 최근 12개월(ttm, 기본값) 또는 최신 전체 회계연도(annual). 한국과 일본은 연간 수치만 있으므로 annual이 적용됩니다.

응답 필드

  • id문자열

    정식 종목 ID.

  • currency문자열

    금액 필드의 통화.

  • company_id문자열

    종목이 일치하는 당사 공시의 기업.

  • cost_of_equity문자열

    무위험 이자율 더하기 베타 곱하기 주식 위험 프리미엄, 퍼센트 단위(4.25는 4.25%를 의미).

  • cost_of_debt객체

    공시에 부채가 없는 기업에서는 제외됩니다.

  • tax_rate객체

    해당 국가의 세율이 표에 없으면 생략됩니다. 세율을 지정하려면 tax_rate를 보내세요.

  • wacc문자열

    가중평균자본비용이며, 퍼센트 단위입니다(4.25는 4.25%를 뜻함). 부채가 없는 회사는 cost_of_equity와 같습니다. 부채가 있는데 세율을 알 수 없으면 생략됩니다.

  • warnings객체 목록

    수치를 사용하기 전에 확인할 사항. 없으면 비어 있습니다.

  • methodology_url문자열

    각 수치를 산출하는 방법.


전체 레퍼런스 →
GET주식 한 종목의 밸류에이션 이력/v1/equities/{id}/valuation/history

미국 또는 한국 상장 종목 하나의 모든 회계기간 말(분기 말 또는 연말) 시점의 시가총액, P/E, P/S, P/B, 배당수익률이며, 오래된 순으로 정렬됩니다.

매개변수

  • id필수

    종목 ID: 거래소의 4자리 코드, 콜론, 티커 순이며 예: XNAS:MSFT, XNYS:BRK.B. MSFT 같은 미국 티커 단독 표기도 미국 종목 하나를 가리키면 사용할 수 있으며, 응답에는 정식 ID가 포함됩니다. 주식 종류는 점으로 구분하며(BRK.B) BRK-B도 허용됩니다.

응답 필드

  • id문자열

    정식 종목 ID.

  • currency문자열

    모든 가격과 시가총액의 통화.

  • company_id문자열

    종목이 일치하는 당사 공시의 기업.

  • start날짜

    전송되지 않음: 모든 계정에 전체 이력을 제공합니다.

  • points객체 목록

    기업의 회계 기간 종료일마다 하나의 시점, 오래된 순. 각 시점은 당시 알려진 값이 아니라 해당 기간에 제출된 수치와 그날의 가격으로 산출되므로 이후의 정정 공시가 반영됩니다. 가격이 없거나 수치가 하나도 없는 기간에는 시점이 없습니다.


전체 레퍼런스 →

활용 사례

전체 이력 백필

이력 전체를 페이지 단위로 가져와 파일에 저장하고, 중단되면 이어서 받습니다.

가이드 읽기 →

매일 데이터 가져오기

작은 스크립트를 하루에 한 번 실행하고 결과를 CSV에 추가합니다.

가이드 읽기 →

캐싱과 429 오류

Cache responses by data type and tell a rate limit (429) from an empty credit balance (402).

가이드 읽기 →

관련 API

주식을 기업 공시와 연결하기

종목의 company_id로 가격과 밸류에이션을 기업 재무제표와 연결하세요.

API 탐색 →

ETF 시세와 뮤추얼펀드 NAV를 위한 펀드 기준가 API

ETF 가격과 일별 뮤추얼 펀드 순자산가치

API 탐색 →

실시간과 과거 시세를 제공하는 암호화폐 API

REST와 MCP로 제공하는 암호화폐 페어 가격과 이력

API 탐색 →

선불 크레딧과 요금

1,000회당 요금, 충전, 매월 무료 크레딧을 확인하세요. 가격은 모든 계정에서 실시간입니다.

요금 보기 →

자주 묻는 질문

주식 ID는 어떻게 쓰나요?

종목 id는 4글자 거래소 코드와 티커를 결합한 형태이며, 예를 들어 Microsoft는 XNAS:MSFT입니다. 고유한 미국 티커만 단독으로 써도 되며, 응답은 정규 id를 반환합니다.

비용은 얼마인가요?

호출은 1,000건당 $2이며 선불 크레딧에서 차감됩니다. 모든 계정은 가입 후 첫 12개월 동안 매월 $10의 무료 크레딧을 받으며, 상업적 이용도 허용됩니다.

가격은 실시간인가요, 지연되나요?

주식, ETF, 암호화폐 가격은 모든 계정에서 실시간입니다. 일괄 호출은 ID를 최대 50개까지 받으며 반환된 가격마다 호출 1회로 셉니다.

어떤 밸류에이션 데이터가 포함되나요?

미국 전용 등락 종목, 밸류에이션 이력, 베타를 포함한 자본비용은 모든 계정에서 쓸 수 있습니다. 밸류에이션은 미국·한국 상장 종목을 공시와 연결하며, 한국은 P/E만 제공합니다.

API는 무엇을 다루나요?

검색과 프로필은 모든 계정에서 쓸 수 있습니다. 일봉과 과거 실적은 전체 이력을 다루며, 배당과 액면분할도 같은 범위를 따릅니다. 1분봉도 포함됩니다. 당일 거래량은 알 수 없으면 생략됩니다. 시가총액과 P/E, P/S, P/B, 배당수익률도 포함됩니다. 가격과 금액은 십진수 문자열입니다.

Stocks API에 예정된 실적 발표나 일본 가격이 포함되나요?

실적 경로는 과거 결과만 반환하며, 예정된 실적 발표일은 제공되지 않습니다. 일본 가격은 제공되지 않으며, 프로필에는 name, exchange, country, currency, company_id만 있습니다. 실적의 eps_actual은 시장 데이터 기준을 사용하고, pe_ratio에 쓰이는 EPS는 기업 공시에서 가져옵니다. 두 값은 다를 수 있으므로 직접 비교하지 마세요.

밸류에이션 이력은 어떻게 작동하나요?

밸류에이션 이력은 분기 또는 연간 회계기간 말마다 한 점씩 제공합니다. 각 점은 그 날짜 또는 직전의 종가를 쓰며 액면분할만 반영하고, 수치는 해당 기간에 공시된 그대로입니다. 모든 계정이 전체 이력을 받습니다. 더 오래된 행이 없으면 start가 처음 제공한 날짜를 알려 줍니다.

자본비용을 계산하려면 무엇이 필요한가요?

자본비용은 Narwhal 공시에서 기업과 매칭된 미국 및 한국 상장 종목을 다루며, 모든 응답에는 자본비용 방법론 링크가 포함됩니다. 주식 위험 프리미엄은 erp로 보내세요. 은행과 보험사는 이자가 영업비용이므로 422 not_applicable을 반환합니다. 계산할 수 없는 입력값은 추정하지 않고 422 inputs_unavailable에 이름이 표시됩니다.

가격은 기업 공시와 어떻게 연결되나요?

상장 종목에는 company_id가 있을 수 있으며, 이를 통해 공시 API의 기업과 연결됩니다. 이 id로 가격과 밸류에이션을 재무제표와 연결하세요. 올바르게 계산할 수 없는 비율은 0으로 채우지 않고 생략됩니다.