Geliştiriciler için - API

Madenim.org web arayüzümüzden bulabileceğiniz neredeyse her bilgiye API ile ulaşabilirsiniz. Tüm istekler application/json içerik türünü kullanır ve kullanım şekilleri oldukça sade tutulmuştur.

API servisimizle ilgili herhangi bir probleminiz olursa telegram kanalımızdan veya diğer sosyal bağlantılarımızdan bize ulaşabilirsiniz.

Bağlantı

Kullanım şekli:

// php kodlama diliyle bağlanmak için curl kütüphanesini kullanabilirsiniz.
function curl($url) {
	$user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; tr; rv:1.9.0.6) Gecko/2009011913 Firefox/3.0.6';
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
	curl_setopt($ch, CURLOPT_USERAGENT, $user_agent);
	$icerik = curl_exec($ch);
	curl_close($ch);
	return $icerik;
}

// Kullanım Örneği
$dizim = json_decode(curl("https://pool-eth.madenim.org/api/stats"));

// Ekrana havuzumuzun hashrate bilgisini yazdıracaktır
echo $dizim->hashrate;

// javascript kodlama diliyle bağlanmak için jquery kütüphanesini kullanabilirsiniz.
function getdata(url, callback) {
	$.ajax({
		type: "GET",
		url: url,
		success: function (veri) {
			callback(veri);
		}
	});
}
// Kullanım Örneği
$(document).ready(function () {
	getdata("https://pool-eth.madenim.org/api/stats",function(veri){

		// Ekrana havuzumuzun hashrate bilgisini yazdıracaktır
		document.write(veri["hashrate"]);
	});
});

Unutmayın, çok fazla bağlantı isteği yaparsanız bir süre bağlantınız engellenecektir.

API servislerine bir çok yazılım dili ile erişebilirsiniz fakat JSON derleme yöntemiyle sonuç alacaksınız.

Bağlantı için aşağıdaki API adresleriyle hangi havuz verilerine ulaşmak istiyorsanız ona göre bir bağlantı yöntemi hazırlayabilirsiniz.

Havuz API adreslerimiz,

GET https://pool-eth.madenim.org - Ethereum

GET https://pool-etc.madenim.org - Ethereum Classic

GET https://pool-music.madenim.org - Musicoin

GET https://pool-etp.madenim.org - Metaverse (ETP)

İstatistik

Kullanım örnekleri:

// Önceki gibi curl kütüphanesiyle verileri çekelim
$dizim = json_decode(curl("https://pool-eth.madenim.org/api/stats"));

// Talih değerini çekebilmek için aşağıdaki algoritmayı uygulayabilirsiniz
// Bu algoritma ilk key değerini alır ve durur
foreach ($dizim->luck as $key => $value){break;}

// Ekrana havuzumuzun son n blok sayısı için talih değerini yazdıracaktır
echo $dizim->luck->$key->luck;

// Önceki gibi jquery kütüphanesiyle verileri çekelim
$(document).ready(function () {
	getdata("https://pool-eth.madenim.org/api/stats",function(veri){

		// Talih değerini çekebilmek için aşağıdaki algoritmayı uygulayabilirsiniz
		// Bu algoritma ilk key değerini alır ve durur
		for(key in veri['luck']){break;}
	
		// Ekrana havuzumuzun son n blok sayısı için talih değerini yazdıracaktır
		document.write(veri["luck"][key]["luck"]);
	});
});

Genel havuz bilgilerinin tamamına istatistik API servisi ile ulaşabilirsiniz.

Havuzun hash oranı ve grafik verileri, kaç madencinin bağlı olduğu, bulunan blok sayısı, havuz talih oranı ve maden hakkında ağ zorluğu gibi bilgilere ulaşılabilir.

HTTP Request

GET https://{adres}/api/stats

Json Data

