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.
| Free | Giới hạn |
|---|---|
| Giá mỗi tháng | $0 |
| Yêu cầu mỗi giờ | 100 |
| Giá giao ngay | Trực tiếp |
| Kim loại | 5 |
| Tỷ giá và tiền tệ khác | Có |
| Lịch sử theo ngày | Không |
| Nến OHLC theo ngày | Không |
| Giá đóng cửa trước và biến động trong ngày | Không |
| Dùng thương mại | Có, 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.
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \ -H "X-API-Key: $API_KEY"| Trạng thái | lỗi | Khi nào |
|---|---|---|
| 429 | rate_limit_exceeded | Vượt số yêu cầu mỗi giờ của gói |
| 401 | api_key_required | Yêu cầu không có khóa |
| 401 | invalid_api_key | Khóa không hợp lệ |
| 403 | feature_requires_basic | Gói không bao gồm endpoint này |
{ "error": "rate_limit_exceeded" }Giới hạn của gói trả phí
Gói trả phí có nhiều yêu cầu và dữ liệu hơn.
Gói Basic
| Basic | Giới hạn |
|---|---|
| Giá mỗi tháng | $8 |
| Yêu cầu mỗi giờ | 2,000 |
| Giá giao ngay | Trực tiếp |
| Kim loại | 5 |
| Tỷ giá và tiền tệ khác | Có |
| Lịch sử theo ngày | Có |
| Nến OHLC theo ngày | Không |
| Giá đóng cửa trước và biến động trong ngày | Không |
| Dùng thương mại | Có, không cần liên kết |
Gói Pro
| Pro | Giới hạn |
|---|---|
| Giá mỗi tháng | $15 |
| Yêu cầu mỗi giờ | Không giới hạn |
| Giá giao ngay | Trực tiếp |
| Kim loại | 5 |
| Tỷ giá và tiền tệ khác | Có |
| Lịch sử theo ngày | Có |
| Nến OHLC theo ngày | Có |
| Giá đóng cửa trước và biến động trong ngày | Có |
| Dùng thương mại | Có, 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.