API

Giriş

Public API ve Trade API başka borsanın yazılım ile uygun iletişim aracıdır.

• Public API kişisel hesap verilerine erişim gerektirmeyen bilgileri elde etmek için kullanılır.
• Trade API siparişleri oluşturmak ve iptal etmek, mevcut bakiyeleri talep etmek ve ayrıca kişisel hesap verilerine erişim gerektiren bilgileri almak için gereklidir.

Public API

Şu anda Public API birkaç sürümlerde mevcuttur. Geliştiricilerin, yazılım ürünlerinde kullanmak üzere en yeni sürümü seçmeleri önerilir.

v2

Public API'nin ikinci sürüm aşağıdakileri almak için fırsat sağlar: depth, fee, ticker, trades (yöntemler).

Bağlantı böyle gözükmektedir: https://yobit.net/api/2/çift/yöntemin adı

Bağlantıda sadece bir çift belirtilebilir.
Çift için örnekler ltc_btc:

• Depth: https://yobit.net/api/2/ltc_btc/depth
• Ticker: https://yobit.net/api/2/ltc_btc/ticker
• Trades: https://yobit.net/api/2/ltc_btc/trades
• Fee: https://yobit.net/api/2/ltc_btc/fee

v3

Public API üçüncü sürümü ile ikinci arasındaki temel fark, sunucuya yapılan tek istekte aynı anda birkaç çift hakkında bilgi edinmektir. Bu durumda, istenen çiftlerin listesi tire karakteri ile belirtilir.

Sunucu yanıtları her 2 saniyede bir önbelleğe alınır, bu nedenle daha sık istekte bulunmak gerek yoktur.

Mevcut yöntemler: depth, ticker, trades, info.

Bağlantı böyle gözükmektedir: https://yobit.net/api/3/yöntemin adı/çiftlerin listesi
Tekrarlama olmadan birden çok veya sadece bir çift belirtilebilir.

Yöntem info Çift listeleme parametresi bulunmamaktadır. Bu yöntem, geçerli çiftlerin listesini almak için kullanılabilir.

Çift listesi için örneklerltc_btc-nmc_btc:

• Info: https://yobit.net/api/3/info
• Depth: https://yobit.net/api/3/depth/ltc_btc-nmc_btc
• Ticker: https://yobit.net/api/3/ticker/ltc_btc-nmc_btc
• Trades: https://yobit.net/api/3/trades/ltc_btc-nmc_btc

Dikkat! Listeden herhangi bir çifti devre dışı bıraktığımızda, API hata verecektir. Bu tür hataların yok sayılmasını sağlamak için GET-parametresi mevcutturignore_invalid.
Kullanım örneği: https://yobit.net/api/3/depth/ltc_btc-erro_pair?ignore_invalid=1

info

Talep örneği: https://yobit.net/api/3/info

Cevap örneği:

{
	"server_time":1418654531,
	"pairs":{
		"ltc_btc":{
			"decimal_places":8,
			"min_price":0.00000001,
			"max_price":10000,
			"min_amount":0.0001,
			"hidden":0,
			"fee":0.2
		}
		...
	}
}

• decimal_places: virgülden sonra izin verilen karakter sayısı
• min_price: izin verilen minimum fiyat
• max_price: izin verilen maksimum fiyat
• min_amount: satın almak veya satmak için izin verilen minimum miktar
• hidden: çift gizlendi (0 veya 1)
• fee: çiftin komisyonu

Gizlenen çiftler borsanın ana sayfasındaki listede görüntülenmez ancak üzerindeki değiş tokuş çalışmaya devam ediyor.
Herhangi bir çifti devre dışı bıraktığınızda listeden kaybolur.

ticker

Yöntem son 24 saat için istatistiksel bilgileri verir.

Talep örneği: https://yobit.net/api/3/ticker/ltc_btc

Cevap örneği:

