Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI
  1. API REST
  2. Social & Sentiment

Mindshare

GET /mindshare
GetMindshare

La quota di conversazione di un asset o di un soggetto: i suoi post nelle ultime 24 ore come frazione di tutti i post nel suo mercato (azioni, crypto, oppure persone e argomenti), da 0 a 1. Invia clusters per misurare la quota all'interno di uno o più gruppi di autori.

Regole dei parametri:

  • Invia asset_id o subject_id.
  • asset_id deve essere inviato insieme a asset_class.
  • subject_id non può essere combinato con asset_id o asset_class.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/mindshare. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

asset_id string QUERY

Asset ID da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.

Example:NVDA

asset_class string QUERY

Classe dell'asset indicato da asset_id: equity (azioni ed ETF), commodity, index o crypto. Va inviata l'asset_class restituita da /assets o /search insieme all'asset_id.

Valori consentiti
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

Identificatore canonico non relativo a un asset restituito da /subjects o /search, ad esempio text:jensen huang o handle:elonmusk. Accettato in qualsiasi combinazione di maiuscole e minuscole. Non può essere combinato con asset_id o asset_class.

Example:text:jensen huang

hours integer QUERY

Finestra di lookback in ore. I piani gratuiti risalgono fino a 90 giorni; oltre viene restituito 403.

Default:720

granularity string QUERY

Dimensione del bucket della serie temporale richiesta. Se omessa, il servizio sceglie una dimensione del bucket adeguata alla finestra di lookback.

Valori consentiti
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

Cluster di autori da leggere; ripeti per combinarli, ad esempio clusters=kols&clusters=media. I cluster selezionati vengono sommati e un autore può appartenere a più cluster.

  • Caller: smart_money (i caller con le migliori performance), dumb_money (con le peggiori), top_degens (i migliori sulle crypto a bassa capitalizzazione)
  • Tempismo: early_movers (i primi a parlare di un asset quando l'attenzione sale), late_movers (arrivano al picco o dopo)
  • Builder: developers, founders, team_leaders, project_accounts
  • Istituzioni: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Influenza: kols, celebrities, media, marketer, shiller
  • Analisti: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Trader: position_trader, swing_trader, day_trader
  • Bias: perma_bull, doomer, tribalist
  • Altro: political, nft, bots, automated_ai

Example:smart_money

Esempio cURL

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'

Risposte

200 OK
400 Richiesta non valida
401 Non autorizzato
402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati
403 Vietato
404 Non trovato
405 Metodo non consentito; l'header Allow elenca il metodo supportato
429 Troppe richieste
500 Errore interno del server
503 Servizio non disponibile

Tipo di media application/json

series
array<object> obbligatorio

Osservazioni ordinate cronologicamente.
series[].share
number (double) obbligatorio

Quota di attenzione social idonea, come frazione decimale da 0 a 1.

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

Timestamp UTC in formato RFC 3339 per l'osservazione o l'inizio del bucket.

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