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 のような3文字のコードです。
| データ | https:/ に続くアドレス |
|---|---|
| 1年分の祝日 | / |
| 次の祝日 | / |
| 発表カレンダー | / |
| CPI、最新値と履歴 | /, / |
| インフレ率 | /, / |
| GDP | /, / |
| GDP 成長率 | /, / |
| 失業率 | /, / |
| 労働力参加率 | /, / |
| 貿易 | /, / |
| 任意の系列 | / |
| 政策金利 | /, / |
| 政策金利の決定 | / |
| 中央銀行の外貨準備 | / |
| 株式リスクプレミアム、全ての国 | / |
| 株式リスクプレミアム、1か国 | /, / |
| 商品価格、全て | / |
| 1つの商品 | /, / |
| 為替レート | /, /, / |
| 政策金利の決定確率 | /, / |
表の組み立て方
- ヘッダー行が1行あり、その後に項目ごとに1行が続きます。1件だけ返す呼び出しは1行になります。
- 入れ子のフィールドは、
value.actualのようにドットでつないだ列になります。 - 単純な値のリストは
;でつなぎます。 - 空の値は空のセルになります。真偽値は
trueとfalseです。 - 数値は、API が送るテキストのままです。
- 発表カレンダーは、1発表につき1行で、時刻順に並びます。
value_はその発表に含まれる数値の数を示し、行にはその最初の1つが表示されます。count - 行がない呼び出しは、空の応答を返します。
リンクの料金
リンクとは、キーを含めたアドレスのことです。その日の最初の読み込みでは、その呼び出しの通常の料金がかかります。同じ日の同じリンクの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 |
次へ
このページは役に立ちましたか?