Yazılım

PHP ile Tam Özellikli Kripto Ticareti: zoomex-php Kütüphanesine Derinlemesine Bakış

Son güncelleme: 16 Mart 2026 05:16

teknomers

Paylaş

Paylaş

Giriş

<p>Kripto para ticareti dünyası hızlı ve karmaşık bir yapıya sahiptir. Ticaret botları, analiz araçları veya özel entegrasyonlar geliştirmek isteyen yazılımcılar için güvenilir ve kullanımı kolay bir API istemcisi kritik öneme sahiptir. Birçok borsa API sunuyor olsa da, bunların arasında gezinmek karmaşık kimlik doğrulama şemaları, oran sınırlamaları ve ham JSON yanıtları ile zorlayıcı olabilir.</p>

<p>İşte burada SDK'lar (Yazılım Geliştirme Kitleri) devreye giriyor ve ihtiyaç duyulan soyutlama katmanını sağlıyor. Bugün, <code>zoomex-php</code> [1] üzerine derinlemesine bir inceleme yapacağız; bu, Zoomex kripto borsa API v3 [2] için yeni ve tam özellikli bir PHP/Laravel SDK'sıdır. İster tecrübeli bir algo-ticaretçi olun, ister kripto alanına adım atan bir PHP geliştiricisi, bu kütüphane işinizi kolaylaştırmak için tasarlandı.</p>

<p>Zoomex, yüksek performansı ile tanınan hızla büyüyen bir kripto para borsasıdır ve saniyede yüksek işlem hacimlerini yönetebilen bir ticaret motoru sunmaktadır [3]. Geliştiriciler için Zoomex API v3, piyasa verilerine, ticaret ve hesap yönetim özelliklerine kapsamlı erişim sağlar.</p>

<h2>
    <a name="whats-inside-a-featurerich-sdk" href="#whats-inside-a-featurerich-sdk"></a>
    İçindekiler: Özellik Zengini Bir SDK
</h2>

<p><code>zoomex-php</code> kütüphanesi basit bir API sarmalayıcıdan daha fazlasını sunar. Zoomex borsası ile etkileşimde bulunmak için kapsamlı bir araç seti sunarak geliştirme sürecini basit ve verimli hale getirmeyi hedefler. Bu SDK'yı benzersiz kılan unsurları inceleyelim.</p>

<div class="table-wrapper-paragraph">
    <table>
        <thead>
            <tr>
                <th>Özellik</th>
                <th>Açıklama</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td><strong>Tam API v3 Desteği</strong></td>
                <td>Kütüphane, Zoomex API v3 için REST ve WebSocket arayüzleri dahil tam destek sunar. Bu, borsanın piyasa verileri, ticaret ve hesap yönetim özelliklerine erişim sağlar.</td>
            </tr>
            <tr>
                <td><strong>Laravel Entegrasyonu</strong></td>
                <td>Laravel geliştiricileri için <code>zoomex-php</code> sorunsuz bir entegrasyon deneyimi sunar. Bir servis sağlayıcı ve facade içerir, bu da kütüphaneyi tanıdık Laravel sözdizimiyle kullanmanızı sağlar.</td>
            </tr>
            <tr>
                <td><strong>Modern PHP Özellikleri</strong></td>
                <td>SDK, modern PHP için geliştirilmiştir; PHP 8.1+ gerektirir ve hata önleme ve okunabilirliği artıran enums gibi özellikler kullanır. Bu, yaygın hataları önlemeye yardımcı olur ve kütüphaneyi daha kullanışlı hale getirir.</td>
            </tr>
            <tr>
                <td><strong>HMAC-SHA256 Kimlik Doğrulaması</strong></td>
                <td>Kripto para dünyasında güvenlik çok önemlidir. Kütüphane, karmaşık HMAC-SHA256 istek imzalama sürecini sizin için yönetir, böylece uygulamanızı geliştirirken API kimlik doğrulamasının karmaşıklığıyla uğraşmanıza gerek kalmaz.</td>
            </tr>
            <tr>
                <td><strong>Testnet Desteği</strong></td>
                <td>Gerçek fonlarınızı riske atmadan ticaret stratejilerinizi test etmek için ana ağ ile testnet arasında geçiş yapabilmek kritik öneme sahiptir. <code>zoomex-php</code> bunu basit bir yapılandırma seçeneği ile kolaylaştırır.</td>
            </tr>
            <tr>
                <td><strong>Kapsamlı Test</strong></td>
                <td>Kütüphane, PHP için popüler bir test çerçevesi olan Pest ile kapsamlı bir şekilde test edilmiştir. Bu, yüksek kod kalitesi ve güvenilirliğini garanti eder.</td>
            </tr>
        </tbody>
    </table>
