すべてのドキュメントを閲覧

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 のような3文字のコードです。

データhttps://api.narwhalapi.com に続くアドレス
1年分の祝日/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
株式リスクプレミアム、1か国/v1/economics/{country}/equity-risk-premium, /history
商品価格、全て/v1/commodities/spot
1つの商品/v1/commodities/spot/{commodity}/{currency}, /bars
為替レート/v1/fx/rates/{base}, /observations, /bars
政策金利の決定確率/v1/predictions/policy-paths/{authority}, /history

表の組み立て方

  • ヘッダー行が1行あり、その後に項目ごとに1行が続きます。1件だけ返す呼び出しは1行になります。
  • 入れ子のフィールドは、value.actual のようにドットでつないだ列になります。
  • 単純な値のリストは ; でつなぎます。
  • 空の値は空のセルになります。真偽値は true と false です。
  • 数値は、API が送るテキストのままです。
  • 発表カレンダーは、1発表につき1行で、時刻順に並びます。value_count はその発表に含まれる数値の数を示し、行にはその最初の1つが表示されます。
  • 行がない呼び出しは、空の応答を返します。

リンクの料金

リンクとは、キーを含めたアドレスのことです。その日の最初の読み込みでは、その呼び出しの通常の料金がかかります。同じ日の同じリンクの2回目以降の読み込みは無料です。日付は UTC の午前0時に切り替わります。アドレスの一部を変えると新しいリンクになります。

問題があるときにセルに表示される内容

セルには1行が表示されます。スプレッドシートが表示できるよう、応答の 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 or 422

次へ

このページは役に立ちましたか?