GET /apiv2/prices Deprecated

Deprecated

Endpoint này đã lỗi thời và sẽ bị xóa trong một bản phát hành tương lai. Vui lòng chuyển sang endpoint GET /apiv2/pricing mới, nơi cung cấp các khoảng thời gian động, lọc dịch vụ, giảm giá theo thời hạn và định dạng phản hồi thống nhất.

Lấy giá thuê Energy hiện tại cho các khoảng thời gian khác nhau trong ngày.

Giá có thể thay đổi trong quá trình thực hiện

Giá được trả về bởi endpoint này có thể thay đổi trong khi đơn hàng đang được xử lý. Một nhà cung cấp Energy có thể từ chối yêu cầu ủy quyền, trong trường hợp đó Netts sẽ tự động định tuyến đơn hàng đến nhà cung cấp khả dụng tiếp theo. Netts cam kết không chỉ cung cấp mức giá cạnh tranh nhất mà còn đảm bảo nguồn cung cấp Energy đáng tin cậy — do đó đơn hàng có thể được hoàn thành ở mức giá cao hơn mức giá đã báo. Điều này chỉ áp dụng cho các đơn hàng từ 300.000 đơn vị Energy trở lên.

URL Endpoint

GET https://netts.io/apiv2/prices

Tiêu đề Yêu cầu

Tiêu đề	Bắt buộc	Mô tả	Giá trị
X-API-KEY	Có	Khóa API của bạn	string
X-Real-IP	Có	Địa chỉ IP từ danh sách trắng	Địa chỉ IP
X-Format	Không	Định dạng phản hồi (mặc định: JSON mở rộng)	`now`, `compact`, `short`, `short1h`, `count`

Tham số Yêu cầu

Không yêu cầu tham số - trả về tất cả thông tin giá hiện tại.

Yêu cầu Mẫu

cURL

bash

curl -X GET https://netts.io/apiv2/prices \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip"

Python

python

import requests

