GET /apiv2/userinfo

ดึงข้อมูลผู้ใช้ รวมถึงยอดคงเหลือและสถิติการใช้งาน

URL ของ Endpoint

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

Headers ของคำขอ

Header	จำเป็น	คำอธิบาย
X-API-KEY	ใช่	API key ของคุณ
X-Real-IP	ใช่	ที่อยู่ IP จากไวท์ลิสต์

พารามิเตอร์ของคำขอ

ไม่จำเป็นต้องใช้พารามิเตอร์ - ข้อมูลผู้ใช้จะถูกระบุจาก API key

Examples การส่งคำขอ

cURL

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

Python

import requests

url = "https://netts.io/apiv2/userinfo"
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"User ID: {data.get('user_id')}")
    
    user_info = data.get('user_info', {})
    print(f"Email: {user_info.get('email')}")
    print(f"Name: {user_info.get('name')}")
    print(f"Deposit Address: {user_info.get('deposit_address')}")
    
    stats = data.get('stats', {})
    print(f"Balance: {stats.get('balance')} TRX")
    print(f"Total Delegations: {stats.get('total_delegations')}")
    print(f"Total Energy Delegated: {stats.get('total_energy_delegated')}")
    print(f"Total TRX Spent: {stats.get('total_trx_spent')} TRX")
    print(f"Average Rate: {stats.get('avg_rate_sun_energy')} Sun/Energy")
    print(f"Savings: {stats.get('save_by_netts_percent')}%")
    print(f"Savings in USD: ${stats.get('save_in_dollars')}")
    
    network_info = data.get('network_info', {})
    print(f"TRX Price: ${network_info.get('trx_price')}")
    print(f"Network Energy Fee: {network_info.get('network_energy_fee')}")
else:
    print(f"Error: {data.get('message', 'Unknown error')}")

การตอบกลับ

Response ที่สำเร็จ (200 OK)

{
    "status": "success",
    "timestamp": "2025-09-02 05:56:11",
    "user_id": 6,
    "user_info": {
        "email": "[email protected]",
        "name": "User Name",
        "deposit_address": "TDepositAddress1234567890123456789"
    },
    "stats": {
        "balance": 28361.15,
        "total_delegations": 96756,
        "total_energy_delegated": 21687058023,
        "total_trx_spent": 832181.95,
        "total_deposit": 0,
        "avg_rate_sun_energy": 38.37,
        "save_by_netts_percent": 61.63,
        "save_in_dollars": 453267.36
    },
    "network_info": {
        "trx_price": 0.3391,
        "network_energy_fee": 100.0
    }
}

ฟิลด์ใน Response

ฟิลด์	ประเภท	คำอธิบาย
status	string	เป็น "success" เสมอสำหรับคำขอที่สำเร็จ
timestamp	string	การประทับเวลาของเซิร์ฟเวอร์ในรูปแบบ YYYY-MM-DD HH:MM:SS
user_id	integer	ID ผู้ใช้ภายในระบบ
user_info.email	string	ที่อยู่อีเมลของผู้ใช้
user_info.name	string	ชื่อที่แสดงของผู้ใช้
user_info.deposit_address	string	ที่อยู่ TRON สำหรับการฝากเงิน
stats.balance	number	Total Balance TRX - รวมยอดคงเหลือในกระเป๋าเงินฝาก + การจ่ายเงินที่รอดำเนินการ (Robot & Sub-users) - การถอนเงินที่รอดำเนินการ
stats.total_delegations	integer	จำนวนการมอบสิทธิ์ Energy ทั้งหมด
stats.total_energy_delegated	integer	จำนวนหน่วย Energy ทั้งหมดที่มอบสิทธิ์
stats.total_trx_spent	number	จำนวน TRX ทั้งหมดที่ใช้ไปกับ Energy
stats.total_deposit	number	ยอดการฝากเงินทั้งหมด
stats.avg_rate_sun_energy	number	อัตราเฉลี่ยในหน่วย Sun ต่อหน่วย Energy
stats.save_by_netts_percent	number	เปอร์เซ็นต์ที่ประหยัดได้เมื่อใช้ NETTS เทียบกับการเบิร์น TRX
stats.save_in_dollars	number	มูลค่าการประหยัดในหน่วยดอลลาร์
network_info.trx_price	number	ราคา TRX ปัจจุบันในสกุลเงิน USD
network_info.network_energy_fee	number	ค่าธรรมเนียม Energy ของเครือข่ายปัจจุบัน

