국가별 주식 위험 프리미엄과 자본비용 입력값 구하기

국가별 주식 위험 프리미엄 읽기

curl -s "https://api.narwhalapi.com/v1/economics/BRA/equity-risk-premium" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

{
  "country": "BRA",
  "as_of": "2026-11-01",
  "unit": "percent",
  "mature_erp": "3.2973",
  "country_default_spread": "2.1300",
  "volatility_ratio": "1.5211",
  "country_risk_premium": "3.2400",
  "total_erp": "6.5373",
  "basis": {
    "mature_erp": "observed",
    "country_default_spread": "table",
    "volatility_ratio": "table",
    "country_risk_premium": "table",
    "total_erp": "table"
  },
  "methodology_url": "https://narwhalapi.com/methodology/equity-risk-premium"
}

모든 수치는 퍼센트이고, as_of는 그 수치가 설명하는 날짜입니다. 다섯 수치는 주식 위험 프리미엄 방법론에서 설명하듯 서로 이어져 있습니다.

• mature_erp는 성숙시장, 즉 미국의 내재 프리미엄입니다. 모든 국가의 응답에서 같은 값입니다.
• country_default_spread는 그 나라가 부도 위험 때문에 성숙시장보다 더 지급하는 수익률입니다.
• volatility_ratio는 주식 변동성을 국채 변동성으로 나눈 값입니다.
• country_risk_premium은 스프레드에 비율을 곱한 값입니다. 브라질은 2.13 곱하기 1.5211이 3.24입니다.
• total_erp는 mature_erp에 country_risk_premium을 더한 값입니다. 브라질은 3.2973 더하기 3.24가 6.5373입니다.

basis 객체는 각 부분이 observed, modelled, table 중 무엇인지 알려줍니다. table 값은 공개된 국가 위험 표에서 가져옵니다. 이런 행은 표가 갱신된 시점만큼만 최신이므로, 채권 수익률이 바뀔 때마다가 아니라 표가 갱신될 때 움직입니다. 미국 응답은 스프레드가 0이고 volatility_ratio가 null입니다. 미국이 성숙시장이므로 total_erp가 mature_erp와 같기 때문입니다.

프리미엄을 자기자본비용으로 바꾸기

한 나라의 프로젝트에 대한 자기자본비용은 무위험 수익률에, 베타에 현금흐름이 발생하는 국가의 총 프리미엄을 곱한 값을 더한 것입니다. 방법론에 따르면 수치가 미국 달러 기준이므로 미국 무위험 수익률을 써야 합니다. 스크립트는 수익률 곡선 경로에서 미국 10년물 수익률을 읽고, 사용자의 베타를 받은 뒤, GET /v1/economics/equity-risk-premium에서 모든 국가를 읽어 mature_erp에 country_risk_premium을 더한 값이 total_erp와 같은지 확인한 다음 그 행을 사용합니다.

1. 입력값 고르기 무위험 수익률은 API에서 가져옵니다. 베타 1.2는 직접 추정한 값을 넣을 자리표시자입니다. 프리미엄 경로는 베타를 제공하지 않습니다.
2. 스크립트 실행하기 국가 수와 네 나라의 자기자본비용을 출력합니다.
   Python, total_erp로 구한 자기자본비용

   import os
   from decimal import Decimal
   import requests
   
   HEAD = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com"
   
   def get(path, **params):
       r = requests.get(API + path, params=params, headers=HEAD, timeout=15)
       r.raise_for_status()
       return r.json()
   
   # Risk-free rate: the 10 year US yield, in percent
   rf = Decimal(get("/v1/economics/USA/yield-curve", maturity="10y")["yields"][0]["yield_percent"])
   beta = Decimal("1.2")  # your own estimate for the project
   
   countries = {c["country"]: c for c in get("/v1/economics/equity-risk-premium")["countries"]}
   print(len(countries), "countries")
   
   for code in ("USA", "IDN", "BRA", "ZAF"):
       c = countries[code]
       mature, crp, total = (Decimal(c[k]) for k in ("mature_erp", "country_risk_premium", "total_erp"))
       assert mature + crp == total
       print(f"{code} as_of {c['as_of']}  mature {mature}  crp {crp}  total {total}  "
             f"cost of equity {rf + beta * total:.2f}%")

