# マクロ指標履歴の取得数据

get_macro_indicator_history(indicator_id, time=None, max_count=None)

  • 説明

    マクロ指標の履歴データを取得します。指定マクロ指標の履歴データポイントリストを返します。データ日付、公表日、公表値、予測値、前回値などの情報を含み、時間降順で並びます。

  • パラメータ

    パラメータ タイプ 説明
    indicator_id int マクロ指標ID(get_macro_indicator_list から取得)(必須)
    time str 時間ノード、フォーマット "yyyy-MM-dd"、この時間から遡って取得;未指定の場合デフォルト現在時刻
    max_count int 取得件数、デフォルト 100、上限 1000
  • 戻り値

    パラメータ タイプ 説明
    ret RET_CODE API呼び出し結果
    data pd.DataFrame ret == RET_OK の場合、データを返す
    str ret != RET_OK の場合、エラー説明を返す
    • データフォーマット:
      フィールド タイプ 説明
      data_time str データ日付("yyyy-MM-dd")
      release_time str 公表日("yyyy-MM-dd HH:mm:ss")
      value float 公表値(元の値に復元済み)
      predict_value float 予測値(復元済み)
      previous_value float 前回値(復元済み)
      unit_type str 単位タイプ(PERCENT=パーセント / VALUE=数値 / INDEX=指数)
  • Example

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

# まず指標IDを取得
ret, indicators = quote_ctx.get_macro_indicator_list(region=MacroRegion.US)
if ret == RET_OK:
    indicator_id = indicators.iloc[0]['indicator_id']

    # 履歴データを照会
    ret, data = quote_ctx.get_macro_indicator_history(indicator_id=indicator_id, max_count=2)
    if ret == RET_OK:
        print(data)
    else:
        print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
  • Output
data_time         release_time   value predict_value  previous_value unit_type
0  2026-05-01  2026-06-11 20:34:01  0.0642           N/A          0.0566   PERCENT
1  2026-04-01  2026-05-13 20:31:01  0.0566           N/A          0.0427   PERCENT
1
2
3

API制限

  • 30秒以内に最大60回のリクエストが可能です
  • ページネーションリクエストは最初のページのみレート制限にカウントされます