{
	"ltc_btc":{
		"high":105.41,
		"low":104.67,
		"avg":105.04,
		"vol":43398.22251455,
		"vol_cur":4546.26962359,
		"last":105.11,
		"buy":104.2,
		"sell":105.11,
		"updated":1418654531
	}
	...
}

• high: maksimum fiyat
• low: minimum fiyat
• avg: ortalama fiyat
• vol: bahsi hacmi
• vol_cur: döviz cinsinden bahsi hacmi
• last: son anlaşma fiyatı
• buy: alış fiyatı
• sell: satış fiyatı
• updated: son önbellek güncellemesi

depth

Yöntem belirtilen çiftlerin aktif sipariş listeleri hakkında bilgi döndürür.

GET-parametresi limit çekmek için derecesini ayarla (varsayılan 150, maksimum 2000).

Talep örneği: https://yobit.net/api/3/depth/ltc_btc

Cevap örneği:

{
	"ltc_btc":{
		"asks":[
			[104.67,0.01],
			[104.75,11],
			[104.80,0.523],
			...
		],
		"bids":[
			[104.3,5.368783],
			[104.212,2.57357],
			[103.62,0.43663336],
			[103.61,0.7255672],
			...
		]
	}
	...
}

• asks: satış emirleri
• bids: alış emirleri

trades

Yöntem, belirtilen çiftlerin son anlaşmaları hakkında bilgi verir.

GET-parametresi limit çekmek için derecesini ayarlar (varsayılan 150, maksimum 2000).

Talep örneği: https://yobit.net/api/3/trades/ltc_btc

Cevap örneği:

{
	"ltc_btc":[
		{
			"type":"ask",
			"price":104.2,
			"amount":0.101,
			"tid":41234426,
			"timestamp":1418654531
		},
		{
			"type":"bid",
			"price":103.53,
			"amount":1.51414,
			"tid":41234422,
			"timestamp":1418654530
		},
		...
	]
	...
}

• type: ask - satış, bid - alış
• price: alış/satış fiyatı
• amount: miktar
• tid: anlaşma kimliği
• timestamp: anlaşma unix time

Trade API

Trade API siparişleri oluşturmak ve iptal etmek, mevcut bakiyeleri talep etmek ve ayrıca kişisel hesap verilerine erişim gerektiren bilgileri almak için gereklidir.

Trade API'yi kullanmak için anahtar oluşturulmalı gerekli bölümde.
Anahtarın sırrı, oluşturulduktan sonra yalnızca bir saat içinde kullanılabilir, bu yüzden anahtarı oluşturduktan hemen sonra kaydetmenizi öneririz. Anahtarlar ve bunların sırları, kullanıcının kimliği doğrulamak için kullanılır.

Trade API talep gönderme adresi: https://yobit.net/tapi/

her talep için doğrulama gerekir.

Sunucu, tüm yanıtları JSON biçiminde verir

Başarılı sunucu yanıt örneği:

{"success":1,"return":{cevap}}

Hatayı bildiren yanıt örneği:

{"success":0,"error":"hata"}

Giriş

Her Trade API talebi doğrulanmalıdır.
Doğrulama, aşağıdaki HTTP başlıklarını göndererek gerçekleşir:

Key - API-anahtar, örnek: FAF816D16FFDFBD1D46EEF5D5B10D8A2

Sign - elektronik imza, POST-parametreler (?param0=val0 & ...& nonce=1) HMAC-SHA512'yı kullanarak özel anahtarla imzalanmış

Parametre nonce (minimum 1, maksimum 2147483646) her yeni istekte, önceki istekteki değerden büyük olmalıdır.
nonce'yı sıfırlamak için yeni anahtar oluşturmanız gerekir.

getInfo

Yöntem, kullanıcının bakiyeleri ve API anahtarı ayrıcalıkları ile sunucu zamanı hakkında bilgi döndürür.

Gereksinimler: anahtar ayrıcalığı info

Parametreler: mevcut değil