3. 결과 읽기 10년물 수익률은 4.91%였습니다. 스크립트는 목록의 175개국 중에서 자기자본비용을 미국 8.87%, 인도네시아 11.82, 브라질 12.75, 남아프리카공화국 13.55로 반환했습니다.

이는 달러 기준 할인율입니다. 현지 통화 할인율은 방법론에서 말하듯 두 통화의 인플레이션 차이를 더해야 합니다.

상장 기업의 베타, 부채비용, WACC 구하기

상장 주식의 경우 자본비용 경로가 같은 계산을 하고 WACC까지 이어갑니다. 베타, 무위험 수익률, 사용한 프리미엄, 자기자본비용, 부채비용, 세율, 가중치를 한 번의 응답으로 반환합니다. 기본 프리미엄은 해당 종목 국가에 대한 Narwhal의 자체 합계입니다. erp로 직접 값을 보낼 수도 있습니다. 공식과 거부되는 경우는 자본비용 방법론에 정리되어 있습니다.

curl -s "https://api.narwhalapi.com/v1/equities/XNAS:MSFT/cost-of-capital" \
  -H "Authorization: Bearer $NARWHAL_API_KEY"

{
  "id": "XNAS:MSFT",
  "currency": "USD",
  "beta": {
    "window": "2y",
    "frequency": "weekly",
    "observations": 103,
    "raw": "1.1507",
    "adjusted": "1.1010",
    "used": "raw"
  },
  "risk_free": {
    "rate": "4.9100",
    "source": "yield_curve",
    "as_of": "2026-11-02"
  },
  "equity_risk_premium": {
    "rate": "3.2973",
    "source": "narwhal",
    "country": "USA",
    "as_of": "2026-11-01",
    "basis": "observed"
  },
  "cost_of_equity": "8.7042",
  "cost_of_debt": {
    "pre_tax": "8.1917",
    "after_tax": "6.0922",
    "period": "ttm"
  },
  "tax_rate": {
    "rate": "25.6300",
    "basis": "table"
  },
  "weights": {
    "equity": "99.0666",
    "debt": "0.9334"
  },
  "wacc": "8.6798",
  "warnings": [],
  "methodology_url": "https://narwhalapi.com/methodology/cost-of-capital"
}

cost_of_equity 8.7042는 무위험 수익률 4.91에, 원래 베타 1.1507과 프리미엄 3.2973의 곱을 더한 값입니다. 가중치는 자기자본 99.0666%, 부채 0.9334%이고 wacc는 8.6798%입니다. 전체 응답에서는 모든 입력값에 근거와 날짜가 붙고, 주의가 필요한 수치에는 warnings 항목이 붙습니다(여기서는 비어 있습니다).

프리미엄은 시간에 따라 변하나요?

예. 이력 경로에서 이전 날짜를 볼 수 있습니다. 인도네시아는 as_of 2026-10-28에 total_erp가 5.6830, as_of 2026-11-01에 5.7573이었고, 그동안 country_default_spread는 1.6200으로 그대로였습니다. mature_erp가 3.2230에서 3.2973으로 움직였고, 그 때문에 합계가 움직였습니다.

가치 평가에 사용하는 모든 수치 옆에 as_of 날짜를 저장해 나중에 추적할 수 있게 하세요. 날짜 사이에 프리미엄이 어떻게 움직였는지 보려면 이력 경로를 읽으세요.

자본비용 경로가 답할 수 없을 때는 어떻게 되나요?

빈 곳을 채우는 대신 422를 반환하고 문제를 알려줍니다. AAPL 호출은 이자비용이 등록되어 있지 않다는 내용과 함께 inputs_unavailable을 반환했습니다. 이 경로는 은행과 보험사도 거부합니다. 경로가 허용하는 곳에는 직접 erp, risk_free, tax_rate를 전달하고, 코드에서 422를 처리하세요.

어느 국가를 지원하나요?

목록 경로는 위 실행에서 175개국을 반환했습니다. 국가는 모든 입력값이 있을 때만 나타나므로, 코드가 없다는 것은 0이 아니라 행이 없다는 뜻입니다. 브라질, 인도네시아, 남아프리카공화국, 미국은 응답했습니다.