GET /apiv2/prices Deprecated

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 address
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 हेडर का उपयोग करें।

इसका उपयोग कब करें

मॉनिटरिंग सिस्टम के साथ एकीकरण
सरल मूल्य प्रदर्शन
स्वचालित मूल्य ट्रैकिंग
न्यूनतम 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	SUN में प्रति Energy यूनिट मूल्य	`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 में नया: अवधि लेबल और प्रति यूनिट मूल्य के बिना, केवल Energy गणनाओं वाली एक अति-संक्षिप्त टेक्स्ट प्रतिक्रिया प्राप्त करने के लिए X-Format: short1h हेडर का उपयोग करें।

इसका उपयोग कब करें

सीमित स्थान वाले मॉनिटरिंग डैशबोर्ड
मोबाइल एप्लिकेशन
न्यूनतम 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 में नया: 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

कंटेंट प्रकार

गणना प्रारूप: 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	न्यूनतम मांग की अवधि

दर सीमाएं

इस एंडपॉइंट पर निम्नलिखित दर सीमाएं लागू होती हैं (प्रति IP पता):

अवधि	सीमा	विवरण
1 minute	1 अनुरोध	अधिकतम 1 अनुरोध प्रति मिनट
1 hour	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) के आधार पर कीमतें बदलती हैं
सक्रिय अवधि: मांग के आधार पर पूरे दिन बदलती रहती है
दर सीमा (Rate limiting): डेटाबेस-गहन संचालन के कारण सख्त सीमाएं
मूल्य अपडेट: डेटाबेस से समय-समय पर कीमतें रीफ्रेश की जाती हैं
समय क्षेत्र: सभी समय UTC में हैं

GET /apiv2/prices Deprecated ​

एंडपॉइंट URL ​

अनुरोध हेडर ​

अनुरोध पैरामीटर ​

उदाहरण अनुरोध ​

cURL ​

Python ​

संक्षिप्त प्रतिक्रिया प्रारूप ​

इसका उपयोग कब करें ​

उदाहरण अनुरोध ​

संक्षिप्त प्रतिक्रिया उदाहरण ​

प्रतिक्रिया प्रारूप का विवरण ​

गणना सूत्र ​

कंटेंट प्रकार ​

Python उदाहरण ​

अति-संक्षिप्त प्रतिक्रिया प्रारूप (short1h) ​

इसका उपयोग कब करें ​

उदाहरण अनुरोध ​

अति-संक्षिप्त प्रतिक्रिया उदाहरण ​

प्रतिक्रिया प्रारूप का विवरण ​

कंटेंट प्रकार ​

Python उदाहरण ​

गणना प्रतिक्रिया प्रारूप (count) ​

इसका उपयोग कब करें ​

उदाहरण अनुरोध ​

गणना प्रतिक्रिया उदाहरण ​

प्रतिक्रिया प्रारूप का विवरण ​

गणना सूत्र ​

कंटेंट प्रकार ​

Python उदाहरण ​

प्रतिक्रिया ​

सफल प्रतिक्रिया (200 OK) ​

प्रतिक्रिया फ़ील्ड ​

Energy मात्रा श्रेणियाँ ​

समय अवधियाँ ​

दर सीमाएं ​

दर सीमा हेडर ​

दर सीमा पार (429) ​

त्रुटि प्रतिक्रियाएं ​

प्रमाणीकरण त्रुटि (401) ​

आंतरिक सर्वर त्रुटि (500) ​

टिप्पणियाँ ​

GET /apiv2/prices Deprecated

एंडपॉइंट URL

अनुरोध हेडर

अनुरोध पैरामीटर

उदाहरण अनुरोध

cURL

Python

संक्षिप्त प्रतिक्रिया प्रारूप

इसका उपयोग कब करें

उदाहरण अनुरोध

संक्षिप्त प्रतिक्रिया उदाहरण

प्रतिक्रिया प्रारूप का विवरण

गणना सूत्र

कंटेंट प्रकार

Python उदाहरण

अति-संक्षिप्त प्रतिक्रिया प्रारूप (short1h)

इसका उपयोग कब करें

उदाहरण अनुरोध

अति-संक्षिप्त प्रतिक्रिया उदाहरण

प्रतिक्रिया प्रारूप का विवरण

कंटेंट प्रकार

Python उदाहरण

गणना प्रतिक्रिया प्रारूप (count)

इसका उपयोग कब करें

उदाहरण अनुरोध

गणना प्रतिक्रिया उदाहरण

प्रतिक्रिया प्रारूप का विवरण

गणना सूत्र

कंटेंट प्रकार

Python उदाहरण

प्रतिक्रिया

सफल प्रतिक्रिया (200 OK)

प्रतिक्रिया फ़ील्ड

Energy मात्रा श्रेणियाँ

समय अवधियाँ

दर सीमाएं

दर सीमा हेडर

दर सीमा पार (429)

त्रुटि प्रतिक्रियाएं

प्रमाणीकरण त्रुटि (401)

आंतरिक सर्वर त्रुटि (500)

टिप्पणियाँ