Doğrudan ticaret API’leri ile etkileşim kurmak için ham cURL istekleriyle boğuşmaktan, Server-Sent Events (SSE) biçimini elle ayrıştırmaktan ve karmaşık sorgulama döngüleri kurmaktan sıkıldınız mı? Eğer bir PHP geliştiricisi veya Laravel meraklısıysanız, algoritmik ticarete dalmak için hayatınız artık çok daha kolay olacak. Karşınızda coinquant-php, CoinQuant Kamu API’sı için resmi PHP ve Laravel SDK’sı.
CoinQuant, algoritmik ticaret yaklaşımımızı devrim niteliğinde değiştiriyor. Basit İngilizce ile tanımlanan bir ticaret fikrini alıp, ileri düzey yapay zeka kullanarak geri test edilebilir bir stratejiye dönüştürüyor. Ancak, bu güçlü araçları kendi uygulamalarınıza entegre etmek genellikle zorlu bir görevdir. İşte burada coinquant-php devreye giriyor. Bu sağlam SDK, kamu API’sını sarmalayarak, geliştiricilere odaklanmaları gereken önemli konularda, yani kârlı ticaret stratejileri inşa etme konusunda sorunsuz bir deneyim sunuyor.
Bu kapsamlı rehberde, coinquant-php‘nin PHP geliştiricileri için neden bir oyun değiştirici olduğunu keşfedeceğiz, öne çıkan özelliklerine derinlemesine dalacağız ve birkaç dakika içinde nasıl başlamanız gerektiğini göstereceğiz.
CoinQuant PHP’yi Neden Seçmelisiniz?
CoinQuant PHP’yi Neden Seçmelisiniz?
Algoritmik ticaret alanında Python sıkça öne çıksa da, PHP web geliştirme alanında, özellikle Laravel gibi çerçeveler ile güçlü bir araçtır. coinquant-php bu boşluğu kapatıyor ve PHP geliştiricilerinin CoinQuant’ın en son yapay zeka yeteneklerinden faydalanmasını sağlıyor.
1. Modern PHP için Tasarlandı
1. Modern PHP için Tasarlandı
Bu kütüphane, modern PHP çağında tasarlandı. PHP 8.1+ gerektirir ve katı tipleri destekleyerek, kodunuzun sağlam ve eski miraslardan arındırılmasını sağlar. İster bağımsız bir script, ister karmaşık bir kurumsal uygulama inşa ediyor olun, SDK sağlam bir temel sunar.
2. Birinci Sınıf Laravel Entegrasyonu
2. Birinci Sınıf Laravel Entegrasyonu
Laravel 10, 11, 12 veya 13 kullanıyorsanız, işiniz çok kolay. Paket, ServiceProvider ve Facade‘ını otomatik olarak kaydeder, yani manuel bir bağlantı gereksinimi yoktur. Paketi yükleyebilir ve CoinQuant facadesini kontrolörlerinizde, görevlerinizde veya komutlarınızda her yerde kullanmaya başlayabilirsiniz. Ayrıca client, zarif bağımlılık enjeksiyonu için singleton olarak bağlanır.
3. Kapsamlı API Kapsamı
3. Kapsamlı API Kapsamı
SDK, yalnızca temel işlevleri değil, CoinQuant API’sinin tüm 37 kamu uç noktasına erişim sağlar. Bu, sağlık kontrollerini, sohbet etkileşimlerini, strateji oluşturmayı, versiyonlama, geri test etme, raporlar, şablonlar, kredi yönetimi ve hatta liderlik tabloları gibi topluluk özelliklerini içerir. İhtiyacınız olan her şey parmaklarınızın ucunda.
4. Jeneratörler ile Sorunsuz Akış
4. Jeneratörler ile Sorunsuz Akış
CoinQuant’ın en güçlü özelliklerinden biri, Server-Sent Events (SSE) üzerinden tepki veren yapay zeka motorudur. SSE’yi PHP’de yönetmek zorlayıcı olabilir, ancak SDK bu işlemi tamamen soyutlar. Akışı okur ve olayları chat, strategy, report, error veya unknown gibi kategorilere sınıflandırır. Ayrıca, tarayıcıya gerçek zamanlı olarak akış tokenlerini göndermek için doğrudan jeneratör üzerinde yineleme yapabilirsiniz, böylece son derece duyarlı bir kullanıcı deneyimi yaratabilirsiniz.
5. Kolaylaştırılmış Geri Test
5. Kolaylaştırılmış Geri Test
Geri test, algoritmik ticaretin merkezidir ve coinquant-php bunu son derece basit hale getirir. createBacktestAndWait() metodu, çalıştırmayı gönderir, tamamlanana kadar sorgular ve nihai sonuçları derin analiz için CSV dışa aktarımları ile birlikte döndürür.
6. İşlem Yapılabilir Hatalar
6. İşlem Yapılabilir Hatalar
API entegrasyonlarını debug etmek can sıkıcı olabilir, ancak bu SDK ile böyle değil. Herhangi bir 2xx dışı yanıt, HTTP durumu, benzersiz bir request_id, makine tarafından okunabilir bir code ve açıklayıcı bir mesaj taşıyan bir CoinQuantException fırlatır. Bu, hata yönetimini ve sorun gidermeyi oldukça kolaylaştırır.
Başlarken: Sıfırdan Geri Test’e
Başlarken: Sıfırdan Geri Test’e
coinquant-php ile başlamanın ne kadar kolay olduğunu adım adım inceleyelim.
Kurulum
Kurulum
Öncelikle, paketi Composer ile yükleyin. Guzzle, temel HTTP istemcisi otomatik olarak yüklenecektir.
composer require tigusigalpa/coinquant-php
Konfigürasyon
Konfigürasyon
CoinQuant, kimlik doğrulama için bir JWT bearer token kullanır. Bunu CoinQuant web uygulamasındaki Ayarlar menüsünden oluşturabilirsiniz. Bu tokenı bir ortam değişkeninde güvenli bir şekilde saklayın (COINQUANT_TOKEN).
Bağımsız PHP için:
use CoinQuant\CoinQuantClient;
$client = new CoinQuantClient(getenv('COINQUANT_TOKEN'));
$credits = $client->getCredits();
echo "Mevcut krediler: {$credits['available_credits_total']}";
Laravel için, tokenı .env dosyanıza ekleyin:
COINQUANT_TOKEN=your_token_here
Artık facadeyi kullanmaya hazırsınız:
use CoinQuant\Laravel\Facades\CoinQuant;
$credits = CoinQuant::getCredits();
İş Akışı: Fikirden Metriğe
İş Akışı: Fikirden Metriğe
SDK’nın gerçek gücü, bir fikri tam bir geri test edilebilir stratejiye dönüştürdüğünüzde ortaya çıkar. İşte sadece birkaç satır kod ile bir iş akışı:
// 1. Fikri tanımlayın ve yapay zekanın bir strateji geliştirmesine izin verin.
$res = $client->prompt('Long BTCUSDT when price crosses above the 200 EMA on 1h, exit on cross below.');
// 2. Eğer yanıt yalnızca şema ise, biçimlendirin.
$versionId = $res->strategyVersionId
?? $client->finalizeChat($res->chatId, 'EMA 200 Crossover', '')[][];
// 3. Geri testi oluşturun ve sonucu bekleyin.
$outcome = $client->createBacktestAndWait($versionId, 900, 5);
// 4. Sonuçları analiz edin
print_r($outcome[][]);
Bu örnekte, yapay zekaya 200 EMA kesişimi temelinde bir strateji oluşturmasını istiyoruz. SDK, yanıt akışını yönetir, strateji taslağını geri test edilebilir bir sürüme dönüştürür, geri testi çalıştırır ve sonuçları sorgular. Algoritmik ticaret artık son derece erişilebilir hale geliyor.
İleri Düzey Kullanım: Akış ve Özelleştirme
İleri Düzey Kullanım: Akış ve Özelleştirme
Daha fazla kontrol gerektiren geliştiriciler için coinquant-php seçenekler sunuyor.
Gerçek Zamanlı Akış
Gerçek Zamanlı Akış
Eğer bir kullanıcı arayüzü geliştiriyorsanız ve yapay zekanın düşünce sürecini gerçek zamanlı göstermek istiyorsanız, jeneratör üzerinde doğrudan yineleme yapabilirsiniz:
use CoinQuant\Streaming\StreamEvent;
foreach ($client->streamPrompt() as $event) {
if ($event->type === StreamEvent::TYPE_CHAT) {
echo $event->text; // Gerçek zamanlı olarak istemciye akıt
}
}
Özel HTTP İstemcileri
Özel HTTP İstemcileri
SDK’nın altında Guzzle kullanılmaktadır. Yeniden denemeleri yapılandırmak, trafiği bir proxy üzerinden yönlendirmek veya izleme için özel başlıklar eklemek isterseniz, kendi yapılandırılmış Guzzle istemcinizi geçirebilirsiniz:
use GuzzleHttp\Client as GuzzleClient;
$http = new GuzzleClient([
=> ,
=> [=> . getenv()],
]);
$client = new CoinQuantClient(getenv(), );
Sonuç
Sonuç
SDK coinquant-php, geliştirici deneyimi konusunda bir ustalık sınıfıdır. CoinQuant API’sının karmaşıklıklarını, SSE ayrıştırmayı ve asenkron sorgulamayı soyutlayarak, PHP geliştiricilerine olağanüstü hız ve kolaylıkla sofistike ticaret uygulamaları inşa etme gücü sunar.
İster algoritmik ticareti keşfeden bir bağımsız geliştirici olun, ister Laravel üzerinde kapsamlı bir finansal platform inşa eden bir ekip, bu SDK, başarı için ihtiyacınız olan araçları sağlar. Katı tipler, şık Laravel entegrasyonu ve kapsamlı uç nokta kapsama alanı kullanmayı bir zevk haline getirir.
Ticaret fikirlerinizi gerçeğe dönüştürmeye hazır mısınız? GitHub deposuna gidin, bir yıldız verin ve bugün inşa etmeye başlayın!
İyi Kodlamalar ve İyi Ticaretler!
Repo Yazarı: Igor Sazonov (@tigusigalpa) Lisans: MIT
Kaynak: Orijinal Makale


