문서 / 주식 위험 프리미엄 API 레퍼런스 주식 위험 프리미엄 API 레퍼런스 국가별 주식 위험 프리미엄과 국가 위험 프리미엄
개요 Narwhal의 주식 위험 프리미엄 추정치입니다. 투자자가 위험 없는 국채 대신 주식에 투자하며 추가로 기대하는 수익률입니다. 모든 요청에는 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액에서 차감됩니다.
국가는 ISO 3166 alpha-3 코드로 나타냅니다. 예: USA, IDN. 합계는 성숙 시장 프리미엄에 국가 위험 프리미엄을 더한 값이고, 국가 위험 프리미엄은 국가 부도 스프레드에 변동성 비율을 곱한 값입니다. 모든 수치는 소수점 넷째 자리까지의 십진 문자열로 표시한 퍼센트이며, 비율만 일반 숫자입니다.
각 수치에는 기준이 붙습니다. 시장 데이터나 공식 데이터에서 관측했거나, 모형으로 추정했거나, 방법 페이지가 출처를 밝히는 공개 국가 위험 표에서 가져온 것입니다. 방법, 입력값, 한계는 주식 위험 프리미엄 방법론 페이지에 있으며 모든 응답이 이 페이지로 연결됩니다.
기본 URL: https:/. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.
모든 계정에 제공되는 것 항목 모든 계정 국가의 최신 수치 포함 전체 국가의 최신 수치 포함 과거 데이터 전체 이력
확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.
A country appears only when we hold a row for it. Without a row the route returns 404 series_not_found; nothing is filled in or carried forward. 성숙 시장에는 국가 프리미엄이 없습니다. 미국은 부도 스프레드가 0이고 변동성 비율이 비어 있으며 합계는 성숙 시장 프리미엄과 같습니다. 유로 지역의 기준인 독일도 국가 프리미엄이 0입니다. 수치는 미국 달러 기준입니다. 다른 통화의 할인율에는 두 통화 사이의 물가 상승률 차이를 더해야 합니다. 이력은 날짜 기준으로 페이지를 나눕니다. 다음 페이지를 읽으려면 한 페이지의 next_를 다른 매개변수와 함께 보내십시오. 수치는 분석용 추정치이며 재무, 투자, 법률, 세무 조언이 아닙니다. 엔드포인트 모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.
국가의 주식 위험 프리미엄 조회 GET /v1/economics/{country}/equity-risk-premium
한 국가의 최신 주식 위험 프리미엄, 또는 date 당일 또는 그 이전의 최신 값입니다. 성숙 시장 프리미엄, 국가 부도 스프레드, 변동성 비율, 국가 위험 프리미엄, 합계가 각각 기준과 함께 나옵니다.
date를 보내면 그 날짜 당일 또는 그 이전의 최신 수치를 읽습니다.
MCP: 도구 economics_.
매개변수 매개변수 위치 필수 유형 의미 country경로 예 문자열 date쿼리 아니요 문자열
응답 필드 필드 유형 전송 의미 country문자열 항상 as_날짜 항상 unitalways "percent" 항상 mature_문자열 항상 country_문자열 항상 volatility_문자열 항상 country_문자열 항상 total_문자열 항상 basis객체 항상 basis.mature_다음 중 하나: observed, modelled, table 항상 basis.country_다음 중 하나: observed, modelled, table 항상 basis.volatility_다음 중 하나: observed, modelled, table 항상 basis.country_다음 중 하나: observed, modelled, table 항상 basis.total_다음 중 하나: observed, modelled, table 항상 methodology_always "https://narwhalapi.com/methodology/equity-risk-premium" 선택
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/economics/ITA/equity-risk-premium" {
"country" : "ITA" ,
"as_of" : "2026-10-28" ,
"unit" : "percent" ,
"mature_erp" : "3.2230" ,
"country_default_spread" : "0.8881" ,
"volatility_ratio" : "2.0310" ,
"country_risk_premium" : "1.8037" ,
"total_erp" : "5.0267" ,
"basis" : {
"mature_erp" : "observed" ,
"country_default_spread" : "observed" ,
"volatility_ratio" : "modelled" ,
"country_risk_premium" : "modelled" ,
"total_erp" : "modelled"
},
"methodology_url" : "https://narwhalapi.com/methodology/equity-risk-premium"
}주식 위험 프리미엄 이력 조회 GET /v1/economics/{country}/equity-risk-premium/history
한 국가의 주식 위험 프리미엄을 날짜순(오래된 것부터)으로 반환하며 next_로 페이지를 넘깁니다.
MCP: 도구 economics_.
매개변수 매개변수 위치 필수 유형 의미 country경로 예 문자열 start쿼리 아니요 문자열 end쿼리 아니요 문자열 limit쿼리 아니요 정수 cursor쿼리 아니요 문자열 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다.
응답 필드 필드 유형 전송 의미 country문자열 항상 observations객체 목록 항상 observations[].country문자열 항상 observations[].as_날짜 항상 observations[].unitalways "percent" 항상 observations[].mature_문자열 항상 observations[].country_문자열 항상 observations[].volatility_문자열 항상 observations[].country_문자열 항상 observations[].total_문자열 항상 observations[].basis객체 항상 observations[].basis.mature_다음 중 하나: observed, modelled, table 항상 observations[].basis.country_다음 중 하나: observed, modelled, table 항상 observations[].basis.volatility_다음 중 하나: observed, modelled, table 항상 observations[].basis.country_다음 중 하나: observed, modelled, table 항상 observations[].basis.total_다음 중 하나: observed, modelled, table 항상 observations[].methodology_always "https://narwhalapi.com/methodology/equity-risk-premium" 선택 next_문자열 항상 Pass as cursor to read the next page. Always sent; null on the last page.
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/economics/ITA/equity-risk-premium/history?start=2026-01-01" {
"country" : "ITA" ,
"observations" : [
{
"country" : "ITA" ,
"as_of" : "2026-09-01" ,
"unit" : "percent" ,
"mature_erp" : "3.2230" ,
"country_default_spread" : "0.8881" ,
"volatility_ratio" : "2.0310" ,
"country_risk_premium" : "1.8037" ,
"total_erp" : "5.0267" ,
"basis" : {
"mature_erp" : "observed" ,
"country_default_spread" : "observed" ,
"volatility_ratio" : "modelled" ,
"country_risk_premium" : "modelled" ,
"total_erp" : "modelled"
},
"methodology_url" : "https://narwhalapi.com/methodology/equity-risk-premium"
},
{
"country" : "ITA" ,
"as_of" : "2026-10-28" ,
"unit" : "percent" ,
"mature_erp" : "3.2230" ,
"country_default_spread" : "0.8881" ,
"volatility_ratio" : "2.0310" ,
"country_risk_premium" : "1.8037" ,
"total_erp" : "5.0267" ,
"basis" : {
"mature_erp" : "observed" ,
"country_default_spread" : "observed" ,
"volatility_ratio" : "modelled" ,
"country_risk_premium" : "modelled" ,
"total_erp" : "modelled"
},
"methodology_url" : "https://narwhalapi.com/methodology/equity-risk-premium"
}
],
"next_cursor" : null
}전체 국가의 주식 위험 프리미엄 목록 GET /v1/economics/equity-risk-premium
수치가 있는 모든 국가의 최신 주식 위험 프리미엄을 국가순으로 정렬합니다.
MCP: 도구 economics_.
매개변수 이 라우트는 파라미터가 없습니다.
응답 필드 필드 유형 전송 의미 countries객체 목록 항상 countries[].country문자열 항상 countries[].as_날짜 항상 countries[].unitalways "percent" 항상 countries[].mature_문자열 항상 countries[].country_문자열 항상 countries[].volatility_문자열 항상 countries[].country_문자열 항상 countries[].total_문자열 항상 countries[].basis객체 항상 countries[].basis.mature_다음 중 하나: observed, modelled, table 항상 countries[].basis.country_다음 중 하나: observed, modelled, table 항상 countries[].basis.volatility_다음 중 하나: observed, modelled, table 항상 countries[].basis.country_다음 중 하나: observed, modelled, table 항상 countries[].basis.total_다음 중 하나: observed, modelled, table 항상 countries[].methodology_always "https://narwhalapi.com/methodology/equity-risk-premium" 선택
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/economics/equity-risk-premium" {
"countries" : [
{
"country" : "DEU" ,
"as_of" : "2026-10-28" ,
"unit" : "percent" ,
"mature_erp" : "3.2230" ,
"country_default_spread" : "0.0000" ,
"volatility_ratio" : "2.5462" ,
"country_risk_premium" : "0.0000" ,
"total_erp" : "3.2230" ,
"basis" : {
"mature_erp" : "observed" ,
"country_default_spread" : "observed" ,
"volatility_ratio" : "observed" ,
"country_risk_premium" : "observed" ,
"total_erp" : "observed"
},
"methodology_url" : "https://narwhalapi.com/methodology/equity-risk-premium"
},
{
"country" : "ITA" ,
"as_of" : "2026-10-28" ,
"unit" : "percent" ,
"mature_erp" : "3.2230" ,
"country_default_spread" : "0.8881" ,
"volatility_ratio" : "2.0310" ,
"country_risk_premium" : "1.8037" ,
"total_erp" : "5.0267" ,
"basis" : {
"mature_erp" : "observed" ,
"country_default_spread" : "observed" ,
"volatility_ratio" : "modelled" ,
"country_risk_premium" : "modelled" ,
"total_erp" : "modelled"
},
"methodology_url" : "https://narwhalapi.com/methodology/equity-risk-premium"
}
]
}오류 오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.
코드 상태 의미 invalid_400 매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다. series_404 이 국가의 주식 위험 프리미엄 데이터가 없습니다. invalid_400 이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다. insufficient_402 크레딧 잔액이 요청 비용보다 적습니다. economics_503 경제 데이터가 지금은 응답할 수 없습니다. 잠시 후 다시 시도하십시오.
