トップトレンド

GET /top-trending
GetTopTrending

過去 24 時間で最も会話のシェアが大きかったアセットまたはサブジェクトを、シェアの大きい順に、直前の 24 時間との変化とともに示します。

シェアとは、同じ市場(株式、暗号資産、または人物とトピック)における同じ 24 時間内の全投稿に占める割合です(ボットは除外)。clusters を指定した場合は、それらのクラスターが投稿した内容に占める割合になります。

パラメータのルール:

  • asset_class は kind=asset にのみ適用されます。
  • wallstreetbets のような投稿コミュニティは、asset_class が equity、commodity、index のいずれかである kind=asset に対してのみ指定できます。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/top-trending で利用できます。Nebula アカウントや API キーは不要です。署名する前に支払いオファーを確認してください。x402 支払いガイド。

パラメータ

kind string QUERY

ランキングの対象: asset(株式、コモディティ、インデックス、暗号資産)または subject(人物、アカウント、トピック)。デフォルトは asset です。

指定可能な値
assetsubject

Default:asset

asset_class string QUERY

kind=asset の場合にランキングする市場: equity(デフォルト)、commodity、index、crypto のいずれかです。

指定可能な値
equitycommodityindexcrypto

Default:equity

clusters array<string> QUERY

読み取る投稿者クラスター。繰り返し指定して組み合わせられます(例: clusters=kols&clusters=media)。選択したクラスターは合算され、1 人の投稿者が複数のクラスターに属することもあります。

  • Callers: smart_money(成績の良い Caller)、dumb_money(成績の悪い Caller)、top_degens(小型暗号資産で好成績)
  • Timing: early_movers(注目が高まる中でいち早くアセットについて言及する)、late_movers(ピーク時またはそれ以降に到達する)
  • Builders: developers、founders、team_leaders、project_accounts
  • Institutions: vcs、asset_managers、dao_guild_funds、incubators、exchanges
  • Influence: kols、celebrities、media、marketer、shiller
  • Analysts: ta_analyst、fa_analyst、macro_analyst、onchain_analyst、investigators
  • Traders: position_trader、swing_trader、day_trader
  • Bias: perma_bull、doomer、tribalist
  • Other: political、nft、bots、automated_ai
  • Communities(投稿された場所別): wallstreetbets、reddit

Example:smart_money

limit integer QUERY

返される結果の最大数。

Default:25

cURL の例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/top-trending' \
  --header 'X-API-Key: YOUR_API_KEY'

レスポンス

200 OK
400 不正なリクエスト
401 未認証
402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

asset_class
string 任意

アセットがランク付けされた市場。subject の場合は含まれません。

clusters
array<string> 必須

投稿が集計された投稿者クラスタ(正規化済み)。ボット以外のすべての投稿者が集計された場合は空になります。

from
string (date-time) 必須

ランク付けされた 24 時間の UTC 開始時刻。比較ウィンドウはその直前の 24 時間です。

kind
string 必須

ランク付けの対象。リクエストに応じて asset または subject になります。

指定可能な値
assetsubject
previous_total_posts
integer (int64) 必須

直前の 24 時間にランク付け対象集団に含まれたすべての投稿。

results
array<object> 必須

ランク付けされた結果。上位から順に並びます。

results[].asset_class
string 任意

アセットのクラス: equity(株式および ETF)、commodity、index、crypto のいずれか。asset を対象とするすべてのリクエストで asset_id とともに送信してください。

指定可能な値
equitycommodityindexcrypto
results[].asset_id
string 任意

公開アセットの正規識別子: 株式、コモディティ、インデックスの場合はティッカーまたは市場シンボル、crypto の場合は CoinGecko スラッグ(スラッグがない場合は数値 id)。

results[].bearish_posts
integer (int64) 必須

弱気と分類された投稿。

results[].bullish_posts
integer (int64) 必須

強気と分類された投稿。

results[].kind
string 必須

結果の種類: asset(asset_id と asset_class でクエリ)または subject(subject_id でクエリ)。

指定可能な値
assetsubject
results[].name
string 必須

人間が読める名前。

results[].neutral_posts
integer (int64) 必須

中立と分類された投稿。

results[].posts
integer (int64) 必須

ランク付けされた 24 時間におけるこの結果の投稿。

results[].previous_posts
integer (int64) 必須

同じ長さの直前のウィンドウにおけるこの結果の投稿。

results[].price_change_24h_pct
number (double) 任意

24 時間の生の市場価格変動(パーセンテージポイント)。

results[].share
number (double) 必須

同じ 24 時間にランク付け対象集団に含まれたすべての投稿に対するこの結果の投稿の割合(0 から 1)。

results[].share_change
number (double) 任意

前のウィンドウに対するシェアの変化(小数): 0.01 は 1 パーセンテージポイントを表します。前のウィンドウに投稿がなかった場合にのみ含まれません。

results[].share_change_pct
number (double) 任意

前のウィンドウのシェアに対するシェアの変化(パーセント)。前のウィンドウにこの結果の投稿がなかった場合は含まれません。

results[].subject_id
string 任意

アセット以外の人物、アカウント、トピックの正規識別子。

results[].symbol
string 任意

表示用のティッカーまたは市場シンボル。

to
string (date-time) 必須

ランク付けされた 24 時間の UTC 終了時刻: ランキングが計算された時点。

total_posts
integer (int64) 必須

24 時間にランク付け対象集団に含まれたすべての投稿: シェアの分母。

{
  "asset_class": "equity",
  "clusters": [],
  "from": "2026-08-06T15:00:00Z",
  "kind": "asset",
  "previous_total_posts": 17205,
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 61,
      "bullish_posts": 214,
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "neutral_posts": 111,
      "posts": 386,
      "previous_posts": 273,
      "price_change_24h_pct": -2.48,
      "share": 0.025255,
      "share_change": 0.009388,
      "share_change_pct": 59.16,
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "bearish_posts": 30,
      "bullish_posts": 92,
      "kind": "asset",
      "name": "Amazon.com, Inc.",
      "neutral_posts": 63,
      "posts": 185,
      "previous_posts": 165,
      "price_change_24h_pct": -0.32,
      "share": 0.012104,
      "share_change": 0.002516,
      "share_change_pct": 26.24,
      "symbol": "AMZN"
    }
  ],
  "to": "2026-08-07T15:00:00Z",
  "total_posts": 15284
}