Cevap örneği:

{
	"success":1,
	"return":{
		"funds":{
			"ltc":22,
			"nvc":423.998,
			"ppc":10,
			...
		},
		"funds_incl_orders":{
			"ltc":32,
			"nvc":523.998,
			"ppc":20,
			...
		},	
		"rights":{
			"info":1,
			"trade":0,
			"withdraw":0
		},
		"transaction_count":0,
		"open_orders":1,
		"server_time":1418654530
	}
}

• funds: kullanılabilir hesap bakiyesi (açık siparişlerdeki para hariç)
• funds_incl_orders: kullanılabilir hesap bakiyesi (açık siparişlerdeki para dahil)
• rights: anahtar ayrıcalıkları. withdraw kullanılmıyor (rezerve edildi)
• transaction_count: her zaman 0 (eski)
• open_orders: her zaman 0 (eski)
• server_time: sunucu saati

Trade

Borsada işlem yapmak için yeni siparişlerin oluşturulma yöntemi

Gereksinimler: anahtar ayrıcalıkları info&trade

Parametreler:

• pair: çift (örnek: ltc_btc)
• type: işlem türü (örnek: buy veya sell)
• rate: satın almak veya satmak için kuru (değer: sayısal)
• amount: alınacak veya satılacak miktar (değerler: sayısal)

Cevap örneği:

{
	"success":1,
	"return":{
		"received":0.1,
		"remains":0,
		"order_id":12345,
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• received: ne kadar döviz alınıp satıldı
• remains: alım/satım için ne kadar döviz kaldı
• order_id: oluşturulan siparişin ID
• funds: talepten sonra güncel bakiyeler

ActiveOrders

Yöntem, kullanıcının aktif siparişlerinin listesini döndürür

Gereksinimler: anahtar ayrıcalığı info

Parametreler:

• pair: çift (örnek: ltc_btc)

Cevap örneği:

{
	"success":1,
	"return":{
		"100025362":{
			"pair":"ltc_btc",
			"type":"sell",
			"amount":21.615,
			"rate":0.258,
			"timestamp_created":1418654530,
			"status":0
		},
		...
	}
}

• dizi anahtarları: Siparişlerin ID (örnekte: 100025362)
• pair: çift (örnek: ltc_btc)
• type: işlem türü (örnek: buy veya sell)
• amount: satın almak veya satmak için kalan
• rate: alış veya satış fiyatı
• timestamp_created: sipariş oluşturma zamanı
• status: her zaman 0 (eski)

OrderInfo

Yöntem, belirtilen sipariş hakkında ayrıntılı bilgi döndürür

Gereksinimler: anahtar ayrıcalığı info

Parametler:

• order_id: sipariş ID (değerler: sayısal)

Cevap örneği:

{
	"success":1,
	"return":{
		"100025362":{
			"pair":ltc_btc,
			"type":sell,
			"start_amount":13.345,
			"amount":12.345,
			"rate":485,
			"timestamp_created":1418654530,
			"status":0
		}
	}
}

• dizi anahtarı: sipariş ID (örnekte: 100025362)
• pair: sipariş çifti (örnek: ltc_btc)
• type: sipariş türü (örnek: buy veya sell)
• start_amount: oluştururken ilk sipariş tutarı
• amount: siparişe göre satın almak veya satmak için kalan
• rate: alış veya satış fiyatı
• timestamp_created: sipariş oluşturma zamanı
• status: 0 - aktif, 1 - tamamlandı ve kapatıldı, 2 - iptal edildi, 3 - iptal edildi, ama kısmen tamamlandı.

CancelOrder

Yöntem belirtilen siparişi iptal eder

Gereksinimler: anahtar ayrıcalıklar info&trade

Parametreler:

• order_id: sipariş ID (değerler: sayısal)

Cevap örneği:

{
	"success":1,
	"return":{
		"order_id":100025362,
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• order_id: sipariş ID
• funds: talepten sonra güncel bakiyeler

TradeHistory

Yöntem işlemlerin geçmişini döndürür.

Gereksinimler: anahtar ayrıcalığı info

Parametreler:

• from: çekme işleminin başlatılacağı işlem numarası (değerler: sayısal, varsayılan: 0)
• count: çekme işlemlerin sayısı (değerler: sayısal, varsayılan: 1000)
• from_id: çekme işleminin başlatılacağı işlemin ID (değerler: sayısal, varsayılan: 0)
• end_id: çekme işleminin sonlandırılacağı işlemin ID (değerler: sayısal, varsayılan: ∞)
• order: çekme esnasında sıralama (değerler: ASC veya DESC, varsayılan: DESC)
• since: çekme işlemlerine ne zaman başlamalı (değerler: unix time, varsayılan: 0)
• end: çekme işlemlerine ne zaman son verilmeli (değerler: unix time, varsayılan: ∞)
• pair: çift (örnek: ltc_btc)

Parametleri kullanıldığında since veya end, parametre order otomatik olarak değeri alır ASC.

Parametre kullanıldığında since, geçmişi alabileceğiniz maksimum tarih - bir hafta önce.

Cevap örneği:

{
	"success":1,
	"return":{
		"24523":{
			"pair":"ltc_btc",
			"type":"sell",
			"amount":11.4,
			"rate":0.145,
			"order_id":100025362,
			"is_your_order":1,
			"timestamp":1418654530
		}
		...
	}
}

• dizi anahtarları: işlemlerin ID (örnekte: 24523)
• pair: çift (örnek: ltc_btc)
• type: işlem türü (örnek: buy veya sell)
• amount: satın alınan veya satılan miktar
• rate: alış veya satış fiyatı
• order_id: sipariş ID
• is_your_order: sipariş size mi ait (1 veya 0)
• timestamp: işlem saati

GetDepositAddress

Yöntem yatırma adresini döndürür.

Gereksinimler: anahtar ayrıcalığı deposits

Parametreler:

• coinName: para birimi ticker (örnek: BTC)
• need_new: value: 0 veya 1, varsayılan: 0

Cevap örneği:

{
	"success":1,
	"return":{
		"address": 1UHAnAWvxDB9XXETsi7z483zRRBmcUZxb3,
		"processed_amount": 1.00000000,		
		"server_time": 1437146228
	}
}

WithdrawCoinsToAddress

Yöntem para çekme talebi oluşturur.

Gereksinimler: anahtar ayrıcalığı withdrawals

Parametler:

• coinName: para birimi ticker (örnek: BTC)
• amount: çekilecek tutar
• address: alıcı adresi

Cevap örneği:

{
	"success":1,
	"return":{
		"server_time": 1437146228
	}
}

CreateYobicode

Yöntem Yobicodes (kuponlar) oluşturmak için yönelmiştir.

Yöntemin alternatif oluşumu: CreateCoupon

Gereksinimler: anahtar ayrıcalığı withdrawals

Parametreler:

• currency: para birimi ticker (örnek: BTC)
• amount: yobicode tutarı

Cevap örneği:

{
	"success":1,
	"return":{
		"coupon": "YOBITUZ0HHSTBCOH5F6EAOENCRD8RGOQX3H01BTC",
		"transID": 1,	
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• coupon: Yobicode
• transID: diğer borsaların api'si ile uygunluk için her zaman 1
• funds: talepten sonra güncel bakiyeler

RedeemYobicode

Yobicodes (kuponlar) kapama yöntemi.

Yöntemin alternatif oluşumu: RedeemCoupon

Gereksinimler: anahtar ayrıcalığı deposits

Parametreler:

• coupon: yobicode yatırmak için (örnek: YOBITUZ0HHSTB...OQX3H01BTC)

Cevap örneği:

{
	"success":1,
	"return":{
		"couponAmount": "1.2345",
		"couponCurrency": "BTC",
		"transID": 1,	
		"funds":{
			"btc":15,
			"ltc":51.82,
			"nvc":0,
			...
		}
	}
}

• couponAmount: Yatırılmış tutar.
• couponCurrency: Yatırılmış yobicode para birimi.
• transID: diğer borsaların api'si ile uygunluk için her zaman 1
• funds: talepten sonra güncel bakiyeler

Defi Public API

Tüm havuzlar hakkında bilgi isteme örneği::
https://yobit.net/api/defi/info

Belirli havuzlar hakkında bilgi isteme örneği:
https://yobit.net/api/defi/info/btc_usdt-yo_btc

Cevap örneği:

{
	"server_time":1418654531,
	"pools":{
		"usdt_spitz":{
			"liq1":"45540230.71160736",
			"liq2":"230.12172671",
			"price1":"0.00000505",
			"price2":"197896.26717427",
			"fee":"0.003",
			"price24high1":"0.00000512",
			"price24low1":"0.00000505",
			"price24high2":"197898.16740049",			
			"price24low2":"195199.11794729",
			"vol1":"47.57434935",			
			"vol2":"2.61017416",
			"algo1":"erc20",
			"tokenid1":"0xdac17f958d2ee523a2206206994597c13d831ec7",
			"algo2":"bep20",
			"tokenid2":"0x9d1d63501e3490aeedf0dba24f60c29918caf965",

		}
		...
	}
}

• liq1: likidite sağlayıcıları havuza 1 para birimi yatırdı
• liq2: likidite sağlayıcıları havuza 2 para birimi yatırdı
• price1: güncel price 1
• price2: güncel price 2
• fee: komisyon % (0.
• price24high1: son 24 saat için en yüksek price 1
• price24low1: son 24 saat için en düşük price 1
• price24high2: son 24 saat için en yüksek price 2
• price24low2: son 24 saat için en düşük price 2
• vol1: son 24 saat içinde 1 para birimindeki değiş tokuş hacmi
• vol2: son 24 saat içinde 2 para birimindeki değiş tokuş hacmi
• algo1: erc20, trc20, bep20 veya SHA256/Scrypt/X11
• tokenid1: 1 para birimi için token adres erc20, trc20, bep20 algoritmalar için ya da diğerler için boş
• algo2: erc20, trc20, bep20 or SHA256/Scrypt/X11
• tokenid2: 2 para birimi için token adres erc20, trc20, bep20 algoritmalar için ya da diğerler için boş

Gizlenen havuzlar borsanın ana sayfasındaki listede görüntülenmez.
Herhangi bir havuz devre dışı bıraktığınızda listeden kaybolur.

DefiSwapInfo

Gereksinimler: anahtar ayrıcalığı info&trade

Parametreler:

• pool: cur1_cur2 formatında havuz adı (örnek: btc_usdt)
• PayCurrency: değiş tokuşunda verdiğiniz para birimi. cur1 veya cur2 olmalıdır (örnek: usdt)
• PayAmount: değiş tokuşunda verdiğiniz para birimi (örnek: 1.123)

Cevap örneği:

{
	"success":1,
	"swap_made":0,
	"info":{
		"desc": "SWAP 1.12300000 USDT to 0.00002567 BTC with price 43732.86034952",
		"pay_amount": "1.12300000",
		"pay_currency": "USDT",
		"get_amount": "0.00002567",
		"get_currency": "BTC",
		"price_of_swap": "43732.86034952",
		"fee_total": "0.00000007",
		"fee_total_currency": "BTC",
		"price1_before": "43601.61783433",
		"price1_after": "43601.70585432",
		"price2_before": "0.00002293",
		"price2_after": "0.00002294",
	}
}

• swap_made: her zaman 0'dır. Değiş tokuş işleminin gerçekleştirilmediğini gösterir.
• pay_amount: değiş tokuşunda verdiğiniz para birimi
• pay_currency: değiş tokuşunda verdiğiniz para birimi
• get_amount: değiş tokuşunda aldığınız para birimi
• get_currency: değiş tokuşunda aldığınız para birimi
• price_of_swap: değiş tokuş tutarı (
• fee_total: komisyon tutarı
• fee_total_currency: komisyon para birimi
• price1_before: değiş tokuş'tan önce 1 havuzun geçerli fiyatı
• price1_after: değiş tokuş'tan önce 2 havuzun geçerli fiyatı
• price2_before: değiş tokuş'tan sonra 1 havuzun fiyatının ne olacağını gösterir
• price2_after: değiş tokuş'tan sonra 2 havuzun fiyatının ne olacağını gösterir

DefiSwap

Yöntem Defi (Swaps) değiş tokuşları yapmak için tasarlanmıştır.

Gereksinimler: anahtar ayrıcalığı info&trade

Parametler:

• pool: cur1_cur2 formatında havuz adı (örnek: btc_usdt)
• PayCurrency: değiş tokuşunda verdiğiniz para birimi. cur1 veya cur2 olmalıdır (örnek: usdt)
• PayAmount: değiş tokuşunda verdiğiniz para birimi (örnek: 1.123)

Cevap örneği:

{
	"success":1,
	"swap_made":0,
	"info":{
		"desc": "SWAP 1.12300000 USDT to 0.00002567 BTC with price 43732.86034952",
		"pay_amount": "1.12300000",
		"pay_currency": "USDT",
		"get_amount": "0.00002567",
		"get_currency": "BTC",
		"price_of_swap": "43732.86034952",
		"fee_total": "0.00000007",
		"fee_total_currency": "BTC",
		"price1_before": "43601.61783433",
		"price1_after": "43601.70585432",
		"price2_before": "0.00002293",
		"price2_after": "0.00002294",
	},
	"user":{
		"new_balance1": "12.07789855",
		"new_balance1_currency": "BTC",
		"new_balance2": "497908.66928976",
		"new_balance2_currency": "USDT",
		"pooled1": "1.07518709",
		"pooled2": "46729.28782075",
		"pooled_est": "$93,233.91955017",
		"pooled_pr": "2.1456",
		"comfee1": "4.1894",
		"comfee2": "625.3309128",
		"comfee_est": "$1,207.09775086",
	}	
}

• pay_amount: değiş tokuş sırasında verdiğiniz tutarı
• pay_currency: değiş tokuş sırasında verdiğiniz tutarı
• get_amount: değiş tokuş sırasında aldığınız tutar
• get_currency: değiş tokuş sırasında aldığınız para birimi
• price_of_swap: değiş tokuş tutarı (
• fee_total: komisyon tutarı
• fee_total_currency: komisyon para birimi
• price1_before: değiş tokuş'tan önce 1 havuz tutarı
• price1_after: değiş tokuş'tan önce 2 havuz tutarı
• price2_before: değiş tokuş'tan sonra 1 havuzun tutarı
• price2_after: değiş tokuş'tan sonra 2 havuzun tutarı
• new_balance1: değiş tokuş'tan sonra 1 para biriminin yeni bakiyeniz
• new_balance1_currency: para birimi adı 1
• new_balance2: değiş tokuş'tan son ra 2 para biriminin yeni bakiyeniz
• new_balance2_currency: 2 para birimi adı
• pooled1: likidite havuzundaki 1 para biriminizin parçası
• pooled2: likidite havuzundaki 2 para biriminizin parçası
• pooled_est: yaklaşık miktar pooled1+pooled2 USD'da
• pooled_pr: likidite havuz yüzdeniz (örnek: 2.1456, likidite havuzunun %2.1456'sı anlamına gelir)
• comfee1: kazanılan komisyon (toplam 1 para biriminde)
• comfee2: kazanılan komisyon (toplam 2 para biriminde)
• comfee_est: yaklaşık tutar comfee1+comfee2 USD'da