</div>

<h2>
    <a name="getting-started-installation-and-setup" href="#getting-started-installation-and-setup"></a>
    Başlarken: Kurulum ve Ayarlama
</h2>

<p><code>zoomex-php</code> ile başlamak oldukça basittir. Kütüphane, herhangi bir PHP projesinde kolayca kurulabilen bir Composer paketi olarak mevcuttur.</p>

<h3>
    <a name="installation" href="#installation"></a>
    Kurulum
</h3>

<p>Kütüphaneyi kurmak için projenizin dizininde aşağıdaki komutu çalıştırmanız yeterlidir:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>composer require tigusigalpa/zoomex-php

<h3>
    <a name="standalone-php" href="#standalone-php"></a>
    Bağımsız PHP
</h3>

<p>Bağımsız bir PHP projesinde kütüphaneyi kullanıyorsanız, yeni bir istemci örneği oluşturup API anahtarlarınızla yapılandırabilirsiniz:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\Zoomex\Client;

$client = new Client([
‘api_key’ => ‘YOUR_API_KEY’,
‘secret_key’ => ‘YOUR_SECRET_KEY’,
‘testnet’ => false, // Testnet için true olarak ayarlayın
]);

<p>Kütüphane ayrıca bir istemci örneği oluşturmak için kullanışlı bir akıcı arayüz sağlar:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\Zoomex\Client;

$client = Client::make()
->withApiKey(‘YOUR_API_KEY’)
->withSecretKey(‘YOUR_SECRET_KEY’)
->withTestnet(false);

<h3>
    <a name="laravel-integration" href="#laravel-integration"></a>
    Laravel Entegrasyonu
</h3>

<p>Laravel uygulamaları için entegrasyon daha da basittir. Paketi yükledikten sonra, yapılandırma dosyasını yayınlayın:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan vendor:publish --tag=zoomex-config

<p>Bu, bir <code>config/zoomex.php</code> dosyası oluşturacaktır. API kimlik bilgilerinizi <code>.env</code> dosyanıza ekleyebilirsiniz:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>ZOOMEX_API_KEY=your_api_key

ZOOMEX_SECRET_KEY=your_secret_key
ZOOMEX_TESTNET=false

<p>Ardından, <code>Zoomex</code> facade'ını kullanarak kütüphanenin özelliklerine erişebilirsiniz:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\Zoomex\Facades\Zoomex;

$tickers = Zoomex::market()->getTickers(/ … /);

<h2>
    <a name="a-look-at-the-code-practical-examples" href="#a-look-at-the-code-practical-examples"></a>
    Koda Bir Bakış: Pratik Örnekler
</h2>

<p>Temel bilgileri ele aldığımıza göre, <code>zoomex-php</code> kütüphanesini kullanmanın bazı pratik örneklerine dalalım. Bu örnekler, piyasa verilerini alma, emir verme ve gerçek zamanlı veri akışlarına abone olma gibi yaygın görevleri gerçekleştirmek için kullanılacaktır.</p>

<h3>
    <a name="getting-market-data" href="#getting-market-data"></a>
    Piyasa Verilerini Alma
</h3>

<p>Bir kripto borsa SDK'sının en yaygın kullanım durumlarından biri piyasa verilerini almaktır. <code>zoomex-php</code> kütüphanesi, <code>MarketService</code> ile bunu kolaylaştırır. Örneğin, BTC/USDT lineer sürekleme sözleşmesi için en son ticker'ları almak için <code>getTickers</code> yöntemini kullanabilirsiniz:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\Zoomex\Facades\Zoomex;

use Tigusigalpa\Zoomex\DTO\Market\GetTickersRequest;
use Tigusigalpa\Zoomex\Enums\Category;

$tickers = Zoomex::market()->getTickers(
new GetTickersRequest(category: Category::LINEAR, symbol: ‘BTCUSDT’)
);

