スクリーナー

GET /screener
スクリーナー

24 時間の指標を 1 つ選んでアセットまたはサブジェクトをランク付けし、他の指標で絞り込みます: share、share change、posts、net bullish posts(bullish から bearish を引いた値。負の値は bearish)、または 24 時間の価格変動。範囲は両端を含み、組み合わせ可能です。価格フィルターはアセットにのみ適用されます。

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

パラメータのルール:

  • asset_class は kind=asset にのみ適用されます。
  • wallstreetbets のような投稿コミュニティは、asset_class が equity、commodity、index のいずれかである kind=asset に対してのみ指定できます。
  • 各最小値は対応する最大値を超えてはなりません。
  • 価格の並べ替えと価格範囲には kind=asset が必要です。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/screener で利用できます。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

sort string QUERY

ランク付けに使用する指標。デフォルトは share です。

指定可能な値
shareshare_changeshare_change_pctpostsnet_bullish_postsprice_change_24h_pct

Default:share

order string QUERY

desc(デフォルト)は値の大きい順、asc は値の小さい順に並べます。

指定可能な値
descasc

Default:desc

limit integer QUERY

返される結果の最大数。

Default:25

min_share number QUERY

会話に占める share が少なくともこの割合以上である結果を保持します(0 から 1)。

Example:1

max_share number QUERY

会話に占める share が最大でもこの割合以下である結果を保持します(0 から 1)。

Example:1

min_share_change number QUERY

直前の 24 時間と比べて share が少なくともこの分だけ上昇した結果を保持します(-1 から 1 の割合。0.01 は 1 パーセントポイント)。

Example:1

max_share_change number QUERY

share の変化が最大でもこの分以下である結果を保持します(-1 から 1 の割合。負の値は share を失っている結果を選択します)。

Example:1

min_posts integer QUERY

24 時間で少なくともこの数の posts がある結果を保持します。price_change_24h_pct で並べ替える場合のデフォルトは 5 です。

Example:1

min_net_bullish_posts integer QUERY

bearish より bullish の posts が少なくともこの数だけ多い結果を保持します。負の値は bearish の結果を許可します。

Example:1

max_net_bullish_posts integer QUERY

bearish より bullish の posts が最大でもこの数だけ多い結果を保持します。負の値は bearish の結果を選択します。

Example:1

min_price_change_24h_pct number QUERY

24 時間の価格変動が少なくともこのパーセント以上であるアセットを保持します。

Example:1

max_price_change_24h_pct number QUERY

24 時間の価格変動が最大でもこのパーセント以下であるアセットを保持します。

Example:1

cURL の例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/screener' \
  --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
}