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:
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:
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
p>Yöntem, DefiSwap işleviyle yapılmadan önce olası bir Swap hakkında bilgi elde etmek için tasarlanmıştır.
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
gauravchawla: hey dom