Sheets 링크
표로 응답하는 모든 주소, 표가 만들어지는 방식, 링크의 비용, 문제가 있을 때 셀에 표시되는 내용을 설명합니다.
시트 링크는 스프레드시트가 읽을 수 있는 표로 응답하는 Narwhal 주소입니다. format=csv와 끝에 붙은 Sheets 키가 있는 일반 GET 주소입니다.
https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR&format=csv&key=YOUR_SHEETS_KEYcurrency,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:/ 뒤의 주소 |
|---|---|
| 연도별 공휴일 | / |
| 다음 공휴일 | / |
| 발표 일정 | / |
| CPI, 최신 및 이력 | /, / |
| 인플레이션 | /, / |
| GDP | /, / |
| GDP 성장률 | /, / |
| 실업률 | /, / |
| 경제활동참가율 | /, / |
| 무역 | /, / |
| 모든 시리즈 | / |
| 정책금리 | /, / |
| 금리 결정 | / |
| 중앙은행 보유액 | / |
| 주식 위험 프리미엄, 전체 국가 | / |
| 주식 위험 프리미엄, 한 국가 | /, / |
| 원자재 가격, 전체 | / |
| 원자재 하나 | /, / |
| 환율 | /, /, / |
| 금리 결정 확률 | /, / |
표가 만들어지는 방식
- 헤더 행 하나 다음에 항목마다 한 행입니다. 한 가지만 반환하는 호출은 한 행입니다.
- 중첩 필드는
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 |
다음
이 페이지가 도움이 되었나요?