Integrasi API

Terima sebut harga masa nyata dalam kod anda sendiri

Kebanyakan pengguna tidak memerlukan halaman ini — dagangan, strategi dan pemberitahuan semuanya boleh dibuat terus di laman web. Halaman ini untuk mereka yang mahu menulis kod sendiri bagi menerima harga kripto masa nyata melalui WebSocket.

Sambungan memerlukan WsToken. Selepas mendaftar, anda boleh menemuinya di tab “Gambaran Akaun” dalam “Akaun & Tetapan”.Dapatkan Token

Sambungan

Buka sambungan WebSocket ke URL di bawah, gantikan wsToken dengan token anda sendiri.

URL

wss://api.zzztech.com.tw/ws/v1/symbol/quote?wsToken=**********

Melanggan

Selepas disambungkan, hantar JSON dalam format berikut untuk melanggan atau berhenti melanggan sesuatu simbol.

Request

{
  "event": "subscribe",
  "data": {
    "symbol": "BTCUSDT",
    "provider": "Binance",
    "market": "Client"
  }
}

eventNama acarasubscribe, unSubscribe, subscriptionList

symbolSimbolBTCUSDT, ETHUSDT

providerSumber data: BinanceBinance

marketBinance sahaja: Client (spot) atau FutureClient (niaga hadapan)Client, FutureClient

Acara yang tersedia:

subscribeLanggan data pasaran

unSubscribeBerhenti melanggan

subscriptionListSenaraikan langganan semasa (tiada data diperlukan)

Format Data

Selepas melanggan, setiap dagangan masa nyata akan dihantar dalam format berikut.

Response

{
  "m": "Client",
  "s": "BTCUSDT",
  "t": 1683259711641,
  "p": "64250.5",
  "v": "0.012"
}

mPasaran (pilihan)

sSimbol

tCap masa (milisaat)

pHarga

vVolum

Contoh Kod

Berikut ialah contoh lengkap yang sedia dijalankan: sambung, langgan harga spot dan niaga hadapan, dan cetak data yang diterima. Untuk Python, pasang pakej websocket-client dahulu.

JavaScript

Python

JavaScript

const socket = new WebSocket('wss://api.zzztech.com.tw/ws/v1/symbol/quote?wsToken=**********');

socket.addEventListener('open', () => {
  // 訂閱比特幣現貨 / 以太幣合約
  socket.send(JSON.stringify({
    event: 'subscribe',
    data: { symbol: 'BTCUSDT', provider: 'Binance', market: 'Client' },
  }));
  socket.send(JSON.stringify({
    event: 'subscribe',
    data: { symbol: 'ETHUSDT', provider: 'Binance', market: 'FutureClient' },
  }));

  // 查詢目前訂閱清單
  socket.send(JSON.stringify({ event: 'subscriptionList' }));
});

socket.addEventListener('message', (event) => {
  console.log('Received:', JSON.parse(event.data));
});

// 不再需要時取消訂閱
// socket.send(JSON.stringify({ event: 'unSubscribe', data: { symbol: 'BTCUSDT', provider: 'Binance' } }));

Nota Penting

Bilangan simbol yang boleh anda langgan serentak bergantung pada pelan anda.Lihat Butiran Pelan

Bermula

Strategi Automatik

Dagangan & Amaran

Akaun & Pelan

Lanjutan