商品先物・マクロ API

2 個のエンドポイント · 商品先物 · マクロ

最終更新 2026-10
ベース URL
https://api.blave.org
認証
すべてのリクエストに api-key と secret-key ヘッダーを付ける
アクセス
API plan or Blave Agent plan
レート制限
キーごと・IP ごとに 5 分間 500 リクエスト
認証とエラー このデータの範囲： 暗号資産データ · マクロイベント

CME／ICE 先物 OHLCV

GET/studio/market/db/ohlcv/<dataset>/<symbol>/<schema>
データ開始
2010-06-06
更新頻度
約 4 時間の遅延

パラメータ

名称説明許容値デフォルト
dataset
string · path必須
取引所のデータセットGLBX.MDP3（CME）、IFEU.IMPACT（ICE）
symbol
string · path必須
期近のつなぎ足GLBX.MDP3：CL（WTI 原油）、GC（金）。IFEU.IMPACT：BRN（ブレント原油）
schema
string · path必須
時間足ohlcv-1d, ohlcv-1h, ohlcv-1m
start
string · query
開始日YYYY-MM-DDend − その時間足の最大範囲
end
string · query
終了日YYYY-MM-DD今日（UTC）

リクエストあたりの最大範囲（end − start）：ohlcv-1d 3650 日 · ohlcv-1h 730 日 · ohlcv-1m 31 日。

例

Python
data = requests.get(f"{BASE_URL}/studio/market/db/ohlcv/GLBX.MDP3/CL/ohlcv-1d", headers=headers,                    params={"start": "2024-01-01", "end": "2024-12-31"}, timeout=60).json()["data"]# [{"ts": "2024-01-02 00:00:00+00:00", "open": 71.95, "high": 73.64, "low": 70.06, "close": 70.5,#   "volume": 263594, "instrument_id": 686071},#  {"ts": "2024-01-03 00:00:00+00:00", "open": 70.49, "high": 73.23, "low": 69.28, "close": 73.05,#   "volume": 253755, "instrument_id": 686071}, ...]

レスポンス

{"dataset", "symbol", "schema", "data": [...]}.

フィールド型単位説明
tsstringUTC の ISO 形式足の開始時刻
open / high / low / closefloatUSD（原油：バレルあたり、金：オンスあたり）価格
volumeint枚数量
instrument_idint—元の足に付いているアップストリームの銘柄 ID をそのまま返します

エラー

ステータスレスポンスボディ条件
400{"error": "Invalid schema. Allowed: [...]"}時間足が不正
400{"error": "Invalid dataset/symbol combination"}組み合わせが不正
400{"error": "Invalid date format. Use YYYY-MM-DD"}日付の形式が不正
400{"error": "date_range_too_large", "message": "...", "max_days": <n>}範囲が上限を超過
404エラーメッセージデータなし

備考

  • 直近の約 4 時間分は取得できません。
  • 長期間の ohlcv-1m の履歴は、≤ 31 日ごとに分けてリクエストし、結合してください（一回あたり数秒かかります）。

経済カレンダー

GET/studio/market/anue/economic_calendar
アクセス
Any valid key
レート制限
アカウントごとに 100 リクエスト／分
データ開始
ローリング：過去約一か月から今後数週間まで
更新頻度
サーバーキャッシュ 5 分

パラメータ

すべて任意です。絞り込まないとフィード全体（約 1,400 行）が返るため、必ず絞り込んでください。

名称説明許容値デフォルト
start
string · query
この日付以降のイベントYYYY-MM-DD（台北時間の日付）下限なし
end
string · query
この日付以前のイベントYYYY-MM-DD（台北時間の日付）上限なし
country
string · query
国による絞り込みISO-2 コード、カンマ区切り、大文字・小文字を区別しません。例：US,CN,TWすべての国
max_priority
int · query
priority <= max_priority のものだけを残します。1 が最も重要なので、大きなイベントだけなら max_priority=1 です1 / 2 / 3すべての優先度
limit
int · query
イベント時刻でソートし、先頭の N 件を残します≥ 1上限なし
lang
string · query
countryName／subject の表示言語。サーバーの対照表にない名称はそのまま残るため、en では中国語と英語が混ざった結果が返りますen / zhen

例

Python
params = {"start": "2026-09-16", "end": "2026-09-23", "max_priority": 1, "lang": "zh"}response = requests.get(    f"{BASE_URL}/studio/market/anue/economic_calendar",    headers=headers, params=params, timeout=60,)data = response.json()# [{"id": 79382, "startDate": 1790121600, "date": 1788220800, "dateUnit": "month", "time": "16:30",#   "countryId": "GB", "countryName": "英國", "areaId": "4",#   "subject": "S&P Global Manufacturing PMI - 初值", "subjectTitle": "<9月>", "unit": "point",#   "predict": 51.7, "last": 51.7, "real": None, "correct": None, "correctMark": "N",#   "place": None, "priority": 1, "type": 2}, ...]

レスポンス

JSON 配列をそのまま返します（{"data": ...} で包みません）。順序はフィードの順序のままですが、limit を指定した場合は startDate、time でソートされます。

フィールド型単位説明
startDateintエポック秒イベントの台北時間での日付
timestring | nullHH:MM 台北時間発表時刻。未公表の場合は null
countryIdstringISO-2国コード
countryNamestring—国名（lang に従います）
subjectstring—指標名（lang に従います）
subjectTitlestring—対象期間のラベル。例：<7月>、<2季>
predictnumber | nullunit市場予想
lastnumber | nullunit前回値
realnumber | nullunit実績値。発表までは null
unitstring—e.g. %, point, 億USD
priorityint1–31 = 最も重要（非農業部門雇用者数、政策金利の決定）、3 = 最も重要度が低い（リグ稼働数）

実際のレスポンスには、アップストリームのフィードからそのまま渡された次のフィールドも含まれていました。ここに書いているのは観測された内容だけです。それ以上の意味を読み取らないでください。

フィールド型観測された内容
idintアップストリームのイベント ID。例：79382
dateint発表時刻ではなく、数値の対象期間を表すエポック秒です。subjectTitle: "<9月>" の行では、date = 2026-09-01、startDate は 2026-09-23 でした
dateUnitstringmonth
typeint2
areaIdstring"4"
placestring | nullnull
correctnumber | nullnull
correctMarkstring"N"

エラー

ステータスレスポンスボディ条件
400{"error": "Invalid date format. Use YYYY-MM-DD"}start／end の形式が不正
400{"error": "max_priority must be an integer"}max_priority が整数でない
400{"error": "limit must be an integer"} / {"error": "limit must be >= 1"}limit が不正
429{"error_code": "ERR429", "message": "User rate limit exceeded"}100 リクエスト／分を超過

備考

  • ローリング期間の外にある範囲は 200 と [] を返します。これは「対象外」という意味で、「予定されたイベントがない」という意味ではありません。
  • start／end を指定すると、日付のないイベントは除外されます。max_priority を指定すると、優先度のないイベントは除外されます。
  • マクロイベントとその数値の情報源はこれだけです。ウェブ検索や記憶している値で代用しないでください。カレンダーの集約サイトには誤った表が載ることがあり（公表済みの実績値を市場予想として掲載していた例があります）、ページにないフィールドは学習データで埋められてしまいます。正解が一つしかない前回値が、こうして誤って書かれたことがあります。このエンドポイントで答えられない場合は、そのように伝えてください。
  • 期間はローリングで、おおよそ過去一か月と今後数週間です。履歴のアーカイブではありません。
  • real は発表後に入ります。