GET /apiv2/prices Deprecated

Deprecated

یہ اینڈ پوائنٹ متروک ہو چکا ہے اور اسے مستقبل کی ریلیز میں ہٹا دیا جائے گا۔ براہ کرم نئے 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 میں نیا: مکمل JSON ڈھانچے کے بجائے ایک کمپیکٹ ٹیکسٹ جواب حاصل کرنے کے لیے X-Format ہیڈر کا استعمال کریں۔

کب استعمال کریں

نگرانی کے سسٹمز کے ساتھ انضمام
قیمت کے سادہ ڈسپلے
قیمت کی خودکار ٹریکنگ
کم سے کم بینڈوتھ کے تقاضے

مثالی درخواست

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 منٹ کے لیے محفوظ (cached) کی جاتی ہے۔

مواد کی قسم

توسیعی فارمیٹ: 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 میں نیا: دورانیے کے لیبل اور فی یونٹ قیمت کے بغیر، صرف Energy کے حسابات پر مشتمل ایک انتہائی کمپیکٹ ٹیکسٹ جواب حاصل کرنے کے لیے X-Format: short1h ہیڈر کا استعمال کریں۔

کب استعمال کریں

محدود جگہ والے مانیٹرنگ ڈیش بورڈز
موبائل ایپلیکیشنز
کم سے کم بینڈوتھ کے تقاضے
صرف حتمی اخراجات پر توجہ

مثالی درخواست

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 میں نیا: 1، 2، 3، 5، 10، اور 20 آرڈرز کے اخراجات دکھانے والے بلک آرڈر کی قیمتوں کے حسابات حاصل کرنے کے لیے X-Format: count ہیڈر کا استعمال کریں۔

کب استعمال کریں

بلک آرڈر کی قیمتوں کے ڈسپلے
والیوم ڈسکاؤنٹ کیلکولیٹر
قیمت کے تقابلی ٹولز
آرڈر کی مقدار کی منصوبہ بندی
متعدد آرڈرز کے لیے لاگت کا تخمینہ

مثالی درخواست

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 منٹ کے لیے محفوظ (cached) کی جاتی ہے۔

مواد کی قسم

شمار فارمیٹ: 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	موجودہ ہوسٹ کی قیمت TRX میں
periods	array	قیمتوں کے تمام ادوار کی سرنی (array)
periods[].label	string	انسان کے پڑھنے کے قابل دورانیے کا نام
periods[].period	string	وقت کی حد (HH:MM-HH:MM)
periods[].is_active	boolean	آیا یہ دورانیہ فی الحال فعال ہے
periods[].prices.less_than_200k.price_sun	integer	< 200,000 یونٹس Energy کے لیے SUN میں قیمت
periods[].prices.equal_131k.price_sun	integer	بالکل 131,000 یونٹس کے لیے SUN میں قیمت
periods[].prices.more_than_200k.price_sun	integer	> 200,000 یونٹس Energy کے لیے SUN میں قیمت

Energy کی مقدار کے زمرے

زمرہ	تفصیل	Energy کی حد
less_than_200k	چھوٹے آرڈرز	< 200,000 Energy یونٹس
equal_131k	معیاری آرڈرز	بالکل 131,000 Energy یونٹس
more_than_200k	بڑے آرڈرز	> 200,000 Energy یونٹس

وقت کے ادوار

API وقت کے 5 مختلف ادوار کے لیے قیمتیں واپس کرتا ہے:

دورانیہ	وقت کی حد (UTC)	تفصیل
Early Morning	05:00-07:00	کم مانگ کا دورانیہ
Morning	07:00-11:00	کاروباری اوقات کا آغاز
Daytime	11:00-21:00	کاروباری اوقات کا عروج
Evening	21:00-23:00	شام کی سرگرمی
Night	23:00-05:00	سب سے کم مانگ کا دورانیہ

شرح کی حدود (Rate Limits)

اس اینڈ پوائنٹ پر مندرجہ ذیل شرح کی حدود لاگو ہوتی ہیں (فی 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 Deprecated ​

اینڈ پوائنٹ URL ​

درخواست کے ہیڈرز ​

درخواست کے پیرامیٹرز ​

مثالی درخواستیں ​

cURL ​

Python ​

کمپیکٹ جواب کا فارمیٹ ​

کب استعمال کریں ​

مثالی درخواست ​

کمپیکٹ جواب کی مثال ​

جواب کے فارمیٹ کی وضاحت ​

حساب کا فارمولا ​

مواد کی قسم ​

Python کی مثال ​

الٹرا کمپیکٹ جوابی فارمیٹ (short1h) ​

کب استعمال کریں ​

مثالی درخواست ​

الٹرا کمپیکٹ جواب کی مثال ​

جواب کے فارمیٹ کی وضاحت ​

مواد کی قسم ​

Python کی مثال ​

شمار جوابی فارمیٹ (count) ​

کب استعمال کریں ​

مثالی درخواست ​

شمار جواب کی مثال ​

جواب کے فارمیٹ کی وضاحت ​

حساب کا فارمولا ​

مواد کی قسم ​

Python کی مثال ​

جواب ​

کامیاب جواب (200 OK) ​

جوابی فیلڈز ​

Energy کی مقدار کے زمرے ​

وقت کے ادوار ​

شرح کی حدود (Rate Limits) ​

ریٹ لمیٹ ہیڈرز ​

ریٹ لمیٹ سے تجاوز (429) ​

غلطی کے جوابات ​

تصدیقی غلطی (401) ​

انٹرنل سرور ایرر (500) ​

نوٹس ​

GET /apiv2/prices Deprecated

اینڈ پوائنٹ URL

درخواست کے ہیڈرز

درخواست کے پیرامیٹرز

مثالی درخواستیں

cURL

Python

کمپیکٹ جواب کا فارمیٹ

کب استعمال کریں

مثالی درخواست

کمپیکٹ جواب کی مثال

جواب کے فارمیٹ کی وضاحت

حساب کا فارمولا

مواد کی قسم

Python کی مثال

الٹرا کمپیکٹ جوابی فارمیٹ (short1h)

کب استعمال کریں

مثالی درخواست

الٹرا کمپیکٹ جواب کی مثال

جواب کے فارمیٹ کی وضاحت

مواد کی قسم

Python کی مثال

شمار جوابی فارمیٹ (count)

کب استعمال کریں

مثالی درخواست

شمار جواب کی مثال

جواب کے فارمیٹ کی وضاحت

حساب کا فارمولا

مواد کی قسم

Python کی مثال

جواب

کامیاب جواب (200 OK)

جوابی فیلڈز

Energy کی مقدار کے زمرے

وقت کے ادوار

شرح کی حدود (Rate Limits)

ریٹ لمیٹ ہیڈرز

ریٹ لمیٹ سے تجاوز (429)

غلطی کے جوابات

تصدیقی غلطی (401)

انٹرنل سرور ایرر (500)

نوٹس