GET /apiv2/prices Kullanım Dışı

Kullanım Dışı

Bu uç nokta kullanımdan kaldırılmıştır ve gelecekteki bir sürümde tamamen kaldırılacaktır. Lütfen dinamik dönemler, hizmet filtreleme, süre indirimleri ve birleşik bir yanıt formatı sunan yeni GET /apiv2/pricing uç noktasına geçiş yapın.

Gün boyunca farklı zaman dilimleri için geçerli enerji kiralama fiyatlarını alın.

Karşılama sırasında fiyat değişebilir

Bu uç nokta tarafından döndürülen fiyat, bir sipariş işlenirken değişebilir. Bir enerji sağlayıcısı delegasyon talebini reddedebilir; bu durumda Netts siparişi otomatik olarak bir sonraki uygun sağlayıcıya yönlendirir. Netts yalnızca en rekabetçi fiyatı sunmayı değil, aynı zamanda güvenilir bir enerji arzı sağlamayı da taahhüt eder — bu nedenle bir sipariş teklif edilenden daha yüksek bir fiyata karşılanabilir. Bu yalnızca 300.000 enerji birimi ve üzerindeki siparişler için geçerlidir.

Uç Nokta URL'si

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

İstek Başlıkları

Başlık	Zorunlu	Açıklama	Değerler
X-API-KEY	Evet	API anahtarınız	string
X-Real-IP	Evet	Beyaz listedeki IP adresi	IP adresi
X-Format	Hayır	Yanıt formatı (varsayılan: genişletilmiş JSON)	`now`, `compact`, `short`, `short1h`, `count`

İstek Parametreleri

Hiçbir parametre gerekli değildir - mevcut tüm fiyatlandırma bilgilerini döndürür.

Örnek İstekler

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

Kompakt Yanıt Formatı

v2.1'de Yeni: Tam JSON yapısı yerine kompakt bir metin yanıtı almak için X-Format başlığını kullanın.

Ne Zaman Kullanılmalı

İzleme sistemleriyle entegrasyon
Basit fiyat gösterimleri
Otomatik fiyat takibi
Minimum bant genişliği gereksinimleri

Örnek İstek

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"

Kompakt Yanıt Örneği

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

Yanıt Formatı Açıklaması

Kompakt format şunları sağlar:

Bileşen	Açıklama	Örnek
Dönem etiketi	Aktif fiyatlandırma dönemi	`Daytime Hours (11:00-21:00 UTC)`
price=X sun	SUN cinsinden enerji birimi başına fiyat	`price=27 sun`
65k=X.XXX TRX (X.XX$)	65.000 enerji birimi maliyeti	`65k=1.755 TRX (0.52$)`
131k=X.XXX TRX (X.XX$)	131.000 enerji birimi maliyeti	`131k=3.537 TRX (1.05$)`
1m=X.XXX TRX (X.XX$)	1.000.000 enerji birimi maliyeti	`1m=27.000 TRX (7.99$)`

Hesaplama Formülü

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

Not: TRX/USD döviz kuru chain_param tablosundan alınır ve 30 dakika boyunca önbelleğe alınır.

İçerik Türü

Genişletilmiş format: application/json
Kompakt format: text/plain

Python Örneği

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

Ultra Kompakt Yanıt Formatı (short1h)

v2.2'de Yeni: Dönem etiketi ve birim başına fiyat olmadan, yalnızca enerji hesaplamalarını içeren ultra kompakt bir metin yanıtı almak için X-Format: short1h başlığını kullanın.

Ne Zaman Kullanılmalı

Sınırlı alana sahip izleme panelleri
Mobil uygulamalar
Minimum bant genişliği gereksinimleri
Yalnızca nihai maliyetlere odaklanma

Örnek İstek

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"

Ultra Kompakt Yanıt Örneği

text

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

Yanıt Formatı Açıklaması

Ultra kompakt format yalnızca temel maliyet hesaplamalarını sağlar:

