GET /apiv2/billing/rate
Tỷ giá hiện tại của bạn: một TRX có giá trị bằng bao nhiêu theo loại tiền tệ trong hợp đồng của bạn. Mỗi tài khoản có một loại tiền tệ hợp đồng riêng, vì vậy cặp tiền tệ và tỷ giá là của riêng bạn. Sử dụng tỷ giá này để đối chiếu số tiền trong hồ sơ ghi chép của riêng bạn. Là một phần của thanh toán trả sau.
URL của Endpoint
GET https://netts.io/apiv2/billing/rateHeaders của yêu cầu
| Header | Bắt buộc | Mô tả |
|---|---|---|
X-API-KEY | có | Khóa API với quyền billing.read |
X-Real-IP | có | Một địa chỉ IP từ danh sách trắng của khóa |
Yêu cầu không có tham số. Loại tiền tệ được lấy từ hợp đồng của bạn.
Ví dụ
bash
curl -s 'https://netts.io/apiv2/billing/rate' \
-H 'X-API-KEY: your-api-key' \
-H 'X-Real-IP: 203.0.113.10'json
{
"success": true,
"data": {
"asset": "<currency of your contract>",
"pair": "TRX/<currency of your contract>",
"rate": "0.331515333133553092",
"at": "2026-10-20T05:52:15.915512+00:00"
},
"timestamp": "2026-10-20T05:52:20+00:00"
}Các trường phản hồi
| Trường | Mô tả |
|---|---|
asset | loại tiền tệ trong hợp đồng của bạn, giống như trong settlement.asset ở tài khoản |
pair | TRX/ và loại tiền tệ trong hợp đồng của bạn |
rate | một TRX có giá trị bằng bao nhiêu theo loại tiền tệ trong hợp đồng của bạn, một chuỗi số thập phân có 18 chữ số sau dấu phẩy |
at | thời điểm tính tỷ giá, UTC; null khi loại tiền tệ trong hợp đồng của bạn là TRX |
Nếu loại tiền tệ trong hợp đồng của bạn là TRX, rate là "1".
Tỷ giá sẽ thay đổi theo thời gian. Đây là tỷ giá tại thời điểm của at, không phải là cam kết về tỷ giá cho đơn hàng trong tương lai: một khoản phí đã được ghi nhận sẽ giữ nguyên tỷ giá tại thời điểm phát sinh — xem tỷ giá hối đoái đã ghi nhận.
Lỗi
| HTTP | code | Ý nghĩa |
|---|---|---|
| 401 | -1, -2 | khóa bị thiếu hoặc không hợp lệ, hoặc IP không nằm trong danh sách trắng — phản hồi từ cổng API, xem định dạng phản hồi |
| 403 | billing_read_required | khóa không có quyền billing.read |
| 403 | postpaid_required | tài khoản không có thanh toán trả sau |
| 503 | rate_unavailable | tỷ giá tạm thời không khả dụng — vui lòng thử lại sau |
Tất cả các mã đều được liệt kê trong thanh toán trả sau.