GDP 수준에서 GDP 성장률 계산하기

API 사용 방법

수준에는 GDP 관측값 엔드포인트를, 실질 성장률에는 GDP 성장률 엔드포인트를 사용합니다. Python 예제는 2026-Q1부터의 미국 수준과 2026-Q2의 실질 성장률을 요청하므로 두 계산이 같은 분기를 가리킵니다. 비교할 때는 이 기간 레이블을 결과와 함께 두세요. 각 관측값의 value는 USD로 표시한 GDP 수준입니다. 성장률 응답은 퍼센트로 반환되므로 필드 이름과 함께 단위를 읽으세요. 수준과 성장률 퍼센트는 경제의 서로 다른 지표입니다.

1. API 키 설정 무료 API 키를 받아 NARWHAL_API_KEY 환경 변수에 넣으세요. 스크립트는 이 변수를 읽어 Authorization: Bearer YOUR_KEY 헤더로 키를 보냅니다.
2. 수준과 실질 성장률 요청하기 Python 스크립트로 GDP 관측값과 실질 성장률 응답을 가져옵니다. 관측값을 기간별로 보관하므로 나눗셈은 2026년 2분기를 분자, 1분기를 분모로 사용합니다.
   Python, 수준에서 구한 명목 성장률과 API의 실질 성장률

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1/economics/USA"
   gdp = {
       o["period"]: float(o["value"])
       for o in requests.get(
           f"{API}/gdp/observations", params={"start": "2026-Q1"}, headers=H, timeout=10
       ).json()["observations"]
   }
   growth = requests.get(
       f"{API}/gdp-growth", params={"period": "2026-Q2"}, headers=H, timeout=10
   ).json()
   
   q = gdp["2026-Q2"] / gdp["2026-Q1"] - 1
   print(f"nominal GDP, Q2 vs Q1: {q:.2%}   as an annual rate: {(1 + q) ** 4 - 1:.2%}")
   print(
       f"real GDP growth from the API: {growth['quarter_over_quarter']}% on the quarter, "
       f"{growth['year_over_year']}% on the year"
   )

3. 명목 계산 읽기 변수 q는 분기 수준 사이의 변화를 담고, 첫 번째 print 문이 이를 퍼센트로 나타냅니다. 연율 계산은 같은 분기 변화를 복리로 계산하며, 수준에 포함된 물가 변동을 제거하지는 않습니다.
4. 실질 성장률 응답 읽기 quarter_over_quarter 필드는 퍼센트로 나타낸 실질 성장률이며 연율로 환산되지 않았습니다. year_over_year 필드는 실질 전년 동기 대비 퍼센트이므로 비교하려는 구간에 맞는 필드를 쓰세요.

스프레드시트 또는 코드 없이 계산

이전 분기의 GDP 수준을 B2에, 나중 분기의 수준을 B3에 넣습니다. 미국 2026년 2분기 비교에서는 B2에 1분기 수준 31,906,274,000,000 USD가, B3에 2분기 수준 32,563,030,000,000 USD가 들어갑니다. Python 계산에 쓴 수준과 같습니다. 나중 값을 이전 값으로 나눈 뒤 1을 뺍니다. 결과를 퍼센트 서식으로 지정하면 계산 예시와 같은 형태로 변화를 볼 수 있습니다. 수식이 셀을 참조하므로 비교하려는 기간과 순서가 맞게 두세요.

=B3/B2-1

그 분기 변화를 연율로 나타내려면 같은 셀에 다음 수식을 사용하세요. 두 계산 모두 셀에는 수준 전체 값을 그대로 두세요. 연율 수식은 그 비율에서 바로 계산합니다.

=(B3/B2)^4-1

전년 동기 대비 성장률은 4분기 전 수준으로 나눈 뒤 1을 뺍니다. 비교 기간이 바뀌지만 여전히 당해 가격 수준을 쓰므로, 기간이 1년이어도 결과는 명목 성장률입니다.

상황별 계산 방법

수준에서 구한 GDP 성장률이 헤드라인 수치와 다른 이유는 무엇인가요?

수준은 당해 가격 기준이라 물가 상승을 포함하지만, 헤드라인 지표는 불변 가격 기준의 실질 성장률입니다. 그 요소를 뺀 성장률이 필요하면 GDP 성장률 엔드포인트가 실질 비교 값을 제공합니다.

2026년 2분기의 명목 전분기 대비 결과는 2.06%, 실질 결과는 0.55%입니다. 차이는 1.51퍼센트포인트입니다. 이 차이는 당해 가격 수준 안에 들어 있는 물가 상승을 반영합니다. 인플레이션율을 대략 빼는 것은 물가 지수를 대신할 수 없습니다.

분기 GDP 성장률을 연율로 환산해야 하나요?

연율 비교가 필요할 때만 환산하세요. 미국 헤드라인 수치는 연율로 발표되는 경우가 많지만 API의 quarter_over_quarter 필드는 연율로 환산되지 않습니다. 수치를 비교하기 전에 분기뿐 아니라 변화율 표기 방식도 맞추세요.

GDP 관측값에는 각 수준이 연율로 표시되어 있어 annualized: true가 붙습니다. 분기 수준을 서로 나누면 여전히 전분기 대비 변화가 나옵니다. 그 비율을 4제곱하고 1을 빼면 변화를 연율로 나타낼 수 있지만, 전년 동기 대비 성장률이 되지는 않습니다.

명목 GDP로 경제 규모를 측정할 수 있나요?

네, GDP 수준은 당해 가격 기준 USD로 명목 규모를 나타냅니다. 그 규모가 필요하면 수준을 쓰고, 선택한 구간의 명목 변화가 필요하면 수준끼리 비교하세요. 물량 기준 성장률을 비교하려면 GDP 성장률 엔드포인트의 실질 성장률을 사용하세요.

계산 예: 미국 2026년 2분기

미국의 2026년 1분기와 2분기 GDP 수준에서 시작합니다. 두 값 모두 연율 기준 USD입니다. 1을 빼거나 변화를 연율로 나타내기 전에 2분기 값을 1분기 값으로 나눕니다.

2분기 수준을 1분기 수준으로 나누면 비율은 1.020583입니다. 몫에서 1을 빼면 명목 변화가 나오고, 퍼센트로 나타내면 2026년 2분기는 1분기 대비 2.06%입니다. 계산에는 수준 전체 값을 쓰고, 연율 계산을 위해 반올림하지 않은 몫을 보관하세요.

미국 2026년 2분기 변화를 연율로 나타내려면 반올림하지 않은 몫을 4제곱하고 1을 뺍니다. 결과는 8.49%입니다. 이와 별개로 2026-Q2의 실질 전분기 대비 성장률 필드는 0.55%입니다. 명목 분기 수치를 실질 분기 수치와 비교하세요. 2.06%에서 0.55%를 빼면 차이는 1.51퍼센트포인트입니다.