전체 이력 백필
이력 전체를 페이지 단위로 가져와 파일에 저장하고, 중단되면 이어서 받습니다.
가이드 읽기 →모든 API
지수 데이터를 위한 주가지수 API
REST 또는 MCP로 18개 지수의 최신 수준, 전일 종가, 일봉 또는 1분봉 이력을 가져옵니다. 수준은 십진 문자열입니다.
첫 요청
S&P 500의 최신 수준 조회
curl --request GET \
--url "https://api.narwhalapi.com/v1/indices/SPX/price" \
--header "Authorization: Bearer $NARWHAL_API_KEY"응답 예시
{
"id": "SPX",
"name": "S&P 500",
"currency": "USD",
"price": "7696.46",
"previous_close": "7681.2",
"change": "15.26",
"change_percent": "0.2",
"market_session": "open",
"timestamp": "2026-10-29T18:38:00Z",
"stale": false
}엔드포인트
GET지수 목록/v1/indices
Narwhal이 가격을 제공하는 모든 지수를 이름, 지역, 통화와 함께 나열합니다.
응답 필드
indices객체 목록Narwhal이 가격을 제공하는 모든 지수이며, 각각 id, 이름, 지역, 통화를 포함합니다.
전체 레퍼런스 →
GET지수 가격 조회/v1/indices/{id}/price
한 지수의 최신 수준을 전일 종가와 변동폭과 함께 가져옵니다.
매개변수
id필수지수 id입니다. 예: SPX, NDX, DJI. 대소문자는 구분하지 않습니다.
주요 응답 필드
id문자열SPX와 같은 지수 코드입니다.
name문자열지수의 공식 명칭입니다.
currency문자열지수의 통화입니다. 변동성 지수는 생략됩니다.
price문자열십진 문자열로 표시한 지수의 마지막 수준입니다.
previous_close문자열직전 거래일의 종가입니다. 알 수 없으면 생략됩니다.
change문자열price에서 previous_close를 뺀 값입니다. previous_close와 함께 생략됩니다.
change_percent문자열변동률(%)입니다. 1.5는 1.5%를 뜻합니다. change와 함께 생략됩니다.
market_sessionopen, closed 중 하나지수가 공시된 거래 시간에 거래되는 동안은 open, 그 외에는 closed입니다.
timestamp날짜·시간가격이 유효했던 시각이며, UTC 기준 초 단위로 표시됩니다.
stale불리언지수가 열려 있고 수준이 15분 넘게 지났을 때 true입니다. 마감된 지수는 지연으로 표시되지 않습니다.
전체 레퍼런스 →
GET여러 지수 가격 조회/v1/indices/prices
한 번의 호출로 최대 50개 지수의 최신 수준을 가져옵니다.
매개변수
ids필수쉼표로 구분한 id이며 중복을 제거한 뒤 최대 50개입니다. 각 id는 단건 가격 경로와 같은 규칙을 따릅니다. 가격이 반환된 id마다 호출 1회로 계산됩니다.
응답 필드
prices객체 목록가격이 반환된 id마다 하나의 항목이 있으며, 단일 가격의 필드를 그대로 갖습니다.
errors객체 목록가격을 반환하지 않은 ID로, 각각 not_found 코드가 붙습니다. 비용은 들지 않습니다.
전체 레퍼런스 →
GET지수 바 조회/v1/indices/{id}/bars
한 지수의 일봉 또는 1분봉을 오래된 순으로 가져옵니다.
매개변수
id필수지수 id입니다. 예: SPX, NDX, DJI. 대소문자는 구분하지 않습니다.
interval선택1d(거래일당 막대 1개, 해당 거래일 날짜 기준) 또는 1m(1분 막대, 12개월간 보관). 그 외의 값은 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이며, 매개변수는 동일하게 사용합니다.
응답 필드
id문자열SPX와 같은 지수 코드입니다.
currency문자열지수의 통화입니다. 변동성 지수는 생략됩니다.
start문자열범위의 시작이 뒤로 옮겨졌을 때만 전송됩니다.
end문자열전송되지 않습니다. 가격이 모든 계정에서 실시간이기 때문입니다.
bars객체 목록오래된 순으로 정렬된 바입니다. 각 바에는 timestamp, open, high, low, close가 있으며 거래량은 없습니다.
next_cursor문자열다음 페이지를 읽으려면 이 값을 다시 전달합니다. 마지막 페이지에서는 null입니다.
전체 레퍼런스 →
활용 사례
데이터 범위
- S&P 500SPX · 미국 · USD
- Nasdaq-100NDX · 미국 · USD
- 다우존스 산업평균지수DJI · 미국 · USD
- 러셀 2000RUT · 미국 · USD
- 나스닥 종합지수COMP · 미국 · USD
- Cboe 변동성 지수VIX · 미국
- MSCI 월드MXWLD · 글로벌 · USD
- MSCI 신흥시장MXEF · 글로벌 · USD
- Cboe 영국 100BUK100P · UK · GBP
- Cboe 독일 40BDE40P · 유럽 · EUR
- Cboe 유럽 50BEP50P · 유럽 · EUR
- Cboe 유로존 50BEZ50P · 유럽 · EUR
지수 18개 모두 보기
- Cboe 프랑스 40BFR40P · 유럽 · EUR
- PHLX 반도체 섹터SOX · 미국 · USD
- KBW 나스닥 은행BKX · 미국 · USD
- Cboe 원유 ETF 변동성 지수OVX · 미국
- Cboe 금 ETF 변동성 지수GVZ · 미국
- PHLX 금/은 섹터XAU · 미국 · USD
관련 API
자주 묻는 질문
어떤 지수를 가져올 수 있나요?
18개 지수입니다. 미국 대표 지수 5개, 변동성 지수 3개, MSCI 글로벌 지수 2개, Cboe 유럽 지수 5개, 미국 섹터 지수 3개로 구성됩니다. id는 SPX, NDX, DJI처럼 표준 코드이며 대소문자를 구분하지 않습니다.
어제 대비 변동폭도 함께 제공되나요?
네. 지수의 일별 이력이 반영되면 가격에 previous_close, change, change_percent가 함께 제공됩니다. change_percent 1.5는 1.5%를 뜻합니다. 전일 종가를 알 수 없으면 세 값 모두 생략됩니다.
변동성 지수에는 왜 통화가 없나요?
VIX, OVX, GVZ는 돈이 아니라 기대 변동성을 나타내므로 응답에 통화가 없습니다.
지수 수준은 실시간인가요, 지연인가요?
수준은 모든 계정에서 실시간입니다. 시장이 닫혀 있으면 API는 마지막 수준과 market_session closed로 응답합니다.
이력은 얼마나 가져올 수 있나요?
이력은 우리가 보유한 시점부터 시작하며, S&P 500은 2023년 2월부터입니다. 모든 계정이 보유한 전체 일봉을 받습니다. 1분봉은 최근 12개월을 다루고 요청 한 번에 최대 5일까지 가능합니다.
비용은 얼마인가요?
호출은 1,000건당 $2이며 선불 크레딧에서 차감됩니다. 모든 계정은 가입 후 첫 12개월 동안 매월 $10의 무료 크레딧을 받습니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.