GET /apiv2/prices 已废弃

已废弃

此端点已废弃，并将在未来的版本中移除。请迁移至新的 GET /apiv2/pricing 端点，该端点提供动态时段、服务筛选、时长折扣以及统一的响应格式。

获取全天不同时间段当前的 Energy 租赁价格。

价格可能会在履约过程中变动

此端点返回的价格可能会在订单处理期间发生变化。Energy 提供商可能会拒绝代理请求，在这种情况下，Netts 会自动将订单路由至下一个可用的提供商。Netts 不仅致力于提供最具竞争力的价格，还致力于确保可靠的 Energy 供应——因此订单的履约价格可能会高于报价。这仅适用于 300,000 Energy 单位及以上的订单。

端点 URL

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

请求标头

标头	必填	说明	值
X-API-KEY	是	您的 API 密钥	string
X-Real-IP	是	来自白名单的 IP 地址	IP 地址
X-Format	否	响应格式（默认：扩展 JSON）	`now`、`compact`、`short`、`short1h`、`count`

请求参数

无需参数 - 返回所有当前定价信息。

请求示例

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')}")

紧凑响应格式

v2.1 新增：使用 X-Format 标头以获取紧凑的文本响应，而非完整的 JSON 结构。

适用场景

与监控系统集成
简单的价格显示
自动化价格跟踪
极低的 Bandwidth 需求

请求示例

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"

紧凑响应示例

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$)

响应格式说明

紧凑格式提供：

组成部分	说明	示例
Period label	当前生效的定价时段	`Daytime Hours (11:00-21:00 UTC)`
price=X sun	每单位 Energy 的 SUN 价格	`price=27 sun`
65k=X.XXX TRX (X.XX$)	65,000 Energy 单位的费用	`65k=1.755 TRX (0.52$)`
131k=X.XXX TRX (X.XX$)	131,000 Energy 单位的费用	`131k=3.537 TRX (1.05$)`
1m=X.XXX TRX (X.XX$)	1,000,000 Energy 单位的费用	`1m=27.000 TRX (7.99$)`

计算公式

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

注意：TRX/USD 汇率从 chain_param 表中获取并缓存 30 分钟。

内容类型

扩展格式：application/json
紧凑格式：text/plain

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}")

超紧凑响应格式 (short1h)

v2.2 新增：使用 X-Format: short1h 标头以获取仅包含 Energy 计算结果的超紧凑文本响应，不包含时段标签和单价。

适用场景

空间有限的监控仪表板
移动端应用程序
极低的 Bandwidth 需求
仅关注最终费用

请求示例

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"

超紧凑响应示例

text

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

响应格式说明

超紧凑格式仅提供核心费用计算：

组成部分	说明	示例
65k=X.XXX TRX (X.XX$)	65,000 Energy 单位的费用	`65k=1.755 TRX (0.52$)`
131k=X.XXX TRX (X.XX$)	131,000 Energy 单位的费用	`131k=3.537 TRX (1.05$)`
1m=X.XXX TRX (X.XX$)	1,000,000 Energy 单位的费用	`1m=27.000 TRX (7.99$)`

注意：此格式省略了时段标签和每单位 Energy 的价格，以实现最大程度的紧凑性。

内容类型

超紧凑格式：text/plain

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}")

计数响应格式 (count)

v2.3 新增：使用 X-Format: count 标头以获取批量订单定价计算，显示 1、2、3、5、10 和 20 笔订单的费用。

适用场景

批量订单定价展示
数量折扣计算器
价格对比工具
订单数量规划
多笔订单的成本估算

请求示例

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"

计数响应示例

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$)

响应格式说明

计数格式提供针对不同订单数量的计算价格：

组成部分	说明	示例
1-X.XXX TRX (X.XX$)	1 笔订单的费用（65,000 Energy 单位）	`1-1.690 TRX (0.50$)`
2-X.XXX TRX (X.XX$)	2 笔订单的费用（131,000 Energy 单位）	`2-3.380 TRX (1.00$)`
3-X.XXX TRX (X.XX$)	3 笔订单的费用（3 × 65,000 Energy）	`3-5.070 TRX (1.50$)`
5-X.XXX TRX (X.XX$)	5 笔订单的费用（5 × 65,000 Energy）	`5-8.450 TRX (2.50$)`
10-X.XXX TRX (X.XX$)	10 笔订单的费用（10 × 65,000 Energy）	`10-16.900 TRX (5.00$)`
20-X.XXX TRX (X.XX$)	20 笔订单的费用（20 × 65,000 Energy）	`20-33.800 TRX (10.00$)`

