パッケージ統計
期間ごとにプロキシパッケージのトラフィック使用履歴を照会します。
GET /packages/:id/stats
選択した期間の日別トラフィックおよびリクエスト数を返します。使用量ダッシュボードの構築やトラフィック低下時のアラート発火に役立ちます。
GET
/api/v1/packages/{id}/statsクエリパラメータ
| パラメータ | デフォルト | オプション |
|---|---|---|
period | 30d | 7d · 30d · 90d · 1y · day · week · month · 3months · 6months · year |
aggregate | day | minute · hour · day. 履歴系列のバケットサイズ。minute は period=7d または day のみ許可されます。 |
stats-request.sh
curl "https://raxyproxy.com/api/v1/packages/12/stats?period=7d" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"stats-response.json
{
"data": {
"package_id": 12,
"period": "7d",
"aggregate": "day",
"quota_gb": 10.0,
"used_gb": 3.2140,
"available_gb": 6.7860,
"usage_pct": 32.14,
"history": [
{ "datetime": "2026-05-09", "traffic_gb": 0.512100, "requests": 4820 },
{ "datetime": "2026-05-10", "traffic_gb": 0.480300, "requests": 4612 },
{ "datetime": "2026-05-11", "traffic_gb": 0.631200, "requests": 5901 },
{ "datetime": "2026-05-12", "traffic_gb": 0.390000, "requests": 3741 },
{ "datetime": "2026-05-13", "traffic_gb": 0.520000, "requests": 4900 },
{ "datetime": "2026-05-14", "traffic_gb": 0.441200, "requests": 4210 },
{ "datetime": "2026-05-15", "traffic_gb": 0.239188, "requests": 2390 }
]
},
"meta": { "version": "v1" }
}With aggregate=hour or aggregate=minute the datetime values include time-of-day, for example 2026-05-15T14:00:00+00:00.
レスポンスフィールド
| フィールド | タイプ | 説明 |
|---|---|---|
package_id | integer | このデータが属するパッケージ |
period | string | リクエストされた期間（エコーバック） |
quota_gb | float | 購入済み総トラフィック |
used_gb | float | 累積消費トラフィック |
available_gb | float | 残りトラフィック |
usage_pct | float | 消費率 |
aggregate | string | minute · hour · day |
history[].datetime | string | カレンダーの日付 |
history[].traffic_gb | float | その日に使用されたトラフィック（GB） |
history[].requests | integer | そのバケットのプロキシリクエスト数 |
関連エンドポイント
ホスト別トラフィック内訳（上位 N 宛先）は次で利用可能： /api/v1/packages/{id}/stats/hosts.
最近のエラーイベント（4xx/5xx/タイムアウト）は次で利用可能： /api/v1/packages/{id}/stats/errors.
コード例
stats.py
import requests
API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12
resp = requests.get(
f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/stats',
params={'period': '30d'},
headers={'Authorization': f'Bearer {API_KEY}'},
timeout=10,
).json()
data = resp['data']
print(f"Used {data['used_gb']} / {data['quota_gb']} GB ({data['usage_pct']}%)")
for bucket in data['history']:
print(f" {bucket['datetime']}: {bucket['traffic_gb']:.4f} GB {bucket['requests']} requests")stats.mjs
const API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const PACKAGE_ID = 12;
const url = `https://raxyproxy.com/api/v1/packages/${PACKAGE_ID}/stats?period=30d`;
const resp = await fetch(url, {
headers: { Authorization: `Bearer ${API_KEY}` },
});
const { data } = await resp.json();
console.log(`Used ${data.used_gb} / ${data.quota_gb} GB (${data.usage_pct}%)`);
for (const day of data.history) {
console.log(` ${day.datetime}: ${day.traffic_gb.toFixed(4)} GB ${day.requests} requests`);
}