API Hàng hóa & vĩ mô

2 endpoint · Hàng hóa · Vĩ mô

Cập nhật lần cuối 2026-10
URL gốc
https://api.blave.org
Xác thực
Gửi header api-key + secret-key trong mọi request
Quyền truy cập
API plan or Blave Agent plan
Giới hạn tần suất
500 request / 5 phút cho mỗi key và mỗi IP
Xác thực và lỗi Dữ liệu này gồm những gì: Dữ liệu crypto · Sự kiện vĩ mô

OHLCV hợp đồng tương lai CME / ICE

GET/studio/market/db/ohlcv/<dataset>/<symbol>/<schema>
Dữ liệu từ
2010-06-06
Tần suất cập nhật
Trễ ~4 giờ

Tham số

TênMô tảGiá trị hợp lệMặc định
dataset
string · pathBắt buộc
Bộ dữ liệu của sànGLBX.MDP3 (CME), IFEU.IMPACT (ICE)
symbol
string · pathBắt buộc
Hợp đồng liên tục tháng gần nhấtGLBX.MDP3: CL (dầu thô WTI), GC (vàng); IFEU.IMPACT: BRN (Brent)
schema
string · pathBắt buộc
Khung thời gian nếnohlcv-1d, ohlcv-1h, ohlcv-1m
start
string · query
Ngày bắt đầuYYYY-MM-DDend − khoảng tối đa của khung thời gian đó
end
string · query
Ngày cuối cùngYYYY-MM-DDhôm nay (UTC)

Khoảng tối đa mỗi request (end − start): ohlcv-1d 3650 ngày · ohlcv-1h 730 ngày · ohlcv-1m 31 ngày.

Ví dụ

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}, ...]

Phản hồi

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

TrườngKiểuĐơn vịMô tả
tsstringUTC ISOThời điểm mở nến
open / high / low / closefloatUSD (dầu thô: mỗi thùng; vàng: mỗi oz)Giá
volumeinthợp đồngKhối lượng
instrument_idint—Mã công cụ của upstream, giữ nguyên từ nến nguồn

Lỗi

Mã trạng tháiNội dung phản hồiTrường hợp
400{"error": "Invalid schema. Allowed: [...]"}Khung thời gian không hợp lệ
400{"error": "Invalid dataset/symbol combination"}Cặp không hợp lệ
400{"error": "Invalid date format. Use YYYY-MM-DD"}Ngày sai định dạng
400{"error": "date_range_too_large", "message": "...", "max_days": <n>}Khoảng thời gian vượt giới hạn
404thông báo lỗiKhông có dữ liệu

Ghi chú

  • Dữ liệu ~4 giờ gần nhất không khả dụng.
  • Với lịch sử ohlcv-1m dài, hãy request theo từng đoạn ≤ 31 ngày rồi nối lại (mỗi đoạn mất vài giây).

Lịch kinh tế

GET/studio/market/anue/economic_calendar
Quyền truy cập
Any valid key
Giới hạn tần suất
100 request / phút cho mỗi tài khoản
Dữ liệu từ
Cuốn chiếu: khoảng từ một tháng trước đến vài tuần tới
Tần suất cập nhật
Cache máy chủ 5 phút

Tham số

Tất cả đều tùy chọn; không lọc thì trả về toàn bộ feed (~1,400 dòng), nên hãy luôn lọc.

TênMô tảGiá trị hợp lệMặc định
start
string · query
Các sự kiện từ ngày này trở điYYYY-MM-DD (ngày theo giờ Đài Bắc)không có cận dưới
end
string · query
Các sự kiện đến hết ngày nàyYYYY-MM-DD (ngày theo giờ Đài Bắc)không có cận trên
country
string · query
Bộ lọc quốc giaMã ISO-2, phân tách bằng dấu phẩy, không phân biệt hoa thường — ví dụ US,CN,TWtất cả quốc gia
max_priority
int · query
Giữ các dòng có priority <= max_priority. 1 là quan trọng nhất, nên chỉ lấy sự kiện lớn = max_priority=11 / 2 / 3tất cả mức ưu tiên
limit
int · query
Sắp xếp theo thời gian sự kiện, rồi giữ N dòng đầu tiên≥ 1không giới hạn
lang
string · query
Ngôn ngữ hiển thị cho countryName / subject; những tên không có trong bảng tra của máy chủ được giữ nguyên, nên en trả về lẫn zh/enen / zhen