Parametre	Tip	Açıklama
hashrate	Integer	Havuzun hashrate bilgisi
minersTotal	Integer	Havuzdaki çevrimiçi madenci sayısı
now	timestamp in milliseconds	API GET işlevi yanıtlandığı andaki timestamp değeri
stats->lastBlockFound	timestamp	En son bulunan bloğun timestamp değeri
stats->nShares	Integer	PPLNS havuzu için bloğun bulunmasına katkı büyüklüğü
stats->roundShares	Integer	Çözümlenen toplam hash boyutu
nodes->0->difficulty	String	Ağ zorluğu
nodes->0->height	String	Blok yüksekliği
nodes->0->lastBeat	String	Son bulunan bloğun timestamp değeri
candidatesTotal	Integer	Yeni bulunan blok sayısı
immatureTotal	Integer	İşlenmiş, vadesi gelmemiş blok sayısı
maturedTotal	Integer	Pay edilmiş blok sayısı
luck->n(key)->luck	Integer	Son (n) blok sayısı için talih oranı
luck->n(key)->uncleRate	Integer	Son (n) blok sayısı için kısır blok oranı
luck->n(key)->orphanRate	Integer	Son (n) blok sayısı için ret edilmiş blok oranı
stats->roundShares	Integer	Çözümlenen toplam hash boyutu
poolCharts->n->timeFormat	String	Grafik değerleri için zaman biçimi
poolCharts->n->x	Integer	Havuz grafiği timestamp değeri (x ekseni)
poolCharts->n->y	Integer	Havuz grafiği hashrate bilgisi (y ekseni)

Bloklar

Havuzlarımızın blok bulma verileri ve tarama servisleri için diğer bilgilere ulaşabilirsiniz.

HTTP Request

GET https://{adres}/api/blocks

Json Data

Parametre	Tip
candidates->n->difficulty	Integer
candidates->n->hash	String
candidates->n->height	Integer
candidates->n->reward	String
candidates->n->shares	Integer
candidates->n->timestamp	Integer
candidates->n->uncle	Boolean
candidates->n->uncleHeight	Integer
candidates->n->orphan	Boolean
candidatesTotal	Integer
immature->n->difficulty	Integer
immature->n->hash	String
immature->n->height	Integer
immature->n->reward	String
immature->n->shares	Integer
immature->n->timestamp	Integer
immature->n->uncle	Boolean
immature->n->uncleHeight	Integer
immature->n->orphan	Boolean
immatureTotal	Integer
matured->n->difficulty	Integer
matured->n->hash	String
matured->n->height	Integer
matured->n->reward	String
matured->n->shares	Integer
matured->n->timestamp	Integer
matured->n->uncle	Boolean
matured->n->uncleHeight	Integer
matured->n->orphan	Boolean
maturedTotal	Integer
luck->n(key)->luck	Integer
luck->n(key)->uncleRate	Integer
luck->n(key)->orphanRate	Integer

Ödemeler

Havuzlarımızın ödeme bilgilere ulaşabilirsiniz.

HTTP Request

GET https://{adres}/api/payments

Json Data

Parametre	Tip
paymentsTotal	Integer
payments->n->address	String
payments->n->amount	Integer
payments->n->timestamp	timestamp
payments->n->tx	String

Madenciler

Havuzlarımızın madenci listesine ulaşabilirsiniz.

HTTP Request

GET https://{adres}/api/miners

Json Data

Parametre	Tip
hashrate	Integer
minersTotal	Integer
now	timestamp in milliseconds
miners->{wallet}->hr	Integer
miners->{wallet}->lastBeat	Integer
miners->n(key, wallet)->offline	Boolean

Hesap

Kendi hesabınızla ilgili detaylı bilgilere ulaşabilirsiniz.

HTTP Request

GET https://{adres}/api/accounts/{wallet}

Json Data

Parametre	Tip
currentHashrate	Integer
hashrate	Integer
pageSize	Integer
paymentsTotal	Integer
payments->n->amount	Integer
payments->n->timestamp	Timestamp
payments->n->tx	String
24hreward	Integer
rewards->n->blockhash	String
rewards->n->blockheight	Integer
rewards->n->immature	Boolean
rewards->n->percent	Integer
rewards->n->reward	Integer
rewards->n->timestamp	Timestamp
sumrewards->n->inverval	Integer
sumrewards->n->name	String
sumrewards->n->offset	Integer
sumrewards->n->reward	Integer
roundShares	Integer
stats->balance	Integer
stats->blocksFound	Integer
stats->lastShare	Integer
stats->immature	Integer
stats->pending	Integer
stats->paid	Integer
workersOffline	Integer
workersOnline	Integer
workersTotal	Integer
workers->worker(key)->hr	Integer
workers->worker(key)->hr2	Integer
workers->worker(key)->lastBeat	Integer
workers->worker(key)->offline	Integer

Hatalar

API servisimiz aşağıdaki hata kodlarını kullanır:

Hata Kodu	Anlamı
404	Not Found -- Api sayfası veya Hesap bilgileri bulunamadı.