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

経常収支 API

1つの国について、IMFの四半期の経常収支を米ドルで取得します。

economics_get_current_account を利用できるのは REST と、 economics_get_current_account MCPツール。どちらも同じデータ形式を返し、同じクレジットを使用します。

エンドポイントとリクエスト

REST エンドポイント
GET /v1/economics/{country}/current-account
リクエストの例
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/IDN/current-account" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP で使用するツールは economics_get_current_account です。以下の対応する引数を指定します。

パラメータ

この操作で受け付ける期間形式: YYYY-QN。

名前必須種別意味
countryはいパス · ISO alpha-3対応している国コードを大文字で1つ指定します。この操作のカバレッジ一覧を確認してください。
periodいいえクエリ · YYYY-QN受け入れ済みの完全な公表データのうち最新のものを取得するには省略します。特定の期間を1つ指定することもできます。
series_idいいえクエリ · UUID任意。以前の回答から取得した1つの系列の`series_id`。省略すると、その国のデフォルトの系列を読み取ります。

レスポンス

レスポンスの例
{
  "source": {
    "publisher": "Country authorities; National Summary Data Pages; European Central Bank; IMF Staff Estimates",
    "distributor": "International Monetary Fund"
  },
  "accounting_standard": "BPM6",
  "time_basis": "period_flow",
  "period": "2026-Q2",
  "value": "-12487416024.3855",
  "country": "IDN",
  "series_id": "b025aa04-14db-4649-87b8-359c20069196",
  "unit": "currency",
  "currency": "USD"
}
フィールド種別必須意味
sourceオブジェクトはい数値の発行元。publisherはIMFの系列メタデータに記載された元の発行元で、distributorはNarwhalが読み取る元のIMFです。系列ごとに全履歴を通じて出典は1つです。released_onはありません。
accounting_standard文字列はい数値が従う国際収支マニュアル。例:BPM6。
time_basis文字列はい常にperiod_flow:四半期中の純フローであり、残高ではありません。
period文字列はい返される公式観測期間。
value小数文字列はいその四半期の経常収支の純額(米ドル)。負の値は赤字です。
status文字列いいえ発行元が示す数値にのみ含まれます:estimated、break_in_series、definition_differs、break_in_series_and_definition_differs。それ以外は省略されます。
release_status文字列いいえ発行元がその数値を暫定としている場合はpreliminary。それ以外は省略されます。
country文字列はい指定された大文字 ISO alpha-3 国コード。
series_id文字列はい数値の元になった系列。同じ系列を再度読み取るには、series_idとして渡します。
unit文字列はいAlways currency.
currencyISO 4217 文字列はいAlways USD.

APIエラーとクレジット

  • 400 invalid_query: A query parameter is unknown or repeated, country is not three uppercase letters, series_id is not a UUID, or period is not a quarter in YYYY-QN format. version_id, version and as_of are not accepted on this route.
  • 401 invalid_api_key: Bearerキーがないか拒否されました。
  • 402 insufficient_credits: 残高では呼び出しの料金を支払えません。
  • 404 series_not_found: その国がこのページの対象国一覧にない、series_idがその国の系列ではない、またはperiodに一致する観測値がありません。一覧にない国には、この指標群は利用できないという詳細が返ります。404は課金されません。
  • 429 rate_limit_exceeded: ネットワークまたはアカウントの短時間枠の上限に達しました。Retry-Afterの後に再試行してください。
  • 503 economics_unavailable: Narwhalは保存されている系列を安全に提供できません。

Only a successful data response costs credit. 参照: すべてのエラー、ヘッダー、再試行規則。

鮮度

periodを省略すると、保存されている最新の観測値を返します。このAPI呼び出しはNarwhalのデータベースを読み取ります。発行元をリアルタイムで呼び出すことはありません。配信元が示す日付は発行元の公表日ではないため、回答にreleased_onはありません。

読む ソース確認、検証、保存済みリリース、確認失敗の仕組み。

現在の公開ベータ版カバレッジ

9 国

ARG, CHN, IDN, KOR, MEX, SLV, THA, UKR, URY

四半期ごと、米ドル。収支は財、サービス、所得、移転の純額で、負の値は赤字です。国際通貨基金(IMF)が系列を配信し、source.publisherが元の発行元を示します。期間はYYYY-QN形式の四半期です。ほかの国は404 not_foundを返し、課金されません。

日次 FX データの提供先は 為替API。

戻る: すべての 経済データ 操作。

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