Longbridge OpenAPI SDK

Longbridge OpenAPI, araştırma ve geliştirme yeteneklerine sahip yatırımcılar için programlı alım satım ve fiyat teklifi arayüzleri sağlar ve kendi yatırım stratejilerine dayalı ticaret veya fiyat teklifi stratejisi analiz araçları oluşturmalarına yardımcı olur. İşlevler aşağıdaki kategorilere ayrılır:

• Trading - Siparişleri oluşturma, değiştirme, iptal etme, bugünün/geçmiş siparişleri ve işlem detaylarını sorgulama, vb.
• Quotes - Gerçek zamanlı fiyat teklifleri, geçmiş fiyat tekliflerinin elde edilmesi, vb.
• Portfolio - Hesap varlıklarının, pozisyonların, fonların gerçek zamanlı sorgulanması
• Gerçek zamanlı abonelik - Gerçek zamanlı fiyat teklifleri ve sipariş durum değişiklikleri için push bildirimleri sağlar

Bu depo aşağıdaki ana bileşenleri içerir:

İsim	Dokümantasyon	Açıklama
Rust	Doc	Rust için Longbridge OpenAPI (>= 1.89.0)
Python	Doc	Python 3 için Longbridge OpenAPI (>= 3.8)
Node.js	Doc	Node.js için Longbridge OpenAPI (>= 10)
Java	Doc	Java için Longbridge OpenAPI (>= 11)
C	Doc	C için Longbridge OpenAPI (>= C99)
C++	Doc	C++ için Longbridge OpenAPI (>= C++17)
Go		https://github.com/longbridge/openapi-go
MCP		Longbridge OpenAPI için bir MCP sunucu uygulaması

Context Türleri

Context	Açıklama
QuoteContext	Gerçek zamanlı fiyat teklifleri, mum grafikler, opsiyonlar, garantiler, izleme listeleri, push abonelikleri
TradeContext	Siparişler, pozisyonlar, hesap bakiyesi, gerçekleştirmeler, nakit akışı
AssetContext	Hesap özeti indirmesi
ContentContext	Haberler, topluluk konuları
FundamentalContext	Mali raporlar, analist değerlendirmeleri, temettüler, valüasyon, şirket özeti, hissedarlar
MarketContext	Pazar durumu, aracı kurum holdingleri, A/H primi, ticaret istatistikleri, anomali uyarıları, endeks bileşenleri
CalendarContext	Mali takvim (kazanç, temettüler, bölünmeler, halka arzlar, makro veriler, pazar kapanışları)
PortfolioContext	Döviz kurları, portfolio kar/zarar analizi
AlertContext	Fiyat uyarısı yönetimi (ekleme/etkinleştirme/devre dışı bırakma/silme)
DCAContext	Ortalama maliyet düşürme planı yönetimi
SharelistContext	Topluluk hisse listesi yönetimi

Hızlı Başlangıç

Yukarıdaki tablodan bir dil SDK'sını seçin ve kurulum ile ilk isteği için README'sini takip edin. Tam referans dokümanlar: https://longbridge.github.io/openapi

SDK Dokümantasyonu

https://longbridge.github.io/openapi

Sorun Giderme

• Ortam değişkenleri etkili olmuyor
  • macOS/Linux: export ... yalnızca geçerli shell oturumunu etkiler.
  • Windows: setx ... etkili olması için yeni bir terminal/oturum açılması gerekir.
• Kimlik doğrulama hataları (401/403)
  • LONGBRIDGE_APP_KEY, LONGBRIDGE_APP_SECRET, LONGBRIDGE_ACCESS_TOKEN değerlerinin doğru ve süresi dolmamış olduğunu doğrulayın.
  • OpenAPI uygulamanızın gerekli izinlere sahip olduğundan emin olun.
• Ağ / bağlantı hataları
  • HTTPS/WSS için güvenlik duvarı/proxy kurallarını kontrol edin.
  • Özel bir endpoint kullanıyorsanız, LONGBRIDGE_HTTP_URL, LONGBRIDGE_QUOTE_WS_URL, LONGBRIDGE_TRADE_WS_URL değerlerini ayarlayın.
• Fiyat teklifi aboneliği hemen çıkıyor
  • Süreci çalışır durumda tutun (event loop / sleep / blocking receive loop), aksi takdirde push olaylarını görmezsiniz.
• Hata Ayıklama
  • LONGBRIDGE_LOG_PATH aracılığıyla logları etkinleştirin.
  • Fiyat teklifleri bağlanırsa ancak boş görünüyorsa, açılan fiyat teklifi paketlerini doğrulamak için LONGBRIDGE_PRINT_QUOTE_PACKAGES=true tutun.

Minimal Doğrulama

Ortamınız / kimlik bilgilerinizin doğru olup olmadığından emin değilseniz, yerleşik HTTP istemci örnekleriyle başlayın.

• Python:

  python examples/python/http_client.py
  

• Node.js:

  node examples/nodejs/http_client.js
  

• Rust:

  cargo run --manifest-path examples/rust/Cargo.toml -p http_client
  

• Java (örnek modülü dizininden):

  cd examples/java/http_client
  mvn -q -DskipTests package
  mvn -q -DskipTests exec:java
  

• C/C++:

  • examples/c/http_client/main.c ve examples/cpp/http_client/main.cpp dosyalarındaki kaynakları kullanın.
  • Derleme talimatları toolchain'inize bağlıdır; ilgili dil SDK README'sine bakın.

Beklenen sonuçlar:

• Kimlik bilgileri geçerliyse ve ağ ulaşılabilirse, HTTP çağrısı JSON döndürür.
• 401/403 döndürürse, LONGBRIDGE_APP_KEY, LONGBRIDGE_APP_SECRET, LONGBRIDGE_ACCESS_TOKEN değerlerinizi kontrol edin.
• Zaman aşımına uğrarsa / bağlanamazsa, proxy/güvenlik duvarını ve endpoint ortam değişkenlerinizi kontrol edin.

Kaynaklar

• Longbridge OpenAPI
• Longbridge OpenAPI Dokümanları

Lisans

Aşağıdakilerden herhangi biri kapsamında lisanslanmıştır

• Apache License, Version 2.0, (LICENSE-APACHE veya http://www.apache.org/licenses/LICENSE-2.0)
• MIT lisansı (LICENSE-MIT veya http://opensource.org/licenses/MIT) seçiminize göre.