计算公式

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

注意：TRX/USD 汇率从 chain_param 表中获取并缓存 30 分钟。

内容类型

计数格式：text/plain

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}")

响应

成功响应 (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
                }
            }
        }
    ]
}

响应字段

字段	类型	说明
status	string	成功请求时始终为 "success"
current_utc_time	string	服务器当前 UTC 时间
current_utc_hour	integer	当前 UTC 小时 (0-23)
active_period	string	当前生效的定价时段
last_update	string	上次价格更新时间
host_price	number	当前 Host 价格（单位：TRX）
periods	array	包含所有定价时段的数组
periods[].label	string	人类可读的时段名称
periods[].period	string	时间范围 (HH:MM-HH:MM)
periods[].is_active	boolean	此时间段当前是否处于激活状态
periods[].prices.less_than_200k.price_sun	integer	Energy < 200,000 单位的价格（SUN）
periods[].prices.equal_131k.price_sun	integer	精确为 131,000 单位的价格（SUN）
periods[].prices.more_than_200k.price_sun	integer	Energy > 200,000 单位的价格（SUN）

Energy 数量类别

类别	说明	Energy 范围
less_than_200k	小额订单	< 200,000 Energy 单位
equal_131k	标准订单	精确为 131,000 Energy 单位
more_than_200k	大额订单	> 200,000 Energy 单位

时间段

API 返回全天 5 个不同时间段的价格：

时段	时间范围 (UTC)	说明
清晨	05:00-07:00	低需求时段
上午	07:00-11:00	营业时间开始
白天	11:00-21:00	高峰营业时段
傍晚	21:00-23:00	傍晚活跃期
夜间	23:00-05:00	需求最低时段

速率限制

以下速率限制适用于此端点（基于每个 IP 地址）：

周期	限制	说明
1 分钟	1 次请求	每分钟最多 1 次请求
1 小时	60 次请求	每小时最多 60 次请求

速率限制标头

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

超出速率限制 (429)

json

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

错误响应

身份验证错误 (401)

json

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

服务器内部错误 (500)

json

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

注意事项

无需请求体 - 此为 GET 请求
所有价格均以 SUN 为单位（1 TRX = 1,000,000 SUN）
价格根据 Energy 数量和一天中的时间（UTC）而有所不同
生效时段：全天根据需求动态变化
速率限制：由于属于数据库密集型操作，设有严格的限制
价格更新：价格会定期从数据库刷新
时区：所有时间均为 UTC 时间

GET /apiv2/prices 已废弃 ​

端点 URL ​

请求标头 ​

请求参数 ​

请求示例 ​

cURL ​

Python ​

紧凑响应格式 ​

适用场景 ​

请求示例 ​

紧凑响应示例 ​

响应格式说明 ​

计算公式 ​

内容类型 ​

Python 示例 ​

超紧凑响应格式 (short1h) ​

适用场景 ​

请求示例 ​

超紧凑响应示例 ​

响应格式说明 ​

内容类型 ​

Python 示例 ​

计数响应格式 (count) ​

适用场景 ​

请求示例 ​

计数响应示例 ​

响应格式说明 ​

计算公式 ​

内容类型 ​

Python 示例 ​

响应 ​

成功响应 (200 OK) ​

响应字段 ​

Energy 数量类别 ​

时间段 ​

速率限制 ​

速率限制标头 ​

超出速率限制 (429) ​

错误响应 ​

身份验证错误 (401) ​

服务器内部错误 (500) ​

注意事项 ​

GET /apiv2/prices 已废弃

端点 URL

请求标头

请求参数

请求示例

cURL

Python

紧凑响应格式

适用场景

请求示例

紧凑响应示例

响应格式说明

计算公式

内容类型

Python 示例

超紧凑响应格式 (short1h)

适用场景

请求示例

超紧凑响应示例

响应格式说明

内容类型

Python 示例

计数响应格式 (count)

适用场景

请求示例

计数响应示例

响应格式说明

计算公式

内容类型

Python 示例

响应

成功响应 (200 OK)

响应字段

Energy 数量类别

时间段

速率限制

速率限制标头

超出速率限制 (429)

错误响应

身份验证错误 (401)

服务器内部错误 (500)

注意事项