Lấy số dư

Trả về số dư USD hiện tại của tài khoản đã xác thực.

Lấy số dư

GET /v1/balance

curl -X GET "https://api.zelnum.com/api/v1/balance" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "balance": "5.230000"
}

Trường	Kiểu	Mô tả
balance	string	Số dư khả dụng tính bằng USD, cố định 6 chữ số thập phân.

Ghi chú

Số dư được trả về dưới dạng chuỗi, không phải số JSON, để không mất độ chính xác trước khi tính toán.

Thông tin khóa

Trả về siêu dữ liệu của khóa đã dùng trong yêu cầu. Khóa bí mật không bao giờ được trả về — chỉ tiền tố đã che — để bạn biết yêu cầu dùng khóa nào mà không lộ thông tin xác thực.

GET /v1/api-key

curl -X GET "https://api.zelnum.com/api/v1/api-key" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "api_key_id": 12,
  "masked_key": "ck_xxxxxxxxx…****",
  "last_used": "2026-09-12T09:14:03.000000Z",
  "created_at": "2026-08-30T11:02:44.000000Z"
}

Trường	Kiểu	Mô tả
api_key_id	integer	Mã định danh của khóa — hữu ích khi liên hệ hỗ trợ.
masked_key	string	Tiền tố đã che. Khóa dạng rõ không bao giờ được trả về ở đây.
last_used	string | null	Thời điểm yêu cầu xác thực gần nhất bằng khóa này.
created_at	string	Thời điểm khóa được tạo.

Yêu cầu API bị giới hạn theo khóa API và theo nhóm endpoint:

Endpoint	Giới hạn
GET /v1/balance · GET /v1/api-key	60 yêu cầu / phút cho mỗi API key (120 / phút cho mỗi IP)

Lỗi

Trạng thái	code	Nguyên nhân
401	unauthorized	Khóa API thiếu, không hợp lệ hoặc đã bị vô hiệu hóa.
403	account_banned	Tài khoản bị tạm ngưng. Vui lòng liên hệ hỗ trợ.
429	—	Đã đạt giới hạn yêu cầu — xem Giới hạn tốc độ.

Cả hai endpoint dùng chung nhóm chung: 60 yêu cầu / phút cho mỗi khóa API.