Başlarken
0x API paketi, uygulamanızda daha hızlı ticareti, daha iyi fiyatları ve üstün UX’i etkinleştirmenin en basit yoludur. Başlamak için, yeni projeler için API anahtarları oluşturmak, entegrasyonları izlemek ve yönetmek, yeni API’lere erişmek ve daha fazla geliştirici kaynağından yararlanmak üzere 0x Dashboard’a erişmek için bir hesap oluşturmanız gerekir.
5 dakikadan kısa sürede başlamak için bu adımları izleyin!
1. Bir 0x Hesabı Oluşturun
0x Dashboard üzerinde bir hesap oluşturmak için Sign Up’a tıklayın, adınızı, e-posta adresinizi ve şifrenizi girin ve Continue’ya tıklayın.
2. Bir Takım Oluşturun
Doğrulandıktan sonra, 0x üzerinde bir takım oluşturmanız istenecektir. Bir takım adına karar verin ve oluşturduğunuz projenin türünü seçin. Bu hesabı ekip arkadaşlarınızla paylaşabilirsiniz.
3. Dashboard’u Gezin
3.1 Test API Anahtarı
Bir takım oluşturduktan sonra, canlı API anahtarları oluşturup yönetebileceğiniz, geliştirme kaynakları bulabileceğiniz ve destek talepleri oluşturabileceğiniz 0x Dashboard’a yönlendirileceksiniz.
0x tarafından desteklenen tüm ağların listesini bulmak için 0x Cheat Sheet sayfamıza göz atın.
Dashboard’unuz, örnek istekler yapmak için kullanabileceğiniz bir Test API anahtarı ile birlikte gelir. Canlı bir Swap API fiyat teklifi (quote) isteği görmek için bunu curl isteğine ekleyip CLI’ınızdan çalıştırarak deneyin:
// Replace the API key in the header with your sample key
curl —location —request GET ‘https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber’ —header ‘0x-api-key: [api-key]’
3.2 Bir Uygulama Oluşturun
Birden fazla 0x ürününe erişimi olan canlı bir API anahtarı almak için Create an app’e tıklayın.
Açılır pencereden uygulamanızın adını ve bu API anahtarı için hangi 0x ürünlerinin (Swap API, Orderbook API) etkinleştirilmesi gerektiğini girin, ardından Continue’ya tıklayın.
Not: Uygulama oluşturulduktan sonra bile bu anahtarın kilidini açabileceği 0x ürünlerini güncelleyebilirsiniz.
3.3 0x Explorer Etiketi Ekleme
Bir sonraki ekranda, uygulamanızdan gelen işlem verilerini 0x Explorer üzerinde tanımlamak için kullanılabilecek benzersiz bir etiket ekleyebilirsiniz. Tüm uygulamalarınız için aynı etiketi kullanabilir veya her biri için ayrı bir etiket oluşturabilirsiniz.
0x Explorer, 0x API aracılığıyla yönlendirilen ERC-20 işlemleri hakkında veri sağlar. Geliştiricilerin ve kullanıcıların işlemleri doğrulamasına ve zincir üstü (on-chain) faaliyetleri kolay ve düşük sürtünmeli bir şekilde analiz etmesine yardımcı olan güvenilir ve şeffaf bir araçtır.
0x Explorer Etiketleri hakkında daha fazla bilgi edinin.
Şimdilik atlayabilir ve daha sonra bir etiket ekleyebilirsiniz.
3.4 API Anahtarınızı Gösterin
Son ekranda, API anahtarınızı kopyalayın! Bu anahtar benzersizdir ve uygulamanıza bağlıdır. Paylaşmayın. İhtiyacınız olursa uygulama için ek API anahtarları da oluşturabilirsiniz.
API anahtarlarınız, 0x üzerindeki istekleri doğrulamanızı sağlayacaktır. İsteklerinizde anahtarı 0x-api-key başlık parametresi aracılığıyla belirtmeyi unutmayın:
Bu anahtar, 0x üzerindeki istekleri doğrulamanızı sağlayacaktır. İsteklerinizde anahtarı 0x-api-key başlık parametresi aracılığıyla belirtmeyi unutmayın:
// Replace the API key in the header with your sample key
curl —location —request GET ‘https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber’ —header ‘0x-api-key: [api-key]’
4. Uygulamanızı Yönetin
Ana dashboard ekranından, oluşturduğunuz tüm uygulamaları görebilirsiniz:
Detaylarını açmak için bir Uygulamaya tıklayın.
Her Uygulama için aşağıdakileri görebilirsiniz:
-
API anahtarınız için hangi 0x ürünlerinin etkinleştirildiğini görün - Swap API ve/veya Orderbook API.
-
API Key kısmından, bu uygulamayla ilişkili tüm API anahtarlarını görün ve yeni anahtarlar oluşturun veya silin. Settings kısmından, bu uygulama için etkinleştirilen 0x ürünlerini değiştirin. 0x Explorer Tag’inizi ayarlayın. App Name’i değiştirin.
-
Eğer bir 0x Explorer Etiketi ayarladıysanız, bu uygulamayla ilgili zincir üstü verilerinizi ve işlemlerinizi görüntüleyebilirsiniz.
-
Geliştirme kaynaklarını görüntüleyin.
5. Hesabınızı Yönetin
Hesabınızı yönetmek için ek ayarları sağ üst köşedeki Hesap Profil Resminizden bulabilirsiniz.
-
Settings - Tam adınızı, takım adınızı ve hesap e-postanızı görebilir, ayrıca şifrenizi değiştirebilirsiniz.
-
Contact Support - Bir sorunuz mu var? Geliştirici destek ekibimizle iletişime geçin.
-
Docs - Geliştirici dokümantasyonumuza göz atın ve geliştirmeye başlayın.
-
Help - Yardıma mı ihtiyacınız var? Sıkça sorulan sorularımıza ve yardım merkezimize göz atın.
-
0x Explorer - Eğer bir 0x Explorer etiketiniz varsa, uygulamanızın zincir üstü faaliyetlerini ve işlemlerini kolayca analiz edin. 0x Explorer Etiketi hakkında daha fazla bilgi edinin.
6. Bir Sorunuz mu Var?
0x Dashboard’a giriş yaptıysanız, dashboard’un sağ alt köşesindeki Geliştirici Desteği için Intercom Messenger aracılığıyla ekibimizle doğrudan iletişim kurabilirsiniz.
7. Geliştirmeye Başlayın
Artık canlı bir API anahtarınız olduğuna göre, geliştirme kaynaklarımıza dalın ve geliştirmeye başlayın!
0x’e Giriş
İPUCU
Bunun yerine bir video izlemeyi mi tercih edersiniz? 0x Konsept Videoları bölümüne geçin.
0x Nedir?
0x, geliştiricilerin kripto altyapısı üzerinde finansal ürünler oluşturması için tek noktadan hizmet sunan bir merkezdir. 0x, daha hızlı ticareti, daha iyi fiyatları ve üstün UX’i etkinleştirmek için yüzlerce geliştiriciyi temel web3 araçlarıyla güçlendirir. API paketimiz, Coinbase Wallet, Robinhood Wallet, Metamask, Zerion, Zapper ve daha fazlası gibi uygulamalarda işlem yapan 6 milyondan fazla kullanıcıdan 52 milyondan fazla işlemi ve $125B hacmi işlemiştir.
İPUCU
ELI5 0x (5 Yaşındaymışım Gibi 0x’i Açıkla)
0x, insanların oyuncaklar, şekerler ve çıkartmalar gibi farklı şeyleri takas edebileceği büyük bir oyun parkı gibidir. Ancak oyuncak ve şeker yerine kripto para birimleri gibi dijital varlıkları takas ederler. Bu oyun parkında iki tür insan vardır: takas etmek için bir şeyler getirenler (onlara Maker diyoruz) ve bu şeyleri almak için takas etmek isteyenler (onlara Taker diyoruz). 0x, bu insanların birbirini bulmasına ve güvenli, adil bir şekilde takas yapmasına yardımcı olur. Herkesin kurallara göre oynadığından emin olmak için oyun parkını izleyen bir yetişkin olması gibidir.
0x Ekosistemi
0x Teknoloji Yığını
0x’in profesyonel düzeydeki API’leri, güvenli ve denetlenmiş akıllı sözleşmelerden oluşan bir set olan 0x Protocol üzerine kurulmuştur. Bu araçlar üzerinde geliştirme yapan uygulamalar 0x Ekosisteminin bir parçasıdır.
Aşağıdaki diyagram, likidite sağlayan uygulamaları (Makers) ve likidite talep eden uygulamaları (Takers) içeren 0x Ekosistemine genel bir bakış sunmaktadır.
Maker’lar ve Taker’lar
0x Ekosistemi içinde iki taraf vardır - Maker’lar ve Taker’lar:
Arz (diğer adıyla Makers)
Bu, 0x emirleri (orders) oluşturan ve Talep tarafının (Takers) tüketmesi için sisteme likidite sağlayan varlıktır. 0x, aşağıdakiler dahil olmak üzere birden fazla kaynaktan likidite toplar:
-
Zincir üstü (on-chain) likidite - DEX’ler, AMM’ler (örn. Uniswap, Curve, Bancor)
-
Zincir dışı (off-chain) likidite - Profesyonel Piyasa Yapıcılar (Market Makers), 0x’in Open Orderbook ağı
-
İlgili Dokümanlar:
-
Market Makers - Limit Emirleri ile Profesyonel Piyasa Yapıcılığı
-
Orderbook API - Limit Emirlerini Paylaşma
-
Limit Orders (Advanced Traders) - Limit Emirlerini Gerçekleştirme ve Yönetme
Talep (diğer adıyla Takers)
Bu, Maker’ın varlığını isteyen varlıktır. Taker’lar kendi varlıklarını Maker’ın varlığıyla takas etmeyi kabul ederler; başka bir deyişle, 0x likiditesini tüketirler. Örnekler arasında MetaMask, Coinbase ve dydx gibi projeler yer alır.
-
İlgili Dokümanlar:
-
Swap API - Tek bir API aracılığıyla ERC20 tokenleri için en verimli likidite toplayıcı.
0x Nasıl Çalışır?
Bir 0x emrinin nasıl yürütüldüğüne bakalım.
-
Bir Maker, standart bir emir mesajı formatına uygun bir json nesnesi olan bir 0x emri oluşturur (tüm 0x emir türlerinin listesini burada bulabilirsiniz). Bu emir, Maker’ın hangi varlığı takas etmeyi taahhüt ettiğini belirtir. Varlıklar arasında fungible tokenler (ERC20), non-fungible tokenler (ERC721) veya varlık paketleri (ERC1155) bulunabilir.
-
Emrin hash’i alınır ve Maker, yazdığı emri kriptografik olarak taahhüt etmek için emri imzalar.
-
Emir karşı taraflarla paylaşılır.
-
0x emrinin Maker’ı istediği karşı tarafı zaten biliyorsa, emri doğrudan gönderebilir (e-posta, sohbet veya tezgah üstü/OTC platformu aracılığıyla).
-
Maker takası kabul etmeye istekli bir karşı taraf bilmiyorsa, emri orderbook’a gönderebilir.
-
0x API, Taker için emrin en iyi fiyatını ortaya çıkarmak amacıyla tüm arz kaynakları genelinde likiditeyi toplar. 0x, yatırımcıların zincir dışı iletme ve zincir içi uzlaşma (off-chain relay and on-chain settlement) paradigması aracılığıyla 0x emirleri oluşturmasına, bulmasına ve gerçekleştirmesine yardımcı olur. Bu, 0x’in emirleri blokzincirinde saklamadığı anlamına gelir; bunun yerine emirler zincir dışında saklanır ve işlem uzlaşması yalnızca zincir üzerinde gerçekleşir. Bu benzersiz özellik, 0x’i geliştiricilerin üzerinde çalışabileceği esnek ve gas tasarruflu bir DEX protokolü haline getirir.
-
Taker, emri ve gerçekleştireceği miktarı blokzincirine göndererek 0x emrini gerçekleştirir.
-
0x Protokolünün uzlaşma mantığı, Maker’ın dijital imzasını ve işlemin tüm koşullarının karşılandığını doğrular. Eğer karşılanmışsa, ilgili varlıklar Maker ve Taker arasında atomik olarak takas edilir. Aksi takdirde işlem iptal edilir (revert edilir).
0x Üzerinde Ne İnşa Edebilirim?
Aşağıda, 0x üzerinde inşa edilmiş projelerin kapsamlı olmayan bir listesi bulunmaktadır. 0x’in, değiş tokuşun uygulamanın temel amacı olmadığı mevcut herhangi bir uygulamaya da entegre edilebileceğini unutmayın. Daha fazla örnek için bu blog yazısına göz atabilirsiniz.
Talep (Takers)
-
Borsalar
-
Y piyasasında X varlığı için merkeziyetsiz bir borsa
-
Dijital ürünler için Ebay tarzı bir pazar yeri
-
Bir tezgah üstü (OTC) alım satım platformu
-
Cüzdanlar
-
Kullanıcıları token takas etmek isteyen dijital cüzdanlar
-
Opsiyonlar ve türev ürünler platformu
-
Çalışması için likidite ve takasa ihtiyaç duyan bir DeFi protokolü (örn. bir türev, borç verme veya opsiyon protokolü)
-
Portföy yöneticileri
-
Tahmin piyasaları
-
Non-fungible tokens (NFT) Borsası
-
NFT pazar yeri
-
Oyun içi para birimlerine veya öğelere sahip oyunlar
-
Yatırım stratejileri (örn. DeFi endeks fonları, DCA uygulamaları)
-
Veri
-
0x çok zincirli analiz portalı
-
GraphQL sarmalayıcıları (wrappers) ile gerçek zamanlı işlemler paneli
Arz (Makers)
-
Orderbook modelleri
-
Otomatik Piyasa Yapıcı (AMM) modelleri
-
Piyasa Yapıcılar
-
Bir piyasa yapıcı veya arbitraj ticaret botu
Rehberler
Bu sayfa, kullanım durumunuza göre 0x ile geliştirmeye başlamak için en popüler rehberleri listeler
Swap API
Tek bir API ile uygulamanıza kolayca likidite toplama özelliği ekleyin. Swap API ile 100’den fazla borsaya ve binlerce tokene erişin.
Kod Örnekleri
-
(Next.js) 0x Demo Uygulaması - 0x Swap API, Next.js ve ConnectKit ile yapılmış örnek ERC20 takas uygulaması
-
https://github.com/0xProject/0x-starter-project - Çalıştırılabilir örnekler koleksiyonu aracılığıyla 0x v4 protokolünü gösteren bir proje.
Eğitimler
-
Swap API Nasıl Kullanılır - Bu rehber size programlı olarak bir ERC20 token işlemini nasıl gerçekleştireceğinizi öğretecektir.
-
Next.js, 0x, ConnectKit ile Token Takas Dapp’i İnşa Edin - Herhangi bir token takas dapp’i oluştururken önemli olan temel geliştirici kavramlarını kapsayan görüntülü anlatım.
-
0x API ile Token Takas dApp’i Nasıl Oluşturulur - Swap API kullanarak bir token takas dapp’i (basit bir Matcha.xyz) oluşturmaya yönelik yazılı ve görüntülü içerik. Bu dApp, daha geniş DEX ekosistemindeki likiditeyi toplar ve kullanıcıya en iyi fiyatı sunar.
-
Akıllı Sözleşmelerinizde 0x API Likiditesini Kullanın - Bu rehber size bir akıllı sözleşme içinden 0x API swap fiyat tekliflerini nasıl tüketeceğinizi öğretecektir.
-
Testnet’te Çalışmak - 0x API ile ERC20 token takasını test etmenin iki yolunu öğrenin: Goerli testnet’ini kullanmak veya Ethereum ana ağını (mainnet) kendi testnet’inize çatallamak (fork). Çalıştırılabilir bir örnek içerir.