url = "https://netts.io/apiv2/prices"
headers = {
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

response = requests.get(url, headers=headers)
data = response.json()

if response.status_code == 200:
    print(f"Status: {data.get('status')}")
    print(f"Current UTC time: {data.get('current_utc_time')}")
    print(f"Active period: {data.get('active_period')}")
    print(f"Host price: {data.get('host_price')} TRX")
    
    print("\nPrice periods:")
    for period in data.get('periods', []):
        is_active = period.get('is_active', False)
        active_marker = " *ACTIVE*" if is_active else ""
        print(f"\n{period.get('label')}{active_marker}:")
        print(f"  Time: {period.get('period')}")
        
        prices = period.get('prices', {})
        print(f"  < 200k energy: {prices.get('less_than_200k', {}).get('price_sun')} sun")
        print(f"  = 131k energy: {prices.get('equal_131k', {}).get('price_sun')} sun")  
        print(f"  > 200k energy: {prices.get('more_than_200k', {}).get('price_sun')} sun")
else:
    print(f"Error: {data.get('message', 'Unknown error')}")

Định dạng Phản hồi Thu gọn

Mới trong v2.1: Sử dụng tiêu đề X-Format để nhận phản hồi dạng văn bản thu gọn thay vì cấu trúc JSON đầy đủ.

Khi nào nên Sử dụng

Tích hợp với các hệ thống giám sát
Hiển thị giá đơn giản
Theo dõi giá tự động
Yêu cầu băng thông tối thiểu

Yêu cầu Mẫu

bash

curl -X GET https://netts.io/apiv2/prices \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -H "X-Format: now"

Ví dụ Phản hồi Thu gọn

text

Daytime Hours (11:00-21:00 UTC): price=27 sun, 65k=1.755 TRX (0.52$), 131k=3.537 TRX (1.05$), 1m=27.000 TRX (7.99$)

Giải thích Định dạng Phản hồi

Định dạng thu gọn cung cấp:

Thành phần	Mô tả	Ví dụ
Nhãn khoảng thời gian	Khoảng thời gian định giá đang hoạt động	`Daytime Hours (11:00-21:00 UTC)`
price=X sun	Giá mỗi đơn vị Energy tính bằng SUN	`price=27 sun`
65k=X.XXX TRX (X.XX$)	Chi phí cho 65.000 đơn vị Energy	`65k=1.755 TRX (0.52$)`
131k=X.XXX TRX (X.XX$)	Chi phí cho 131.000 đơn vị Energy	`131k=3.537 TRX (1.05$)`
1m=X.XXX TRX (X.XX$)	Chi phí cho 1.000.000 đơn vị Energy	`1m=27.000 TRX (7.99$)`

Công thức Tính toán

TRX cost = (price_sun / 1,000,000) × energy_amount
USD cost = TRX_cost × current_TRX_USD_rate

Lưu ý: Tỷ giá hối đoái TRX/USD được lấy từ bảng chain_param và được lưu vào bộ nhớ cache trong 30 phút.

Loại Nội dung

Định dạng mở rộng: application/json
Định dạng thu gọn: text/plain

Ví dụ Python

python

import requests

url = "https://netts.io/apiv2/prices"
headers = {
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip",
    "X-Format": "now"  # Request compact format
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print("Compact price data:")
    print(response.text)
    # Output: Daytime Hours (11:00-21:00 UTC): price=27 sun, 65k=1.755 TRX (0.52$), ...
else:
    print(f"Error: {response.status_code}")

Định dạng Phản hồi Siêu Thu gọn (short1h)

Mới trong v2.2: Sử dụng tiêu đề X-Format: short1h để nhận phản hồi dạng văn bản siêu thu gọn chỉ có các phép tính Energy, không có nhãn khoảng thời gian và giá trên mỗi đơn vị.

Khi nào nên Sử dụng

Bảng điều khiển giám sát có không gian hạn chế
Ứng dụng di động
Yêu cầu băng thông tối thiểu
Chỉ tập trung vào chi phí cuối cùng

Yêu cầu Mẫu

bash

curl -X GET https://netts.io/apiv2/prices \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -H "X-Format: short1h"

Ví dụ Phản hồi Siêu Thu gọn

text

65k=1.755 TRX (0.52$), 131k=3.537 TRX (1.05$), 1m=27.000 TRX (7.99$)

Giải thích Định dạng Phản hồi

Định dạng siêu thu gọn chỉ cung cấp các phép tính chi phí thiết yếu:

Thành phần	Mô tả	Ví dụ
65k=X.XXX TRX (X.XX$)	Chi phí cho 65.000 đơn vị Energy	`65k=1.755 TRX (0.52$)`
131k=X.XXX TRX (X.XX$)	Chi phí cho 131.000 đơn vị Energy	`131k=3.537 TRX (1.05$)`
1m=X.XXX TRX (X.XX$)	Chi phí cho 1.000.000 đơn vị Energy	`1m=27.000 TRX (7.99$)`

Lưu ý: Định dạng này loại trừ nhãn khoảng thời gian và giá trên mỗi đơn vị Energy để đạt được sự tối giản tối đa.

Loại Nội dung

Định dạng siêu thu gọn: text/plain

Ví dụ Python

python

import requests

url = "https://netts.io/apiv2/prices"
headers = {
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip",
    "X-Format": "short1h"  # Request ultra-compact format
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print("Ultra-compact price data:")
    print(response.text)
    # Output: 65k=1.755 TRX (0.52$), 131k=3.537 TRX (1.05$), 1m=27.000 TRX (7.99$)
else:
    print(f"Error: {response.status_code}")

Định dạng Phản hồi Số lượng (count)

Mới trong v2.3: Sử dụng tiêu đề X-Format: count để nhận các phép tính giá cho đơn hàng số lượng lớn hiển thị chi phí cho 1, 2, 3, 5, 10 và 20 đơn hàng.

Khi nào nên Sử dụng

Hiển thị giá đơn hàng số lượng lớn
Công cụ tính toán giảm giá theo số lượng
Công cụ so sánh giá
Lập kế hoạch số lượng đơn hàng
Ước tính chi phí cho nhiều đơn hàng

Yêu cầu Mẫu

bash

curl -X GET https://netts.io/apiv2/prices \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -H "X-Format: count"

Ví dụ Phản hồi Số lượng

text

1-1.690 TRX (0.50$), 2-3.380 TRX (1.00$), 3-5.070 TRX (1.50$), 5-8.450 TRX (2.50$), 10-16.900 TRX (5.00$), 20-33.800 TRX (10.00$)

Giải thích Định dạng Phản hồi

Định dạng số lượng cung cấp giá đã tính toán cho các số lượng đơn hàng khác nhau:

Thành phần	Mô tả	Ví dụ
1-X.XXX TRX (X.XX$)	Chi phí cho 1 đơn hàng (65.000 đơn vị Energy)	`1-1.690 TRX (0.50$)`
2-X.XXX TRX (X.XX$)	Chi phí cho 2 đơn hàng (131.000 đơn vị Energy)	`2-3.380 TRX (1.00$)`
3-X.XXX TRX (X.XX$)	Chi phí cho 3 đơn hàng (3 × 65.000 Energy)	`3-5.070 TRX (1.50$)`
5-X.XXX TRX (X.XX$)	Chi phí cho 5 đơn hàng (5 × 65.000 Energy)	`5-8.450 TRX (2.50$)`
10-X.XXX TRX (X.XX$)	Chi phí cho 10 đơn hàng (10 × 65.000 Energy)	`10-16.900 TRX (5.00$)`
20-X.XXX TRX (X.XX$)	Chi phí cho 20 đơn hàng (20 × 65.000 Energy)	`20-33.800 TRX (10.00$)`

Công thức Tính toán

1 order:  TRX cost = (price_sun_65k / 1,000,000) × 65,000
2 orders: TRX cost = (price_sun_131k / 1,000,000) × 131,000
3+ orders: TRX cost = (price_sun_65k / 1,000,000) × 65,000 × quantity
USD cost = TRX_cost × current_TRX_USD_rate

Lưu ý: Tỷ giá hối đoái TRX/USD được lấy từ bảng chain_param và được lưu vào bộ nhớ cache trong 30 phút.

Loại Nội dung

Định dạng số lượng: text/plain

Ví dụ Python

python

import requests

url = "https://netts.io/apiv2/prices"
headers = {
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip",
    "X-Format": "count"  # Request count format
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print("Bulk order pricing:")
    print(response.text)
    # Output: 1-1.690 TRX (0.50$), 2-3.380 TRX (1.00$), 3-5.070 TRX (1.50$), ...
else:
    print(f"Error: {response.status_code}")

Phản hồi

Phản hồi Thành công (200 OK)

json

{
    "status": "success",
    "current_utc_time": "2025-09-02 06:50:39",
    "current_utc_hour": 6,
    "active_period": "05:00-07:00",
    "last_update": "2025-09-02 08:05:03",
    "host_price": 2.989,
    "periods": [
        {
            "label": "Early Morning Hours (05:00-07:00 UTC)",
            "period": "05:00-07:00",
            "is_active": true,
            "prices": {
                "less_than_200k": {
                    "price_sun": 17
                },
                "equal_131k": {
                    "price_sun": 17
                },
                "more_than_200k": {
                    "price_sun": 17
                }
            }
        },
        {
            "label": "Morning Hours (07:00-11:00 UTC)",
            "period": "07:00-11:00",
            "is_active": false,
            "prices": {
                "less_than_200k": {
                    "price_sun": 17
                },
                "equal_131k": {
                    "price_sun": 17
                },
                "more_than_200k": {
                    "price_sun": 17
                }
            }
        }
    ]
}

Các Trường Phản hồi

Trường	Loại	Mô tả
status	string	Luôn là "success" đối với các yêu cầu thành công
current_utc_time	string	Thời gian máy chủ hiện tại theo UTC
current_utc_hour	integer	Giờ UTC hiện tại (0-23)
active_period	string	Khoảng thời gian định giá đang hoạt động
last_update	string	Lần cuối cùng giá được cập nhật
host_price	number	Giá host hiện tại tính bằng TRX
periods	array	Mảng chứa tất cả các khoảng thời gian định giá
periods[].label	string	Tên khoảng thời gian dễ đọc cho người dùng
periods[].period	string	Phạm vi thời gian (HH:MM-HH:MM)
periods[].is_active	boolean	Khoảng thời gian này hiện có đang hoạt động hay không
periods[].prices.less_than_200k.price_sun	integer	Giá tính bằng SUN cho Energy < 200.000 đơn vị
periods[].prices.equal_131k.price_sun	integer	Giá tính bằng SUN cho chính xác 131.000 đơn vị
periods[].prices.more_than_200k.price_sun	integer	Giá tính bằng SUN cho Energy > 200.000 đơn vị

Phân loại Lượng Energy

Danh mục	Mô tả	Phạm vi Energy
less_than_200k	Đơn hàng nhỏ	< 200.000 đơn vị Energy
equal_131k	Đơn hàng tiêu chuẩn	Chính xác 131.000 đơn vị Energy
more_than_200k	Đơn hàng lớn	> 200.000 đơn vị Energy

Khoảng Thời gian

API trả về giá cho 5 khoảng thời gian khác nhau:

Khoảng thời gian	Phạm vi Thời gian (UTC)	Mô tả
Early Morning	05:00-07:00	Khoảng thời gian nhu cầu thấp
Morning	07:00-11:00	Bắt đầu giờ làm việc
Daytime	11:00-21:00	Giờ làm việc cao điểm
Evening	21:00-23:00	Hoạt động buổi tối
Night	23:00-05:00	Khoảng thời gian nhu cầu thấp nhất

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

Các giới hạn tần suất sau đây áp dụng cho endpoint này (trên mỗi địa chỉ IP):

Khoảng thời gian	Giới hạn	Mô tả
1 phút	1 yêu cầu	Tối đa 1 yêu cầu mỗi phút
1 giờ	60 yêu cầu	Tối đa 60 yêu cầu mỗi giờ

Tiêu đề Giới hạn Tần suất

http

RateLimit-Limit: 1
RateLimit-Remaining: 0
RateLimit-Reset: 21
X-RateLimit-Limit-Minute: 1
X-RateLimit-Remaining-Minute: 0
X-RateLimit-Limit-Hour: 60
X-RateLimit-Remaining-Hour: 59
Retry-After: 21

Vượt quá Giới hạn Tần suất (429)

json

{
    "message": "API rate limit exceeded"
}

Phản hồi Lỗi

Lỗi Xác thực (401)

json

{
    "status": "error",
    "code": 401,
    "message": "Invalid API key or IP not in whitelist"
}

Lỗi Máy chủ Nội bộ (500)

json

{
    "status": "error",
    "message": "Internal server error"
}

Ghi chú

Không yêu cầu body của yêu cầu - đây là một yêu cầu GET
Tất cả giá đều tính bằng SUN (1 TRX = 1.000.000 SUN)
Giá thay đổi tùy theo lượng Energy và thời gian trong ngày (UTC)
Khoảng thời gian hoạt động: Thay đổi trong suốt cả ngày dựa trên nhu cầu
Giới hạn tần suất: Các giới hạn nghiêm ngặt do hoạt động sử dụng nhiều cơ sở dữ liệu
Cập nhật giá: Giá được làm mới định kỳ từ cơ sở dữ liệu
Múi giờ: Tất cả thời gian đều tính theo UTC

GET /apiv2/prices Deprecated ​

URL Endpoint ​

Tiêu đề Yêu cầu ​

Tham số Yêu cầu ​

Yêu cầu Mẫu ​

cURL ​

Python ​

Định dạng Phản hồi Thu gọn ​

Khi nào nên Sử dụng ​

Yêu cầu Mẫu ​

Ví dụ Phản hồi Thu gọn ​

Giải thích Định dạng Phản hồi ​

Công thức Tính toán ​

Loại Nội dung ​

Ví dụ Python ​

Định dạng Phản hồi Siêu Thu gọn (short1h) ​

Khi nào nên Sử dụng ​

Yêu cầu Mẫu ​

Ví dụ Phản hồi Siêu Thu gọn ​

Giải thích Định dạng Phản hồi ​

Loại Nội dung ​

Ví dụ Python ​

Định dạng Phản hồi Số lượng (count) ​

Khi nào nên Sử dụng ​

Yêu cầu Mẫu ​

Ví dụ Phản hồi Số lượng ​

Giải thích Định dạng Phản hồi ​

Công thức Tính toán ​

Loại Nội dung ​

Ví dụ Python ​

Phản hồi ​

Phản hồi Thành công (200 OK) ​

Các Trường Phản hồi ​

Phân loại Lượng Energy ​

Khoảng Thời gian ​

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

Tiêu đề Giới hạn Tần suất ​

Vượt quá Giới hạn Tần suất (429) ​

Phản hồi Lỗi ​

Lỗi Xác thực (401) ​

Lỗi Máy chủ Nội bộ (500) ​

Ghi chú ​

GET /apiv2/prices Deprecated

URL Endpoint

Tiêu đề Yêu cầu

Tham số Yêu cầu

Yêu cầu Mẫu

cURL

Python

Định dạng Phản hồi Thu gọn

Khi nào nên Sử dụng

Yêu cầu Mẫu

Ví dụ Phản hồi Thu gọn

Giải thích Định dạng Phản hồi

Công thức Tính toán

Loại Nội dung

Ví dụ Python

Định dạng Phản hồi Siêu Thu gọn (short1h)

Khi nào nên Sử dụng

Yêu cầu Mẫu

Ví dụ Phản hồi Siêu Thu gọn

Giải thích Định dạng Phản hồi

Loại Nội dung

Ví dụ Python

Định dạng Phản hồi Số lượng (count)

Khi nào nên Sử dụng

Yêu cầu Mẫu

Ví dụ Phản hồi Số lượng

Giải thích Định dạng Phản hồi

Công thức Tính toán

Loại Nội dung

Ví dụ Python

Phản hồi

Phản hồi Thành công (200 OK)

Các Trường Phản hồi

Phân loại Lượng Energy

Khoảng Thời gian

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

Tiêu đề Giới hạn Tần suất

Vượt quá Giới hạn Tần suất (429)

Phản hồi Lỗi

Lỗi Xác thực (401)

Lỗi Máy chủ Nội bộ (500)

Ghi chú