<p><code>GetTickersRequest</code> DTO'sunun (Veri Transfer Objesi) ve <code>Category</code> enumunun kullanımına dikkat edin. Bu, kütüphanenin genelinde yaygın bir modeldir ve API'ye parametreleri geçmenin temiz ve tür güvenli bir yolunu sağlar.</p>

<h3>
    <a name="placing-an-order" href="#placing-an-order"></a>
    Emir Verme
</h3>

<p>Emir vermek de aynı şekilde basittir. <code>TradeService</code>, bir <code>PlaceOrderRequest</code> DTO'su kabul eden <code>placeOrder</code> yöntemini sunar. İşte 50,000 dolardan 0.01 BTC satın almak için bir limit emri vermenin bir örneği:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\Zoomex\DTO\Trade\PlaceOrderRequest;

use Tigusigalpa\Zoomex\Enums{Category, OrderSide, OrderType, TimeInForce};

$order = Zoomex::trade()->placeOrder(new PlaceOrderRequest(
category: Category::LINEAR,
symbol: ‘BTCUSDT’,
side: OrderSide::BUY,
orderType: OrderType::LIMIT,
qty: ‘0.01’,
price: ‘50000’,
timeInForce: TimeInForce::GTC
));

<p>Yine, DTO'lar ve enumların kullanımı, kodu net, özlü ve hata yapmaya karşı dayanıklı hale getirir. Gerekli parametrelerin ve beklenen değerlerin ne olduğunu hızlı bir şekilde görebilirsiniz.</p>

<h3>
    <a name="realtime-data-with-websockets" href="#realtime-data-with-websockets"></a>
    WebSocket ile Gerçek Zamanlı Veri
</h3>

<p>Gerçek zamanlı verilere ihtiyaç duyan uygulamalar için <code>zoomex-php</code> kütüphanesi bir WebSocket istemcisi sağlar. Bu istemciyi, piyasa kitabı güncellemeleri, kamu ticaretleri ve özel emir güncellemeleri gibi çeşitli genel ve özel veri akışlarına abone olmak için kullanabilirsiniz.</p>

<p>Örneğin, BTC/USDT sembolü için piyasa kitabına abone olmak için şu örneği kullanın:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>use Tigusigalpa\Zoomex\WebSocket;

$ws = new WebSocket([‘api_key’ => ‘…’, ‘secret_key’ => ‘…’]);
$ws->subscribeOrderbook(‘BTCUSDT’, 50, function($data) {
print_r($data);
});
$ws->run();

<p>WebSocket istemcisi bir döngü içinde çalışır ve birden fazla konuya abone olabilirsiniz. Kütüphane, kimlik doğrulama ve abonelik sürecini sizin için yönetir, böylece gelen verileri işleme odaklanabilirsiniz.</p>

<h2>
    <a name="under-the-hood-a-welldesigned-architecture" href="#under-the-hood-a-welldesigned-architecture"></a>
    Altyapı: İyi Tasarlanmış Bir Mimari
</h2>

<p>İyi tasarlanmış bir SDK, sadece bir dizi işlevden daha fazlasıdır. Kullanımı ve genişletilmesi kolay, net ve tutarlı bir mimariye sahip olmalıdır. <code>zoomex-php</code> kütüphanesi, temiz tasarımına katkıda bulunan birçok iyi uygulamayı izlemektedir.</p>

<h3>
    <a name="serviceoriented-architecture" href="#serviceoriented-architecture"></a>
    Servis Odaklı Mimari
</h3>

<p>Kütüphane, API'nin belirli bir alanı için sorumluluk taşıyan bir dizi hizmete ayrılmıştır. Örneğin, piyasa verileri, ticaret, pozisyonlar ve hesap yönetimi için hizmetler bulunmaktadır. Bu sorumluluk ayrımı, kütüphaneyi gezinmeyi ve anlamayı kolaylaştırır.</p>

<h3>
    <a name="data-transfer-objects-dtos" href="#data-transfer-objects-dtos"></a>
    Veri Transfer Objesi (DTO)
</h3>

<p>Örneklerde gördüğümüz gibi, kütüphane API'ye veri geçişinde DTO'ları kapsamlı bir şekilde kullanır. Bunun birkaç avantajı vardır:</p>

