Tüm belgeler Nebula belgeleri Tüm uç noktalar Etkileşimli belgeler Markdown OpenAPI JSON
  1. REST API
  2. Sosyal & Duygu Durumu

Zihin Payı

GET /mindshare
GetMindshare

Bir varlığın veya öznenin konuşmadaki payı: son 24 saatteki gönderilerinin, pazarındaki (hisseler, kripto ya da kişiler ve konular) tüm gönderilere oranı, 0 ile 1 arasında. Bir veya daha fazla yazar grubu içindeki payı ölçmek için clusters gönderin.

Parametre kuralları:

  • asset_id veya subject_id gönderin.
  • asset_id ile asset_class birlikte gönderilmelidir.
  • subject_id, asset_id veya asset_class ile birleştirilemez.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/mindshare adresinde kullanılabilir. Nebula hesabı veya API anahtarı gerekmez; imzalamadan önce ödeme teklifini kontrol edin. x402 ödeme kılavuzu.

Parametreler

asset_id string QUERY

/assets veya /search'ten alınan varlık ID'si; örneğin NVDA, GLD, SPX veya bitcoin. Yanında döndürülen asset_class ile birlikte gönderin.

Example:NVDA

asset_class string QUERY

asset_id ile adlandırılan varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. /assets veya /search'ün asset_id ile birlikte döndürdüğü asset_class'ı gönderin.

İzin verilen değerler
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

/subjects veya /search tarafından döndürülen kanonik varlık dışı tanımlayıcı, örneğin text:jensen huang veya handle:elonmusk. Her durumda kabul edilir. asset_id veya asset_class ile birleştirilemez.

Example:text:jensen huang

hours integer QUERY

Saat cinsinden geriye dönük pencere. Ücretsiz planlar 90 güne kadar erişebilir; daha fazlası 403 döndürür.

Default:720

granularity string QUERY

İstenen zaman serisi kova boyutu. Atlanırsa, hizmet geriye dönük pencereye uygun bir kova boyutu seçer.

İzin verilen değerler
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

Okunacak yazar kümeleri; birleştirmek için tekrarlayın, örneğin clusters=kols&clusters=media. Seçilen kümeler toplanır ve bir yazar birden fazla kümeye ait olabilir.

  • Callers: smart_money (en iyi performans gösteren çağrıcılar), dumb_money (en kötü performans gösterenler), top_degens (küçük ölçekli kriptoda en iyiler)
  • Timing: early_movers (dikkat artarken bir varlık hakkında ilk konuşanlar), late_movers (zirvede veya sonrasında gelenler)
  • Geliştiriciler: developers, founders, team_leaders, project_accounts
  • Kurumlar: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Etki: kols, celebrities, media, marketer, shiller
  • Analistler: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Trader'lar: position_trader, swing_trader, day_trader
  • Eğilim: perma_bull, doomer, tribalist
  • Diğer: political, nft, bots, automated_ai

Example:smart_money

cURL Örneği

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/mindshare' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

Yanıtlar

200 OK
400 Hatalı İstek
401 Yetkisiz
402 Krediler tükendi; yanıt, yenileme zamanlamasını ve satın alınan kredi bakiyesini içerir
403 Yasak
404 Bulunamadı
405 Yönteme izin verilmiyor; Allow başlığı desteklenen yöntemi listeler
429 Çok Fazla İstek
500 Sunucu İçi Hata
503 Hizmet Kullanılamıyor

Medya türü application/json

series
array<object> zorunlu

Kronolojik olarak sıralanmış gözlemler.
series[].share
number (double) zorunlu

Uygun sosyal ilginin payı, 0 ile 1 arasında ondalık kesir olarak.

series[].timestamp
string (date-time) zorunlu

Gözlem veya kova başlangıcı için UTC RFC 3339 zaman damgası.

{
  "series": [
    {
      "share": 0.148,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}