Tài liệu tham khảo Blave API

Dữ liệu crypto và thị trường Đài Loan qua REST. 89 endpoint, một cặp khóa.

Cập nhật lần cuối 2026-10

Xác thực

https://api.blave.org — mọi đường dẫn bên dưới đều tương đối so với URL này.

api-key + secret-key trong mọi request (tạo key tại trang API key).

Python
import requests, osfrom dotenv import load_dotenvload_dotenv()headers = {    "api-key": os.getenv("blave_api_key"),    "secret-key": os.getenv("blave_secret_key"),}BASE_URL = "https://api.blave.org"

Quyền truy cập và gói

Những gì tài khoản của key cần có, theo từng endpoint (dòng «Quyền truy cập» trên trang, nguyên văn Access):

Giá trịÝ nghĩa
API plan or Blave Agent planKey hợp lệ, và gói của tài khoản bao gồm key đó — xem các quy tắc về key bên dưới. Không được bao gồm → 403 ERR007
Any valid keyChỉ cần key hợp lệ — không kiểm tra gói

Quy tắc về key:

  • Key do bạn tự tạo (trang API ở trên — loại mà script của riêng bạn và agent bên ngoài dùng bên ngoài Blave Agent) cần một gói API, kể cả khi tài khoản đã có gói Blave Agent hoặc bản dùng thử.
  • Key do Blave Agent cấp (key riêng của máy đám mây, key đăng nhập của ứng dụng máy tính) được bao gồm trong bản dùng thử khi thêm thẻ, một gói Blave Agent đang hoạt động (mọi bậc đều gồm dữ liệu) hoặc một gói API.
  • Không được bao gồm → 403 ERR007; message và next_steps của lỗi nêu rõ cách xử lý — hãy làm theo, đừng đoán giá.

Giới hạn tần suất

Trừ khi mục của endpoint ghi khác: 500 request / 5 phút cho mỗi API key, và 500 request / 5 phút cho mỗi IP. Cửa sổ được đặt lại sau 5 phút.

Lỗi

(các lỗi riêng của từng endpoint được liệt kê trong mục của endpoint đó):

Mã trạng tháiNội dung phản hồiTrường hợp
403{"error_code": "ERR005", "message": "API key and Secret key are required."}Thiếu header (các endpoint API plan or Blave Agent plan)
422{"error_code": "ERR001", "message": "Token is invalid or expired."}Thiếu header (các endpoint Any valid key)
403{"error_code": "ERR005", "message": "Invalid API key."} / "Invalid Secret key."Cặp key không đúng
403{"error_code": "ERR007", "message": "…", "next_steps": {…}}Tài khoản của key không được bao gồm (các quy tắc về key ở trên): key tự tạo mà không có gói API, hoặc key của Blave Agent mà không có gói hay bản dùng thử — message cho biết là trường hợp nào
429{"error_code": "ERR429", "message": "Rate limit exceeded."}Chạm giới hạn tần suất
500{"error": "Internal error"} hoặc một trang lỗi HTMLLỗi máy chủ không mong muốn

Dấu thời gian

Là UTC, trừ khi mục của endpoint ghi khác. Các trường date của thị trường Đài Loan là ngày giao dịch theo giờ Đài Bắc (YYYY-MM-DD).