Bảng giá Hướng dẫn

Giới hạn của gói miễn phí

Giới hạn miễn phí và trả phí, từ bảng gói của API

Gói miễn phí gồm 100 yêu cầu mỗi giờ, giá trực tiếp của 5 kim loại và tỷ giá. Mọi yêu cầu đều cần khóa API.

Gói miễn phí bao gồm

Giới hạn tính chung cho tất cả khóa của tài khoản. Gói miễn phí cho phép dùng thương mại nếu trang hiển thị giá có liên kết nhìn thấy được tới goldApi.dev.

FreeGiới hạn
Giá mỗi tháng$0
Yêu cầu mỗi giờ100
Giá giao ngayTrực tiếp
Kim loại5
Tỷ giá và tiền tệ khácCó
Lịch sử theo ngàyKhông
Nến OHLC theo ngàyKhông
Giá đóng cửa trước và biến động trong ngàyKhông
Dùng thương mạiCó, kèm liên kết nhìn thấy được tới goldApi.dev gần giá

Khi đạt giới hạn

Dùng các header phản hồi X-RateLimit-Limit, X-RateLimit-Remaining và X-RateLimit-Reset để giảm yêu cầu trước khi đạt giới hạn. Khi vượt quá, API trả về 429, một JSON ngắn và header Retry-After tính bằng giây. Yêu cầu hoạt động lại khi giờ tiếp theo bắt đầu.

Shell
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"
Trạng tháilỗiKhi nào
429rate_limit_exceededVượt số yêu cầu mỗi giờ của gói
401api_key_requiredYêu cầu không có khóa
401invalid_api_keyKhóa không hợp lệ
403feature_requires_basicGói không bao gồm endpoint này
Phản hồi
{ "error": "rate_limit_exceeded" }

Gói trả phí có nhiều yêu cầu và dữ liệu hơn.

Gói Basic

BasicGiới hạn
Giá mỗi tháng$8
Yêu cầu mỗi giờ2,000
Giá giao ngayTrực tiếp
Kim loại5
Tỷ giá và tiền tệ khácCó
Lịch sử theo ngàyCó
Nến OHLC theo ngàyKhông
Giá đóng cửa trước và biến động trong ngàyKhông
Dùng thương mạiCó, không cần liên kết

Gói Pro

ProGiới hạn
Giá mỗi tháng$15
Yêu cầu mỗi giờKhông giới hạn
Giá giao ngayTrực tiếp
Kim loại5
Tỷ giá và tiền tệ khácCó
Lịch sử theo ngàyCó
Nến OHLC theo ngàyCó
Giá đóng cửa trước và biến động trong ngàyCó
Dùng thương mạiCó, không cần liên kết

Chọn gói

Gói miễn phí phù hợp cho bản thử, bảng điều khiển nội bộ và trang cá nhân. Chọn gói trả phí nếu cần hơn 100 yêu cầu mỗi giờ, lịch sử theo ngày hoặc nến theo ngày.

Câu hỏi

Giới hạn yêu cầu của gói miễn phí là bao nhiêu?

100 yêu cầu mỗi giờ, tính chung cho tất cả khóa của tài khoản.

Tôi có thể dùng API mà không có khóa không?

Không. Mọi yêu cầu cần khóa của bạn trong header X-API-Key. Khóa miễn phí không cần thẻ tín dụng.

Tôi nhận phản hồi gì khi đạt giới hạn?

429, với lỗi rate_limit_exceeded và header Retry-After tính bằng giây.

Khi nào giới hạn được đặt lại?

Khi giờ tiếp theo bắt đầu. Header X-RateLimit-Reset cho biết thời điểm chính xác.

Gói miễn phí có được dùng thương mại không?

Có. Trang hiển thị giá phải có liên kết nhìn thấy được tới goldApi.dev. Gói trả phí không cần liên kết.

Đọc thêm

Bắt đầu với khóa API miễn phí

100 yêu cầu mỗi giờ trên gói miễn phí. Không cần thẻ tín dụng.

Lấy khóa miễn phí