การตอบกลับเมื่อเกิดข้อผิดพลาด

ข้อผิดพลาดในการยืนยันตัวตน (401)

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

ข้อผิดพลาดภายในเซิร์ฟเวอร์ (500)

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

การจำกัดอัตราการเรียกใช้

ข้อจำกัดอัตราการใช้งานต่อไปนี้มีผลกับ endpoint นี้ (ต่อที่อยู่ IP):

ช่วงเวลา	ขีดจำกัด	คำอธิบาย
1 นาที	6 คำขอ	สูงสุด 6 คำขอต่อนาที

ส่วนหัวของ Rate Limit

API จะส่งคืนข้อมูลข้อจำกัดอัตราการใช้งานในส่วนหัวของการตอบกลับ:

RateLimit-Limit: 6
RateLimit-Remaining: 5
RateLimit-Reset: 45
X-RateLimit-Limit-Minute: 6
X-RateLimit-Remaining-Minute: 5
Retry-After: 45

ใช้งานเกิน Rate Limit (429)

{
    "message": "API rate limit exceeded",
    "request_id": "70257e0476dc396a11875532a45ce037"
}

เมื่อใช้งานเกินขีดจำกัด ให้รอตามเวลาที่ระบุไว้ในส่วนหัว Retry-After ก่อนที่จะส่งคำขอถัดไป

รายละเอียดการคำนวณยอดคงเหลือ

Total Balance TRX ประกอบด้วย:

ฟิลด์ stats.balance จะส่งคืน Total Balance TRX ซึ่งคำนวณได้ดังนี้:

Total Balance TRX = ยอดคงเหลือในกระเป๋าเงินฝาก + การจ่ายเงินที่รอดำเนินการ - การถอนเงินที่รอดำเนินการ

องค์ประกอบ:

• ยอดคงเหลือในกระเป๋าเงินฝาก: ยอดคงเหลือ TRX ในที่อยู่การฝากของผู้ใช้
• การจ่ายเงินที่รอดำเนินการ: รายได้ TRX จาก Robot และ Sub-users ที่รอการโอนเข้า
• การถอนเงินที่รอดำเนินการ: จำนวน TRX ในคำขอถอนเงินที่รอดำเนินการ

หมายเหตุสำคัญ:

ข้อสำคัญ

• การจ่ายเงิน TRX ของ Robot & Sub-users จะถูกโอนเข้าที่อยู่การฝาก 2 ครั้งต่อวัน
• ก่อนที่จะมีการโอนเข้า ยอด TRX จากการจ่ายเงินของ Robot & Sub-users ไม่สามารถใช้ สำหรับการซื้อ Energy ได้
• หากต้องการถอนยอด TRX/USDT จากการจ่ายเงินของ Robot & Sub-users ให้ทำเครื่องหมายในช่องตัวเลือกในแบบฟอร์มการถอนเงินบนเว็บไซต์

หมายเหตุ

• ไม่จำเป็นต้องมี Request Body - คำขอนี้เป็นคำขอประเภท GET
• ข้อมูลผู้ใช้จะถูกระบุจาก API key ที่ระบุ
• ค่า TRX ทั้งหมดจะอยู่ในรูปแบบทศนิยม
• ค่า Energy จะอยู่ในหน่วยมาตรฐาน TRON Energy
• การประทับเวลาจะอิงตามเวลาของเซิร์ฟเวอร์ (UTC)
• Rate limiting: มีการบังคับใช้ต่อที่อยู่ IP โดยมีหลายกรอบเวลา
• รหัสข้อผิดพลาด 429: จะถูกส่งคืนเมื่อใช้งานเกินขีดจำกัดอัตราการใช้งาน