Ví dụ

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}, ...]

Phản hồi

Một mảng JSON trần (không bọc trong {"data": ...}). Thứ tự là thứ tự của chính feed, trừ khi đặt limit (khi đó sắp xếp theo startDate, time).

TrườngKiểuĐơn vịMô tả
startDateintgiây epochNgày theo lịch Đài Bắc của sự kiện
timestring | nullHH:MM giờ Đài BắcThời điểm công bố; null nếu chưa công bố
countryIdstringISO-2Mã quốc gia
countryNamestring—Tên quốc gia (theo lang)
subjectstring—Tên chỉ báo (theo lang)
subjectTitlestring—Nhãn kỳ, ví dụ <7月>, <2季>
predictnumber | nullunitDự báo đồng thuận của thị trường
lastnumber | nullunitGiá trị kỳ trước
realnumber | nullunitGiá trị thực tế; null cho đến khi công bố
unitstring—e.g. %, point, 億USD
priorityint1–31 = quan trọng nhất (bảng lương phi nông nghiệp, quyết định lãi suất), 3 = ít quan trọng nhất (số giàn khoan)

Một phản hồi thực tế còn mang các trường sau, được chuyển nguyên từ feed upstream. Chỉ nêu những gì đã quan sát được; đừng suy diễn thêm từ chúng.

TrườngKiểuQuan sát được
idintMã sự kiện của upstream, ví dụ 79382
dateintGiây epoch của kỳ mà số liệu phản ánh, không phải thời điểm công bố — các dòng có nhãn subjectTitle: "<9月>" mang date = 2026-09-01 trong khi startDate là 2026-09-23
dateUnitstringmonth
typeint2
areaIdstring"4"
placestring | nullnull
correctnumber | nullnull
correctMarkstring"N"

Lỗi

Mã trạng tháiNội dung phản hồiTrường hợp
400{"error": "Invalid date format. Use YYYY-MM-DD"}start / end sai định dạng
400{"error": "max_priority must be an integer"}max_priority không phải số nguyên
400{"error": "limit must be an integer"} / {"error": "limit must be >= 1"}limit không hợp lệ
429{"error_code": "ERR429", "message": "User rate limit exceeded"}Vượt 100 request / phút

Ghi chú

  • Khoảng nằm ngoài cửa sổ cuốn chiếu trả về 200 kèm [] — nghĩa là "không nằm trong phạm vi", không phải "không có sự kiện nào được lên lịch".
  • Khi đặt start / end, các sự kiện không có ngày bị loại; khi đặt max_priority, các sự kiện không có mức ưu tiên bị loại.
  • Đây là nguồn duy nhất cho các sự kiện vĩ mô và số liệu của chúng — không bao giờ thay bằng tìm kiếm web hay một giá trị nhớ sẵn. Các trang tổng hợp lịch kinh tế có bảng sai (có trang ghi giá trị thực tế đã công bố vào ô dự báo đồng thuận), và những trường mà trang không có sẽ bị điền bằng dữ liệu huấn luyện — giá trị kỳ trước, vốn chỉ có đúng một đáp án, đã từng bị ghi sai theo cách này. Nếu endpoint này không trả lời được, hãy nói rõ như vậy.
  • Cửa sổ là cuốn chiếu — khoảng một tháng trước cộng với vài tuần tới — không phải kho lưu trữ lịch sử.
  • real được điền sau khi công bố.