Hisse dayanak varlık ayrıntısı
Hisse dayanak varlık ayrıntısı (borsa bazında sözleşme kotasyonları)
/api/stock-detail/:underlyingİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| underlying path | string | Zorunlu | — | — | Dayanak varlık ticker'ı (büyük harfe çevrilir); veri yoksa 404. Örnek: SOXL |
“path” olarak işaretlenen parametreler URL'nin parçasıdır.
Örnek istek
curl -s "https://www.coinboss.com/api/stock-detail/SOXL"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ı. |
| source | string | — | Değerin nereden geldiği. |
| data | object | — | Veri yükü. |
| data.underlying | string | — | Dayanak hisse / endeks / emtia sembolü. |
| data.name | string | — | Ad. |
| data.type | string | — | Tür. |
| data.price_avg | number | — | Borsalar genelinde ortalama fiyat. |
| data.change_24h | number | — | 24h değişim. |
| data.high_24h | number | — | 24h en yüksek. |
| data.low_24h | number | — | 24h en düşük. |
| data.volume_24h | number | — | 24h hacim. |
| data.oi_usd | number | USD | USD nominal değeri cinsinden açık pozisyon. |
| data.funding_weighted | number | fraction | Borsaların güncel fonlama oranlarının açık pozisyon ağırlıklı ortalaması; her oran kendi fonlama aralığı başınadır. Hiçbir borsa açık pozisyon bildirmiyorsa null. |
| data.exchanges | number | — | Borsalar. |
| data.markets | array | — | Piyasalar. |
| data.markets[] | object | — | Piyasalar. |
| data.markets[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| data.markets[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| data.markets[].price | number | — | Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT). |
| data.markets[].change_pct | number|null | % | Yüzde değişim. |
| data.markets[].volume_24h | number | — | 24h hacim. |
| data.markets[].funding | number | — | Fonlama oranı bloğu veya değeri. |
| data.markets[].funding_interval_h | number | h | Fonlama aralığı. |
| data.markets[].oi_usd | number|null | USD | USD nominal değeri cinsinden açık pozisyon. |
| data.long_short | array | — | Long/short bloğu. |
| data.long_short[] | object | — | Long/short bloğu. |
| data.long_short[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| data.long_short[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| data.long_short[].ratio_type | string | — | Oranın neyi saydığı: `account` (tüm hesaplar), `topacc` (üst düzey trader hesapları), `position` (pozisyon büyüklüğü) veya `taker` (taker alış ve satış hacmi). |
| data.long_short[].long_ratio | number | % | Bu borsa ve sözleşme için en güncel long payı (`taker` için taker alış payı); `long_ratio` + `short_ratio` = 100. |
| data.long_short[].short_ratio | number | % | Bu borsa ve sözleşme için en güncel short payı (`taker` için taker satış payı); `long_ratio` + `short_ratio` = 100. |
| data.liquidations | object | — | Bu dayanak varlığın (takma adlar dahil) borsalar genelindeki likidasyonları; `h1`, `h4`, `h12`, `h24` pencerelerine göre, ayrıca `count_24h`. |
| data.liquidations.h1 | object | — | Son 1 saatte likide edilen nominal değer, USD cinsinden; `long`, `short` ve `total` olarak ayrılır. |
| data.liquidations.h1.long | number | — | Long tarafın değeri. |
| data.liquidations.h1.short | number | — | Short tarafın değeri. |
| data.liquidations.h1.total | number | — | Toplam. |
| data.liquidations.h4 | object | — | Son 4 saatte likide edilen nominal değer, USD cinsinden; `long`, `short` ve `total` olarak ayrılır. |
| data.liquidations.h4.long | number | — | Long tarafın değeri. |
| data.liquidations.h4.short | number | — | Short tarafın değeri. |
| data.liquidations.h4.total | number | — | Toplam. |
| data.liquidations.h12 | object | — | Son 12 saatte likide edilen nominal değer, USD cinsinden; `long`, `short` ve `total` olarak ayrılır. |
| data.liquidations.h12.long | number | — | Long tarafın değeri. |
| data.liquidations.h12.short | number | — | Short tarafın değeri. |
| data.liquidations.h12.total | number | — | Toplam. |
| data.liquidations.h24 | object | — | 24 saatlik değer. |
| data.liquidations.h24.long | number | — | Long tarafın değeri. |
| data.liquidations.h24.short | number | — | Short tarafın değeri. |
| data.liquidations.h24.total | number | — | Toplam. |
| data.liquidations.count_24h | number | — | 24 saatlik sayı. |
| data.klines | array | — | Mumlar. |
| data.klines[] | object | — | Mumlar. |
| data.klines[].t | number | ms | Zaman damgası. |
| data.klines[].o | number | USD | `t` anında (UTC) başlayan günlük mumun açılış fiyatı. |
| data.klines[].h | number | USD | `t` anında (UTC) başlayan günlük mumun en yüksek fiyatı. |
| data.klines[].l | number | USD | `t` anında (UTC) başlayan günlük mumun en düşük fiyatı. |
| data.klines[].c | number | USD | `t` anında (UTC) başlayan günlük mumun kapanış fiyatı; içinde bulunulan gün henüz kapanmamışsa en son fiyat. |
| data.klines[].v | number | — | Değer. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/stock-detail/SOXL · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:45 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data.klines: 180 öğe içeriyordu; data.markets: 17 öğe içeriyordu; data.long_short: 16 öğe içeriyordu.
- "success"true
- "now"1794542325458
- "source""in-house collection"
- "data"
- "underlying""SOXL"
- "name""Direxion Semiconductor Bull 3x"
- "type""etf"
- "price_avg"64.1974409886378
- "change_24h"2.7419816659689613
- "high_24h"69.02
- "low_24h"58.4
- "volume_24h"10975219799.62
- "oi_usd"519894892.91999996
- "funding_weighted"0.000008341482652906381
- "exchanges"17
- "markets"
- "long_short"
- "liquidations"
- "klines"
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
- 60s
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- ticker'lar dakikada bir; OI/fonlama 5 dakikada bir; API önbelleği 60 s
- Pencere
- likidasyonlar 1h / 4h / 12h / 24h; en çok 180 günlük mum
- Veri kaynakları
- Tek bir tokenize hisse/TradFi dayanak varlığının ayrıntısı: borsa bazında sözleşmeler, fonlama, OI, long/short, likidasyonlar ve günlük mumlar; tümü kurum içinde toplanan borsa verilerinden.
- Borsa kapsamı
- Kurum içi tokenize hisse kayıt listesindeki dayanak varlıklar; yoksa 404
- Sayfalama
- yok
- Birimler
- USD; funding as decimal rate per interval
- Yöntem
- funding_weighted = OI-weighted mean of raw rates (not normalized to 8h); quotes deviating more than 10% from the median with zero volume are dropped
- 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
409 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/stock-detail/:underlyingKullanılabilirstring — Underlying ticker (upper-cased); 404 when no data.
https://www.coinboss.com/api/stock-detail/SOXLBu kategoride daha fazlası
- TradFi sürekli vadeli sözleşmeleri için likidasyon özeti /api/liquidations/tradfi
- Pencerede likidasyonu olan TradFi sembollerinin listesi /api/liquidations/tradfi-asset-list
- TradFi sürekli vadeli sözleşmeleri için sembol bazında likidasyon sıralaması /api/liquidations/tradfi-assets
- TradFi sürekli vadeli sözleşmeleri için borsa bazında likidasyon dağılımı /api/liquidations/tradfi-exchanges
- TradFi sürekli vadeli sözleşmeleri için likidasyon akışı /api/liquidations/tradfi-feed
- TradFi sürekli vadeli sözleşmelerinde en büyük likidasyon emirleri /api/liquidations/tradfi-largest
- TradFi sürekli vadeli sözleşmeleri için çok pencereli likidasyon toplamları /api/liquidations/tradfi-overview
- Tek TradFi sembolü için likidasyon özeti /api/liquidations/tradfi-symbol
- Tek TradFi sembolü için likidasyon zaman serisi /api/liquidations/tradfi-symbol-chart
- Tek TradFi sembolü için borsa bazında likidasyon dağılımı /api/liquidations/tradfi-symbol-exchanges
- Tek TradFi sembolü için en büyük likidasyonlar /api/liquidations/tradfi-symbol-largest
- Likidasyon geçmişi olan TradFi sembolleri /api/liquidations/tradfi-symbols
- TradFi likidasyon tablosu /api/liquidations/tradfi-table
- TradFi sürekli vadeli sözleşmeleri için toplam likidasyon zaman serisi /api/liquidations/tradfi-total-chart
- Pre-IPO sözleşme kotasyonları /api/preipo/list
- Hisse dayanak varlık listesi /api/stock-detail-list
- Hisse dayanak varlık ayrıntısı /api/stock-detail/:underlying
- Hisse enstrüman listesi /api/stocks/list
- Borsalarda listelenen hisse sürekli vadeli sözleşmeleri / tokenize hisseler /api/tabs17/exchange-stocks
- Kriptoyla ilişkili hisse senedi kotasyonları /api/tabs17/stocks