経済カレンダーを作成する
選んだ国と日付のリリース時刻を UTC で一覧します。
ガイドを読む →貿易統計APIで、国ごとの公式な商品貿易統計をRESTまたはMCPで照会。受理済みの最新値、指定した期間の値、日付付きの履歴を取得できます。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/trade?period=2026-06" \
--header "Authorization: Bearer $NARWHAL_API_KEY"/v1/economics/{country}/trade1期間の輸出額、輸入額、正確な財貿易収支を取得します。サービスは含みません。
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
period任意受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
version_id任意任意の不変な公開バージョン。dataset.published または dataset.revised イベントの resource_version を使います。省略すると現在承認されている指標を読み取ります。
country文字列指定された大文字 ISO alpha-3 国コード。
period文字列返される公式観測期間。
exports非負の小数文字列財輸出合計。
imports非負の小数文字列財輸入合計。
balance小数文字列輸出から輸入を差し引いた正確な値で、負になる場合があります。
currencyISO 4217 文字列3つすべての金額の通貨。
released_on日付Narwhal の取得時刻ではなく、公式の公表日。
sourceオブジェクト任意の source オブジェクトは、統計が配信元経由で届いた場合にだけ現れます。publisher(配信元が示す元の発表機関)と distributor(配信した組織)を含みます。source がある場合、released_on は配信元の公表日であり、元の発表機関の発表日ではありません。発表機関から直接届く系列には source がありません。
/v1/economics/{country}/trade/observations1つの国について、現在受け入れられている財貿易の時系列を取得します。
country必須対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
start任意最初の観測期間(その期間を含む)。
end任意最後の観測期間(その期間を含む)。
limit任意返す期間数の上限。デフォルトは 100 です。1ページの期間数がこれより少ない場合もあるため、next_cursor をたどってください。
cursor任意前のページの next_cursor。
version任意first_reported のみ受け付けます。各期間について最初に保存された値を first_reported_at とともに返します。as_of とは併用できません。
as_of任意指定した UTC 日の終わりまでに公表されていたとおりの系列を返します。version とは併用できません。
country文字列リクエストした大文字の ISO alpha-3 国コード。観測値ごとではなく、ページごとに1回返します。
start文字列Narwhal がリクエストした start を後の期間に移動した場合にのみ含まれます。それより前の期間は返しません。
as_ofRFC 3339 タイムスタンプこのページの最新の観測値をソースが最後に更新した時刻。UTC、秒単位です。
sourceオブジェクト配信事業者を通じて受け取った統計の出所情報。最新値を取得する操作を参照してください。
currencyISO 4217 文字列ページ内のすべての値に共通する通貨。
observations配列採用済みの観測値を古い順に、各期間につき1件返します。ソースにない値は省略し、補完しません。1ページの観測値の件数が limit より少ない場合もあるため、next_cursor が null になるまでたどってください。
observations[].period文字列観測値が表す公式の月または四半期。
observations[].first_reported_atRFC 3339 タイムスタンプversion=first_reported のときだけ現れます。この UTC タイムスタンプは、Narwhal がその期間を最初に保存した時刻です(指標が別々に保存された場合は最も遅い時刻)。取得開始前に公表された期間には、Narwhal の最初の取得時刻が入ります。
observations[].exports小数文字列対象期間の財輸出額。その期間の値がない場合は省略します。
observations[].imports小数文字列対象期間の財輸入額。その期間の値がない場合は省略します。
next_cursor文字列または null次のページを読むには、この値を変更せず cursor に渡してください。最終ページでは null です。
この種類には、各国の統計機関が公表する公式の財貿易統計が含まれます。
はい。APIは、正確な期間の指定、日付付きの履歴、最新の承認済みの値をサポートしています。
はい。貿易データは、同じAPIキーでMCPとRESTから利用できます。
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。