Profilo del volume social
/social-volume-profile
Un profilo di volume fatto di post invece che di scambi: dove, sull'asse dei prezzi, si è svolta la conversazione su un asset. Ogni bin ha il numero di post, le quote bullish e bearish e directional_imbalance da −1 (tutto bearish) a +1 (tutto bullish); significance_score ordina i bin da 0 a 1 in base a post, equilibrio, quanto spesso il prezzo li rivisita e compressione; il point of control è il bin più attivo. Invia clusters per profilare un singolo gruppo.
Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/social-volume-profile. 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 da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.
Example:NVDA
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.
equitycommodityindexcrypto
Example:equity
Finestra di lookback in ore. I piani gratuiti risalgono fino a 90 giorni; oltre viene restituito 403.
Default:168
Numero di bin di prezzo.
Default:30
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 - Community, in base a dove è stato pubblicato il post:
wallstreetbets,reddit
Example:smart_money
Esempio cURL
curl --get \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/social-volume-profile' \
--data-urlencode 'asset_id=NVDA' \
--data-urlencode 'asset_class=equity' \
--header 'X-API-Key: YOUR_API_KEY'Risposte
Tipo di media application/json
bins
array<object>
Bin di prezzo ordinati dal più basso al più alto.
bins
Bin di prezzo ordinati dal più basso al più alto.
bins[].balance_score
Quanto uniformemente l'attività è distribuita tra le direzioni, da 0 a 1.
bins[].bearish_posts
Post classificati come bearish.
bins[].bearish_share
Quota bearish dei post direzionali in questo bin, da 0 a 1.
bins[].bullish_posts
Post classificati come bullish.
bins[].bullish_share
Quota bullish dei post direzionali in questo bin, da 0 a 1.
bins[].compression_score
Quanto lentamente si è mosso il prezzo mentre era nel bin, da 0 a 1.
bins[].directional_imbalance
Squilibrio dei post direzionali (bullish − bearish) / (bullish + bearish), da −1 a 1; assente in mancanza di post direzionali.
bins[].is_point_of_control
True per il bin con la maggiore attività di post.
bins[].neutral_posts
Post classificati come neutral.
bins[].price_high_usd
Limite superiore escluso del bin di prezzo in dollari USA.
bins[].price_low_usd
Limite inferiore incluso del bin di prezzo in dollari USA.
bins[].price_mid_usd
Punto medio del bin di prezzo in dollari USA.
bins[].significance_score
Punteggio di prominenza composito per il bin, da 0 a 1.
bins[].total_posts
Numero di post nella finestra di riferimento attiva della metrica.
bins[].total_share
Numero di post rispetto al bin più attivo, da 0 a 1.
bins[].visit_count
Numero di volte distinte in cui il prezzo di mercato è entrato in questo bin durante la finestra.
maximum_posts_in_bin
Numero di post nel bin di prezzo più attivo.
maximum_price_usd
Prezzo più alto del profilo in dollari USA.
metadata
object
Metodologia e metadati della finestra di richiesta necessari per interpretare la risposta.
metadata
Metodologia e metadati della finestra di richiesta necessari per interpretare la risposta.
metadata.as_of
Ora UTC in cui è stata calcolata la metrica.
metadata.bin_count
Numero di bin di prezzo richiesti.
metadata.clusters
Risultati indicizzati o raggruppati per identificatore canonico di cluster di autori.
metadata.hours
Finestra di lookback rappresentata dalla risposta, in ore.
metadata.priced_buckets
Bucket di sentiment abbinati con successo a un prezzo di mercato.
metadata.unpriced_buckets
Bucket di sentiment omessi perché non era disponibile alcun prezzo di mercato vicino.
minimum_price_usd
Prezzo più basso del profilo in dollari USA.
point_of_control_bin_index
Indice a base zero del bin più attivo; assente quando il profilo è vuoto.
total_posts
Numero di post nella finestra di riferimento attiva della metrica.
{
"bins": [
{
"balance_score": 0.64,
"bearish_posts": 438,
"bearish_share": 0.32,
"bullish_posts": 1120,
"bullish_share": 0.68,
"compression_score": 0.78,
"directional_imbalance": 0.36,
"is_point_of_control": true,
"neutral_posts": 284,
"price_high_usd": 180,
"price_low_usd": 175,
"price_mid_usd": 177.5,
"significance_score": 0.87,
"total_posts": 1842,
"total_share": 0.82,
"visit_count": 6
}
],
"maximum_posts_in_bin": 286,
"maximum_price_usd": 188.75,
"minimum_price_usd": 161.25,
"point_of_control_bin_index": 14,
"total_posts": 1842
}