収支を計算する前に取引の流れを定義する
輸出は、ある経済から他の経済へ送られる財を記録します。輸入は、入ってくる財を記録します。財の貿易は有形の物品を対象とします。より広い貿易指標には、旅行や専門サービスなどのサービスも含まれます。他の貿易総額と比較する前に、その数値の対象範囲を必ず確認してください。
統計機関は主に税関申告やその他の輸送記録から財の統計を作成します。財を分類し、金額を記録して、報告期間に割り当てます。遅れて届いた記録や訂正により、合計が改定される場合があります。米国国勢調査局は、こうした収集・評価のルールを貿易統計ガイドで説明しています。
収支は輸出から輸入を差し引きます。結果がプラスなら、選んだ対象範囲と期間で輸出が輸入を上回っています。マイナスなら輸入が輸出を上回っています。符号だけでは原因は分かりません。両方の流れを読み、変化が輸出、輸入、その両方のどこから生じたかを確認してください。
赤字と黒字の例を計算する
この例の数値はすべて説明用です。金額を十億通貨単位で表し、ある国の1か月の財の輸出を189、輸入を275とします。収支は189 - 275 = -86です。財の貿易赤字は86(十億通貨単位)となります。
比較可能な次の月に、十億単位で輸出が200、輸入が260なら、収支は-60です。赤字は26縮小しましたが、収支はまだマイナスです。輸出は11増え、輸入は15減りました。どちらも赤字の縮小に寄与しています。
黒字の例では、十億単位で輸出280、輸入260なら、収支は20です。計算では符号を保持してください。文章では赤字額を正の金額で表せますが、符号付きの収支グラフでは負の値を維持する必要があります。
全体を通じて通貨と桁の単位を揃えてください。十億単位の金額を、通貨の基本単位で表した金額からそのまま引いても、意味のある結果にはなりません。
国同士で同じ対象範囲を比較する
財だけの貿易と、財・サービスの貿易は別の指標です。財の赤字だけでは、サービスを含めた後の収支は分かりません。Narwhalの文書で定められた貿易の対象は財で、coverageフィールドがその範囲を明示します。
対象範囲だけでなく評価方法も確認してください。記録された金額に運賃や保険料を含むかどうかは、貿易統計によって異なる場合があります。統計機関が対象範囲や評価額を調整するため、税関ベースの財の合計と国際収支の財の指標も異なる場合があります。異なる公表資料の数値を組み合わせる前に、各国の手法を読んでください。
月次の合計は月次、年次の合計は年次と比較してください。公式の情報源が季節調整済みと未調整の数値を公表している場合は、同じ基準を使ってください。月次の変化には、需要や供給の変化だけでなく、繰り返す貿易パターンも反映されます。
金額の合計は価格と通貨に左右されます。輸出額が増えたことだけでは、出荷した財の量が増えたとはいえません。名目の貿易額の比較を物量の比較として扱わず、通貨換算を行った場合は別途記録してください。
貿易総額または一方の流れを取得する
/v1/economics/{country}/trade を使うと、輸出、輸入、その正確な差額をまとめて取得できます。期間の形式はYYYYまたはYYYY-MMです。以下のリクエストではUSAの説明用の月を指定します。
一方向だけが必要な場合は /v1/economics/{country}/trade/exports または /v1/economics/{country}/trade/imports を使ってください。レスポンスではflowとvalueを示します。フィルターなしの合計は、国全体の財の貿易を対象とします。相手国や品目のフィルターは、絞り込み後の合計が公開されるまで404を返します。フィルターパラメーターが受け付けられたことを、該当データが利用可能な証拠とみなさないでください。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/trade?period=2026-06" \
--header "Authorization: Bearer $NARWHAL_API_KEY"金額、通貨、対象範囲を読む
このレスポンス例では、exports、imports、balanceに小数を表す文字列を使っています。3つの金額はすべてcurrencyで指定された通貨です。balanceはexportsからimportsを引いた正確な値で、マイナスになる場合があります。coverageの値により、サービスを含まないことが確認できます。
これらの説明用の金額は最初の計算例と一致します。十億単位でUSD 189からUSD 275を引くと、USD -86です。差し引くときは精度をすべて保ち、表示時だけ丸めてください。収支を保存するときはマイナス記号を削除しないでください。
periodは測定対象の月、released_onは公表日を示します。後の公表と別の観測期間を区別できるよう、両方を保持してください。
{
"country": "USA",
"period": "2026-06",
"exports": "189000000000",
"imports": "275000000000",
"balance": "-86000000000",
"currency": "USD",
"coverage": "merchandise",
"released_on": "2026-08-04"
}貿易のデータページを見る
以下の「国別貿易収支」「国別輸出」「国別輸入」を開き、収支とその2つの構成要素を併せて読んでください。数値を示すときは、財が対象であることと通貨を見えるようにしてください。リクエストとレスポンスの仕様は経済データAPIリファレンスで説明しています。
「GDP とは:GDP成長率との違い、水準・変化率・改定」では、国民経済計算における輸出と輸入の位置付けを説明します。そこで扱うGDPには財とサービスが含まれるため、ガイド間を移動するときもこの違いに注意してください。
出典・参考資料
公開日: 。最終確認日: 。

