전체 문서 탐색

Sheets 링크

표로 응답하는 모든 주소, 표가 만들어지는 방식, 링크의 비용, 문제가 있을 때 셀에 표시되는 내용을 설명합니다.

시트 링크는 스프레드시트가 읽을 수 있는 표로 응답하는 Narwhal 주소입니다. format=csv와 끝에 붙은 Sheets 키가 있는 일반 GET 주소입니다.

주소
https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR&format=csv&key=YOUR_SHEETS_KEY
답
currency,rate,timestamp,stale
EUR,0.90718,2026-11-15T16:00:00Z,false
IDR,18222.7,2026-11-15T16:00:00Z,false

매개변수

매개변수필수의미
format=csv예표 형태로 응답합니다.
key예대시보드의 Team and keys에서 받은 Sheets 키입니다. API 키는 여기서 거부됩니다.
해당 경로의 기본값경로에 따름JSON 호출과 같은 파라미터입니다. 예: start, end, currencies, countries.

주소

중괄호 안의 단어를 바꾸세요. 국가는 USA 같은 세 글자 코드입니다.

데이터https://api.narwhalapi.com 뒤의 주소
연도별 공휴일/v1/calendars/holidays/{country}/{year}
다음 공휴일/v1/calendars/holidays/{country}/next
발표 일정/v1/economics/calendar
CPI, 최신 및 이력/v1/economics/{country}/cpi, /cpi/observations
인플레이션/v1/economics/{country}/inflation, /inflation/observations
GDP/v1/economics/{country}/gdp, /gdp/observations
GDP 성장률/v1/economics/{country}/gdp-growth, /gdp-growth/observations
실업률/v1/economics/{country}/unemployment, /unemployment/observations
경제활동참가율/v1/economics/{country}/labour-force-participation, /observations
무역/v1/economics/{country}/trade, /trade/observations
모든 시리즈/v1/economics/series/{series_id}/observations
정책금리/v1/economics/{country}/central-bank/policy-rate, /policy-rate/history
금리 결정/v1/economics/{country}/central-bank/decisions
중앙은행 보유액/v1/economics/{country}/central-bank/reserves
주식 위험 프리미엄, 전체 국가/v1/economics/equity-risk-premium
주식 위험 프리미엄, 한 국가/v1/economics/{country}/equity-risk-premium, /history
원자재 가격, 전체/v1/commodities/spot
원자재 하나/v1/commodities/spot/{commodity}/{currency}, /bars
환율/v1/fx/rates/{base}, /observations, /bars
금리 결정 확률/v1/predictions/policy-paths/{authority}, /history

표가 만들어지는 방식

  • 헤더 행 하나 다음에 항목마다 한 행입니다. 한 가지만 반환하는 호출은 한 행입니다.
  • 중첩 필드는 value.actual처럼 점이 들어간 열이 됩니다.
  • 단순 값의 목록은 ;로 연결됩니다.
  • 빈 값은 빈 셀입니다. 참과 거짓은 true와 false입니다.
  • 숫자는 API가 보낸 텍스트 그대로 유지됩니다.
  • 발표 일정은 발표마다 한 행이며 시간순으로 정렬됩니다. value_count는 발표에 포함된 수치의 개수이며, 행에는 첫 번째 수치가 표시됩니다.
  • 행이 없는 호출은 빈 응답을 반환합니다.

링크의 비용

링크는 키가 포함된 주소입니다. 하루 중 첫 로드에는 해당 호출의 정상 가격이 청구됩니다. 같은 날 같은 링크를 다시 로드하면 무료입니다. 날짜는 UTC 자정에 바뀝니다. 주소의 일부를 바꾸면 새 링크가 됩니다.

문제가 있을 때 셀에 표시되는 내용

셀에는 한 줄이 표시됩니다. 스프레드시트가 표시할 수 있도록 응답의 HTTP 상태는 200이며, 실제 상태는 x-narwhal-status 헤더에 있습니다.

셀에 표시되는 줄실제 상태
Narwhal: this Sheets key is switched off or not valid. Copy a new link from https://narwhalapi.com/dashboard.401
Narwhal: this is an API key, not a Sheets key. Make a Sheets key at https://narwhalapi.com/dashboard and use it in the link.401
Narwhal: a Sheets key reads data routes only, and the link must end in format=csv.403
Narwhal: out of credit. Add credit at https://narwhalapi.com/dashboard and refresh this sheet.402
Narwhal: too many requests. This sheet will update on its next refresh.429
Narwhal: bad parameter. (what is wrong)400 또는 422

다음

이 페이지가 도움이 되었나요?