Sorumluluk Reddi Beyanı

API endpoint’lerimize dair eski sistemlerle uyumluluk garantisi veremeyiz. Bu belgeyi, API’mizi tam anlamıyla sunmadan önce bir deneme olarak, yalnızca doğrudan API erişimine yönelik yüksek talep olduğu için yayımlıyoruz. Bununla birlikte, API’mizi kullanan herkese yardım etmek için elimizden geleni yapmaya çalışacağız. Altyapınıza API’i önemli ölçüde entegre ettiyseniz, potansiyel büyük değişiklikler için önceden haber verebilmemiz açısından lütfen bizi bilgilendirin.

Doğrulama

Arkham’ın API’si ile doğrulama yapabilmek için ihtiyacınız olan tek şey, talebinizin başlığına geçerli bir API anahtarı eklemeniz. Başlık anahtarı: API-Key. Kullanıcı arayüzümüz veya API’miz aracılığıyla bir API anahtarı oluşturmak şu an mümkün değil, o yüzden bu anahtarları bizim göndermemiz gerekiyor. API anahtarı istediğinizde lütfen bize ulaşın.

Endpoint’ler

Kök URL adresimiz: https://api.arkhamintelligence.com.

API’mize gelen talep sıklığı, saniyede 5 talep ile sınırlıdır ama bunun üzerine çıkıldığında ufak bir ilave de kabul edilir. Gelecekte bu sınırı düşürebiliriz. Aslında bunun epey altında olmasını hedefliyoruz.

Endpoint’ler burada sıralananlarla sınırlı değil. Talep geldikçe daha fazla ekleyebiliriz.

GET /transfers

Aşağıdakiler sorgu parametlerimiz

• base
  • Tür: string[]
  • Gerekli
  • Görmek istediğiniz işlemlerin girdiği veya çıktığı kuruluşlar/adresler
  • Adres veya kuruluş ID’si olmalı (kuruluşların sayfa url’sinden kuruluş ID’lerini bulabilirsiniz). Bünyemizdeki tüm kuruluş ID’lerinin bir listesini erişime açmadık ama ismini biliyorsanız sadece arama çubuğundan da bu veriyi elde edebilirsiniz. Genellikle isimlerinin birleştirilmiş bir versiyonu oluyor. Alameda Research -> alameda-research gibi.
  • Birkaç tane birden aramak için aralarına virgül ekleyin. Adresleri ve kuruluşları karışık bile yazabilirsiniz. Örnek:
    • ftx
    • ftx,binance
    • 0x123...,0x456...,alameda-research
  • Bir kuruluş oluşturursanız ID’sini buradan da gönderebilirsiniz.
• chains
  • Tür: string[]
  • Yazılmayabilir. Boş bırakıldığında tüm zincirleri gösterir
  • Desteklenen zincirler: ethereum, bsc, polygon, arbitrum_one, avalanche, optimism, bitcoin, tron, base, flare.
• flow
  • Tür: "in" | "out" | "all"
  • Varsayılan: all
  • Akış burda base ile ilgili. Yani örneğin out opsiyonunu seçerseniz, diğer filtreleriniz ne olursa olsun yalnızca base’den gelen işlemleri görürsünüz.
• from
  • Tür: string[]
  • Yalnızca belli kuruluşların/adreslerin işlerimleri için filtre. Birkaç tane birden aratırsanız, base’de belirtilen kuruluşların/adreslerin herhangi birinden kuruluşların/adreslerin herhangi birine yapılan işlemleri görürsünüz.
  • Kuruluş ID’lerine ve adreslerine ek olarak (aynı base’de olduğu gibi) gelen işlemler için kuruluş türlerini ve sistem ID’lerini de dahil edebilirsiniz. Örnek:
    • type:cex ile merkezi sistemlerden gelen tüm işlemleri görürsünüz.
    • deposit:binance ile Binance adreslerine gelen tüm işlemleri görürsünüz. Burada yalnızca sistem değil, bir yatırım adresi düzeni kullanan herhangi bir kuruluş için ID gönderebilirsiniz (uyum platformları, OTC’ler, bahis siteleri vb). Bir kuruluşun sıcak cüzdanı olduğunu tespit ettiğimizde buraya gelen işlemleri otomatik olarak etiketlemeye başlıyoruz. Bu şekilde kolayca sorgulayabilirsiniz.
    • deposit:all ile herhangi bir adrese gelen işlemleri görürsünüz.
  • Bir seçeneğin başına ! eklerseniz, o seçeneği çıkarır. Örneğin; type:cex,!binance sorgusu “Binance dışındaki diğer merkezi sistemlere gelen işlemler” sonucunu verir. Bu seçenek tüm türler, kuruluşlar ve adresler için geçerli olsa da kuruluş ID’lerini kapsamaz.
  • Tüm pozitif filtrelere VEYA seçeneği dahildir ve tüm negatif filtreler hem birbirine hem de pozitif filtrelere karşı VE karşılaştırması yapar. Yani type:cex,deposit:all,!binance,!huobi sorgusu Huobi ve Binance dışındaki merkezi sistemlere gelen işlemler sonucunu verir.
• to
  • from ile aynı
• tokens
  • Tür: string[]
  • Yalnızca belli token’ları içeren işlemleri filtreler. Fiyatlandırma için CoinGecko’yu kullanıyoruz, bu yüzden bu sorgu CoinGecko ID’leri veya token adresi listesini görüntülüyor.
• timeGte
  • Tür: number (UNIX milisaniye zaman damgalı)
  • Belli bir zamandaki veya daha sonrasındaki block_timstamp işlemleri filtreler.
• timeLte
  • timeGte ile aynı
• timeLast
  • Tür: string
  • Örnek: Son bir saat için 1h, son 3 gün için 3d, son 10 dakika için 10m.
  • Belli bir süre içinde yapılan işlemleri filtreler. Bu süre bir sayı ve süre birimi ile ifade edilir. Aslında timeGte belirlemenin kısa yolu. Desteklenen süre birimleri: s (saniye), m (dakika), h (saat), d (gün), w (hafta), M (ay), y (yıl). Not: d aslında 24h, w aslında 7d, M aslında 30d ve y aslında 365d olarak görüntüleniyor. Bu yüzden artık saniye/yıl dikkate alınmıyor.
  • İşlemler eklenirken gecikebilir, bu yüzden zaman sürenizin yeterince geniş olduğundan emin olun. Örneğin, Ethereum işlemleri gerçekleşmelerinden 1 dakika sonrasına kadar eklenmeyebilir, bu nedenle son 30 saniyeyi sorguladığınızda bu işlemler görünmeyebilir.
• valueGte
  • Tür: number
  • Belli bir token birim değerinin üzerindeki işlemleri filtreler. Birim değerinden kastımız, ondalık haneleri dikkate alındıktan sonraki değer. Ether olarak düşünün, wei değil. Örneğin tokens=ethereum ve valueGte=1 sorgusuyla 10^18 wei değerinde veya daha yüksek ethereum transferlerini görüntülersiniz.
  • Token’ların ondalık haneleri ve USD değerleri birbirinden epey farklı olduğu için bu filtre aslında tek bir token araması yapmadığınız sürece bir işe yaramaz.