<ul>
    <li><strong>Tür Güvenliği:</strong> DTO'lar tür güvenliği sağlar, bu da yaygın hataları önlemeye yardımcı olur ve kodun daha kolay anlaşılmasını sağlar.</li>
    <li><strong>Okunabilirlik:</strong> DTO'lar, geçirilen verinin yapısını net bir şekilde tanımlayarak kodun daha okunabilir olmasını sağlar.</li>
    <li><strong>Doğrulama:</strong> DTO'lar, API'ye gönderilmeden önce veriyi doğrulamak için kullanılabilmektedir; bu da geçersiz istekleri önlemeye yardımcı olur.</li>
</ul>

<h3>
    <a name="enums-for-typesafe-values" href="#enums-for-typesafe-values"></a>
    Tür Güvenli Değerler için Enum'lar
</h3>

<p>Kütüphane ayrıca, emir tarafları, emir türleri ve geçerlilik süreleri gibi sınırlı bir değer kümesini temsil etmek için enum'lar kullanmaktadır. Bu, hata yapmaya daha açık olan string veya tamsayı kullanımlarına alternatif olarak tür güvenli bir yol sunar.</p>

<h3>
    <a name="fluent-interface" href="#fluent-interface"></a>
    Akıcı Arayüz
</h3>

<p>İstemci örneği oluşturmak için kullanılan akıcı arayüz, kodu daha okunabilir ve ifadeli hale getiren güzel bir özelliktir. Bu, istemciyi yapılandırmak için yöntem çağrılarını zincirlemenizi sağlar; bu, modern PHP kütüphanelerinde yaygın bir modeldir.</p>

<h2>
    <a name="conclusion-a-powerful-tool-for-php-developers" href="#conclusion-a-powerful-tool-for-php-developers"></a>
    Sonuç: PHP Geliştiricileri İçin Güçlü Bir Araç
</h2>

<p><code>zoomex-php</code> kütüphanesi, Zoomex kripto borsası ile etkileşimde bulunmayı kolaylaştıran güçlü ve iyi tasarlanmış bir SDK'dır. Kapsamlı özellik seti, modern mimarisi ve sorunsuz Laravel entegrasyonu, ticaret uygulamaları veya özel entegrasyonlar geliştirmek isteyen her PHP geliştiricisi için mükemmel bir seçenek haline getirir.</p>

<p>Zoomex API'sine temiz ve tutarlı bir arayüz sunarak, uygulamanızı inşa ederken API kimlik doğrulaması, istek imzalama ve veri ayrıştırma detayları ile uğraşmanıza gerek kalmaz. Basit bir ticaret botu veya karmaşık bir analitik platformu inşa ediyor olun, <code>zoomex-php</code> işlerinizi kolaylaştıracak değerli bir araçtır.</p>

<p>Modern, güvenilir ve kullanımı kolay bir PHP kütüphanesi arıyorsanız, <code>zoomex-php</code>'yi mutlaka incelemenizi tavsiye ederim. İyi tasarlanmış bir SDK'nın karmaşık bir alanı nasıl basitleştirebileceğinin ve geliştiricileri olağanüstü şeyler inşa etme konusunda nasıl güçlendirebileceğinin harika bir örneğidir.</p>

<h2>
    <a name="references" href="#references"></a>
    Referanslar
</h2>

<p>[1] tigusigalpa. (2026). <em>zoomex-php</em> [GitHub deposu]. Erişim adresi: <a href="https://github.com/tigusigalpa/zoomex-php" target="_blank" rel="noopener noreferrer">https://github.com/tigusigalpa/zoomex-php</a></p>

<p>[2] Zoomex. (t.y.). <em>Zoomex API Dokümantasyonu</em>. Erişim adresi: <a href="https://zoomexglobal.github.io/docs/v3/intro" target="_blank" rel="noopener noreferrer">https://zoomexglobal.github.io/docs/v3/intro</a></p>

<p>[3] CoinCodex. (2025, 13 Ağustos). <em>Zoomex Borsa Değerlendirmesi</em>. Erişim adresi: <a href="https://coincodex.com/article/71428/zoomex-exchange-review/" target="_blank" rel="noopener noreferrer">https://coincodex.com/article/71428/zoomex-exchange-review/</a></p>