Long/short oranı matrisi
Long/short oranı matrisi (coin × borsa)
/api/ls/matrixİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| limit | integer | İsteğe bağlı | 100 | ≤ 500 | Döndürülecek satır sayısı. Örnek: 100 |
| type | string | İsteğe bağlı | account | account, topacc, position, taker | Long/short oranı türü. Örnek: account |
Örnek istek
curl -s "https://www.coinboss.com/api/ls/matrix?limit=100&type=account"Yanıt alanları
Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| type | string | — | Tür. |
| types | array | — | Türler. |
| types[] | string | — | Türler. |
| exchanges | array | — | Borsalar. |
| exchanges[] | string | — | Borsalar. |
| count | number | — | Öğe sayısı. |
| data | array | — | Veri yükü. |
| data[] | object | — | Veri yükü. |
| data[].base | string | — | Temel varlık sembolü. |
| data[].cells | object | — | Matris hücreleri. dinamik anahtarlar: binance,bitget,bybit,gate,kraken |
| data[].cells.{*} | object | — | Matris hücreleri. |
| data[].cells.{*}.long | number | — | Long payı. |
| data[].cells.{*}.short | number | — | Short payı. |
| data[].cells.{*}.ratio | number | — | Long payının short payına bölümü (1 = dengeli). |
| data[].exchange_count | number | — | Borsa sayısı. |
| data[].volume_usd | number | USD | USD nominal değeri cinsinden hacim. |
| data[].cells.binance | object | — | `binance` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].cells.binance.long | number | — | Long payı. bulunmayabilir |
| data[].cells.binance.short | number | — | Short payı. bulunmayabilir |
| data[].cells.binance.ratio | number | — | Long payının short payına bölümü (1 = dengeli). bulunmayabilir |
| data[].cells.bybit | object | — | `bybit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].cells.bybit.long | number | — | Long payı. bulunmayabilir |
| data[].cells.bybit.short | number | — | Short payı. bulunmayabilir |
| data[].cells.bybit.ratio | number | — | Long payının short payına bölümü (1 = dengeli). bulunmayabilir |
| data[].cells.gate | object | — | `gate` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].cells.gate.long | number | — | Long payı. bulunmayabilir |
| data[].cells.gate.short | number | — | Short payı. bulunmayabilir |
| data[].cells.gate.ratio | number | — | Long payının short payına bölümü (1 = dengeli). bulunmayabilir |
| data[].cells.kraken | object | — | `kraken` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].cells.kraken.long | number | — | Long payı. bulunmayabilir |
| data[].cells.kraken.short | number | — | Short payı. bulunmayabilir |
| data[].cells.kraken.ratio | number | — | Long payının short payına bölümü (1 = dengeli). bulunmayabilir |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/ls/matrix?limit=100&type=account · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:52 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 100 öğe içeriyordu; data[].cells: 6 öğe içeriyordu.
- "success"true
- "now"1794542272020
- "type""account"
- "types"
- "account"
- "topacc"
- "position"
- "taker"
- "exchanges"
- "binance"
- "okx"
- "bybit"
- "bitget"
- "gate"
- "kraken"
- "count"277
- "data"
Ayrıntılar
- Kimlik doğrulama
- Yok. Herkese açık uç nokta.
- İstek sınırı
- IP başına dakikada 1200 istek
- Sunucu önbelleği
- 30s
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- 5 dakikada bir (binance üst düzey trader hesap oranı ile okx taker / üst düzey trader pozisyon oranları saatlik; geri kalan semboller 30 dakikada bir)
- Pencere
- en güncel anlık görüntü; son 3 saat içinde güncellenen satırlar
- Veri kaynakları
- Kurum içi toplayıcıların 7 borsanın (binance, okx, bybit, bitget, gate, htx, kraken) herkese açık istatistik uç noktalarından sorguladığı long/short oranları.
- Borsa kapsamı
- hesap oranı: binance, okx, bybit, bitget, gate, kraken; üst düzey trader hesap oranı: binance, htx; pozisyon oranı: binance, okx, gate, htx, bitget; taker alış/satış oranı: binance, okx, bitget, gate; kaynak örnekleme dönemleri farklıdır (5 dk ile 1 saat arası); sembol kapsamı hacme göre ilk sıralardakilerden oluşan kayan bir listedir (binance hesap oranında yaklaşık 280 coin, diğer borsa / türlerde yaklaşık 20-60 coin); type parametresi: account | topacc | position | taker (varsayılan account)
- Sayfalama
- limit (varsayılan 100, en çok 500)
- Sıralama
- vadeli volume_usd, azalan; ardından exchange_count, azalan
- Birimler
- long / short as percentages of 100; ratio = long / short; volume_usd in USD
- Yöntem
- per coin and exchange: long, short, ratio = long / short
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
Canlı durum
Erişilebilirlik, son 30 gün
410 kontrolde başarı oranı: %100
Hatalar
Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir. | Değiştirmeden yeniden denemeyin; isteği düzeltin. |
| UNAUTHORIZED | 401 | `CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın. | Değiştirmeden yeniden denemeyin. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir. | `Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin. |
| INTERNAL | 500 | Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin. | Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin. |
| UPSTREAM_FAILED | 503 | Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez. | Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin. |
| UNAVAILABLE | 501 / 503 | Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok. | Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler. |
| REQUEST_FAILED | 200 | Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin. | Mesaja bağlıdır; başarısız bir istek olarak ele alın. |
Deneyin
/api/ls/matrixKullanılabilirinteger · varsayılan 100 · en çok 500 — Number of rows to return.
string · varsayılan account — Long/short ratio flavour.
https://www.coinboss.com/api/ls/matrix?limit=100&type=accountBu kategoride daha fazlası
- Tek coin için long/short oranı /api/sd/ls
- Coin sayfası long/short kartları /api/currency/ls-cards
- Bir coin için tek borsada long/short oranı geçmişi /api/exchanges/ls-history
- Tek coin için borsa bazında long/short kartları /api/ls/cards
- Tek coin için long/short oranı grafik serisi /api/ls/chart
- Tek coin için borsalara ve türlere göre long/short oranları /api/ls/coin
- Tek coin için tek borsada long/short oranı geçmişi /api/ls/history
- Long/short oranı matrisi /api/ls/matrix
- Long/short oranı listesi v2 /api/market/long-short-v2
- Long/short oranı listesi /api/market/long-short