Bileşen	Açıklama	Örnek
65k=X.XXX TRX (X.XX$)	65.000 enerji birimi maliyeti	`65k=1.755 TRX (0.52$)`
131k=X.XXX TRX (X.XX$)	131.000 enerji birimi maliyeti	`131k=3.537 TRX (1.05$)`
1m=X.XXX TRX (X.XX$)	1.000.000 enerji birimi maliyeti	`1m=27.000 TRX (7.99$)`

Not: Bu format, maksimum kompaktlık için dönem etiketini ve enerji birimi başına fiyatı hariç tutar.

İçerik Türü

Ultra kompakt format: text/plain

Python Örneği

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

Adet Yanıt Formatı (count)

v2.3'te Yeni: 1, 2, 3, 5, 10 ve 20 sipariş için maliyetleri gösteren toplu sipariş fiyatlandırma hesaplamalarını almak için X-Format: count başlığını kullanın.

Ne Zaman Kullanılmalı

Toplu sipariş fiyatlandırma gösterimleri
Hacim indirimi hesaplayıcıları
Fiyat karşılaştırma araçları
Sipariş miktarı planlaması
Birden fazla sipariş için maliyet tahmini

Örnek İstek

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"

Adet Yanıtı Örneği

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

Yanıt Formatı Açıklaması

Adet formatı, farklı sipariş miktarları için hesaplanmış fiyatlandırma sağlar:

Bileşen	Açıklama	Örnek
1-X.XXX TRX (X.XX$)	1 sipariş maliyeti (65.000 enerji birimi)	`1-1.690 TRX (0.50$)`
2-X.XXX TRX (X.XX$)	2 sipariş maliyeti (131.000 enerji birimi)	`2-3.380 TRX (1.00$)`
3-X.XXX TRX (X.XX$)	3 sipariş maliyeti (3 × 65.000 enerji)	`3-5.070 TRX (1.50$)`
5-X.XXX TRX (X.XX$)	5 sipariş maliyeti (5 × 65.000 enerji)	`5-8.450 TRX (2.50$)`
10-X.XXX TRX (X.XX$)	10 sipariş maliyeti (10 × 65.000 enerji)	`10-16.900 TRX (5.00$)`
20-X.XXX TRX (X.XX$)	20 sipariş maliyeti (20 × 65.000 enerji)	`20-33.800 TRX (10.00$)`

Hesaplama Formülü

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

Not: TRX/USD döviz kuru chain_param tablosundan alınır ve 30 dakika boyunca önbelleğe alınır.

İçerik Türü

Adet formatı: text/plain

Python Örneği

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

Yanıt

Başarılı Yanıt (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
                }
            }
        }
    ]
}

Yanıt Alanları

Alan	Tür	Açıklama
status	string	Başarılı istekler için her zaman "success"
current_utc_time	string	UTC cinsinden mevcut sunucu saati
current_utc_hour	integer	Mevcut UTC saati (0-23)
active_period	string	Şu anda aktif olan fiyatlandırma dönemi
last_update	string	Fiyatların son güncellenme zamanı
host_price	number	TRX cinsinden mevcut host fiyatı
periods	array	Tüm fiyatlandırma dönemlerinin dizisi
periods[].label	string	Okunabilir dönem adı
periods[].period	string	Zaman aralığı (SS:DD-SS:DD)
periods[].is_active	boolean	Bu dönemin şu anda aktif olup olmadığı
periods[].prices.less_than_200k.price_sun	integer	< 200.000 birim enerji için SUN cinsinden fiyat
periods[].prices.equal_131k.price_sun	integer	Tam olarak 131.000 birim için SUN cinsinden fiyat
periods[].prices.more_than_200k.price_sun	integer	> 200.000 birim enerji için SUN cinsinden fiyat

Enerji Miktarı Kategorileri

Kategori	Açıklama	Enerji Aralığı
less_than_200k	Küçük siparişler	< 200.000 enerji birimi
equal_131k	Standart siparişler	Tam olarak 131.000 enerji birimi
more_than_200k	Büyük siparişler	> 200.000 enerji birimi

Zaman Dilimleri

API, 5 farklı zaman dilimi için fiyat döndürür:

Dönem	Zaman Aralığı (UTC)	Açıklama
Erken Sabah	05:00-07:00	Düşük talep dönemi
Sabah	07:00-11:00	Mesai saatleri başlangıcı
Gündüz	11:00-21:00	Yoğun mesai saatleri
Akşam	21:00-23:00	Akşam hareketliliği
Gece	23:00-05:00	En düşük talep dönemi

Hız Limitleri

Bu uç nokta için aşağıdaki hız limitleri geçerlidir (IP adresi başına):

Dönem	Limit	Açıklama
1 dakika	1 istek	Dakika başına maksimum 1 istek
1 saat	60 istek	Saat başına maksimum 60 istek

Hız Limiti Başlıkları

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

Hız Limiti Aşıldı (429)

json

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

Hata Yanıtları

Kimlik Doğrulama Hatası (401)

json

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

Sunucu İçi Hata (500)

json

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

Notlar

İstek gövdesi gerekmez - bu bir GET isteğidir
Tüm fiyatlar SUN cinsindendir (1 TRX = 1.000.000 SUN)
Fiyatlar enerji miktarına ve günün saatine (UTC) göre değişiklik gösterir
Aktif dönem: Talebe bağlı olarak gün boyunca değişir
Hız sınırlaması: Veritabanı yoğun işlemler nedeniyle katı limitler uygulanır
Fiyat güncellemeleri: Fiyatlar periyodik olarak veritabanından yenilenir
Saat dilimleri: Tüm zamanlar UTC formatındadır

GET /apiv2/prices Kullanım Dışı ​

Uç Nokta URL'si ​

İstek Başlıkları ​

İstek Parametreleri ​

Örnek İstekler ​

cURL ​

Python ​

Kompakt Yanıt Formatı ​

Ne Zaman Kullanılmalı ​

Örnek İstek ​

Kompakt Yanıt Örneği ​

Yanıt Formatı Açıklaması ​

Hesaplama Formülü ​

İçerik Türü ​

Python Örneği ​

Ultra Kompakt Yanıt Formatı (short1h) ​

Ne Zaman Kullanılmalı ​

Örnek İstek ​

Ultra Kompakt Yanıt Örneği ​

Yanıt Formatı Açıklaması ​

İçerik Türü ​

Python Örneği ​

Adet Yanıt Formatı (count) ​

Ne Zaman Kullanılmalı ​

Örnek İstek ​

Adet Yanıtı Örneği ​

Yanıt Formatı Açıklaması ​

Hesaplama Formülü ​

İçerik Türü ​

Python Örneği ​

Yanıt ​

Başarılı Yanıt (200 OK) ​

Yanıt Alanları ​

Enerji Miktarı Kategorileri ​

Zaman Dilimleri ​

Hız Limitleri ​

Hız Limiti Başlıkları ​

Hız Limiti Aşıldı (429) ​

Hata Yanıtları ​

Kimlik Doğrulama Hatası (401) ​

Sunucu İçi Hata (500) ​

Notlar ​

GET /apiv2/prices Kullanım Dışı

Uç Nokta URL'si

İstek Başlıkları

İstek Parametreleri

Örnek İstekler

cURL

Python

Kompakt Yanıt Formatı

Ne Zaman Kullanılmalı

Örnek İstek

Kompakt Yanıt Örneği

Yanıt Formatı Açıklaması

Hesaplama Formülü

İçerik Türü

Python Örneği

Ultra Kompakt Yanıt Formatı (short1h)

Ne Zaman Kullanılmalı

Örnek İstek

Ultra Kompakt Yanıt Örneği

Yanıt Formatı Açıklaması

İçerik Türü

Python Örneği

Adet Yanıt Formatı (count)

Ne Zaman Kullanılmalı

Örnek İstek

Adet Yanıtı Örneği

Yanıt Formatı Açıklaması

Hesaplama Formülü

İçerik Türü

Python Örneği

Yanıt

Başarılı Yanıt (200 OK)

Yanıt Alanları

Enerji Miktarı Kategorileri

Zaman Dilimleri

Hız Limitleri

Hız Limiti Başlıkları

Hız Limiti Aşıldı (429)

Hata Yanıtları

Kimlik Doğrulama Hatası (401)

Sunucu İçi Hata (500)

Notlar