Nebula パブリック API
リファレンス索引
以下のすべてのエンドポイントには、安定した HTML ページと Markdown 版があります。このインデックスは静的でクロール可能であり、AI エージェントが JavaScript を実行せずに安全に読むことができます。
ディスカバリ
3 エンドポイント/screener
スクリーナー
24 時間の指標を 1 つ選んでアセットまたはサブジェクトをランク付けし、他の指標で絞り込みます: share、share change、posts、net bullish posts（bullish から bearish を引いた値。負の値は bearish）、または 24 時間の価格変動。範囲は両端を含み、組み合わせ可能です。価格フィルターはアセットにのみ適用されます。
/top-momentum
トップモメンタム
会話の share を最も速く伸ばしているアセットまたはサブジェクト: 今回の 24 時間の share から直前の 24 時間の share を引いた値。share_change_pct は昨日の share に対する同じ変化です。
/top-trending
トップトレンド
過去 24 時間で最も会話のシェアが大きかったアセットまたはサブジェクトを、シェアの大きい順に、直前の 24 時間との変化とともに示します。
ルックアップ
3 エンドポイント/assets
テキストからアセットID
株式（stocks と ETFs）、コモディティ、インデックス、crypto を名前またはティッカーで検索し、すべてのアセットエンドポイントが受け取る asset_id と asset_class を取得します。検索には query、完全一致には asset_id を送信するか、どちらも送らずに最も活発なアセットを閲覧します。
/search
検索
アセット、人物、アカウント、トピックを横断する単一の検索です。各結果がどれに該当するかはkindが示します。アセットにはasset_idとasset_classが付き、サブジェクトにはsubject_idが付きます。片方だけを検索するにはkindを送信します。
/subjects
テキストからサブジェクトID
人物、アカウント、トピック（AI を含む）を検索し、サブジェクトエンドポイントが受け取る subject_id を取得します。アセットは含まれません。それらには /assets または /search を使用してください。
ソーシャル & センチメント
6 エンドポイント/emotions
感情分布
アセットまたはサブジェクトに関する会話で時間の経過とともにどの 15 の感情が優勢になるか。proportion はバケットの感情に占める各感情の share（合計は 1）、post_count はそれを示す posts を数えます。1 つの post が複数を示すことがあります。
/mindshare
マインドシェア
アセットまたはサブジェクトの会話に占めるシェア：直近24時間の投稿数が、その市場（株式、暗号資産、または人物とトピック）の全投稿数に占める割合で、0から1の範囲です。1つ以上の著者グループ内でのシェアを測定するにはclustersを送信します。
/related-subjects
関連トピック
ある資産やトピックと同じ投稿内で最も頻繁に言及される人物、アカウント、トピック。share はアンカーの投稿に占める共有投稿の割合で、sentiment フィールドはそれらの共有投稿内におけるアンカーのセンチメントです。
/sentiment
センチメント
資産、トピック、または市場全体についての会話がどれだけ強気か弱気かを時系列で示します。sentiment_signal は直近 24 時間の強気投稿から弱気投稿を引いた値で、最近の投稿ほど重み付けが大きく、正の値は純強気を意味します。投稿量に応じて大きくなるため、資産は自身の履歴と比較してください。
/sentiment/timeframes
時間軸別センチメント
人々が話題にしている時間軸ごとに分割したセンチメント。短期（最長1週間）、中期（数週間から数か月）、長期（3か月以上）のそれぞれを /sentiment スケールで示します。今週は弱気だが年間では強気の集団と、一貫して弱気の集団を区別できます。
/social-momentum
ソーシャルモメンタム
資産、トピック、または市場全体について、各投稿者クラスター内の投稿、ユニーク投稿者、センチメントを並べて比較できます。どのグループが会話を牽引しているのか、またそのトーンがどう異なるのかがわかります。クラスターは重複するため、合計しないでください。指定したクラスターのみを返すには clusters を送信します。
予測
3 エンドポイント/forecasts/assets
予測可能な資産
現在予測が存在するすべての資産。このリストは /forecasts/mindshare と /forecasts/sentiment の両方を対象としており、どちらも同じ資産を予測します。資産の asset_id と asset_class をどちらかに渡してください。株式、コモディティ、指数が先に、次に暗号資産が、最も議論されている順に並びます。リストは5分ごとに更新されます。
/forecasts/mindshare
マインドシェア予測
今後72時間で資産の mindshare がどこに落ち着く可能性が高いかを、結果の範囲とその確率として示します。series は4時間ごとの分布を返し、chance_higher_72h と likely_low_share から likely_high_share は落ち着く先を要約し、takeoff_chance_72h は注目が急上昇する確率です。
/forecasts/sentiment
センチメント予測
今後72時間で資産のセンチメントがどこに向かう可能性が高いかを、結果の範囲とその確率として示します。series は4時間ごとに、そのステップで予想される強気・弱気・中立・合計の投稿数と、その終了時点の sentiment_signal を /sentiment スケールで示します。chance_higher_24h と chance_higher_72h はシグナルが current_sentiment_signal を上回って終わる確率を示し、それぞれの _confident フラグはその確率が明確にどちらかに傾いているときを示します。
市場センチメント
7 エンドポイント/calls
ロング／ショートコール
人々がある資産について、または全市場にわたって、時間の経過とともにどれだけのロングコールとショートコールを行っているか。コールとは、資産が上昇または下落すると述べる、ポジションを開示する、または他者に取るよう促すものであり、単なる意見は該当しません。あるグループのコールをカウントするには clusters を送信します。
/calls/returns
コール結果の分布
最近のコールがどのような成績だったか。勝率、リターンの中央値と平均、およびリターンの分布です。各コールは、その後の24時間の価格変動を発信者の側から評価するため、10%下落に対するショートコールは+10%となります。グループを比較するには clusters を送信します。たとえば smart_money と dumb_money の比較などです。
/conviction-index
コンビクション指数
ある資産に対して人々がどれほど強く信じているかを0〜100で表した指標です。資産の強気比率と市場の強気比率の比較、価格下落時にもセンチメントがどれだけ維持されるか、直近の強気比率、そして強欲系の感情を組み合わせています。50前後が典型的で、資産は自身の履歴と比較してください。
/fear-greed-index
恐怖と強欲指数
1 つのアセットについて、価格、ボラティリティ、モメンタム、取引量、ソーシャルムードを組み合わせた、毎日の 0～100 の恐怖対強欲の指標: 20 までが Extreme Fear、40 が Fear、60 が Neutral、80 が Greed、80 超が Extreme Greed です。metadata に構成要素が記載されています。
/price-levels
ソーシャルで言及された価格水準
人々がアセットに対して挙げる価格（ターゲット、サポート、気配値）を、価格と時間でバケット化したもの：群衆がどこに期待を置いているかを示します。mentionsは明示された水準を数えるため、1件の投稿が複数の水準を追加することがあります。
/social-volume-index
ソーシャルと取引量の比較
ある資産について、取引と会話のどちらがより熱くなっているかを、それぞれ自身の90日間の平常値と比較して示します。volume_indexは0〜100で、50は両者が同程度に高まっていることを意味し、50を超えると取引が会話を上回り、50を下回ると会話が取引を上回ります。日次で、最大90日分です。
/social-volume-profile
ソーシャルボリュームプロファイル
取引ではなく投稿で構成されるボリュームプロファイルです。ある資産に関する会話が価格軸上のどこで起きたかを示します。各ビンには投稿数、強気と弱気のシェア、そしてdirectional_imbalance（−1はすべて弱気、+1はすべて強気）が含まれます。significance_scoreは投稿数、バランス、価格がそのビンを再訪する頻度、圧縮度に基づいてビンを0〜1で順位付けし、ポイント・オブ・コントロールは最も活発なビンです。1つのグループをプロファイルするにはclustersを送信してください。
市場データ
1 エンドポイントインテリジェンス
3 エンドポイント/calendar-events
カレンダーイベント
今後および過去の市場イベント（決算、経済指標発表、IPO、上場、投票、公聴会）を、グローバルまたは特定のアセットや対象について取得します。タイプ、ステータス、1〜3の重要度、および関与するエンティティを含みます。デフォルトでは当日以降を早い順に返します。注目度の高いイベントのみを取得するにはmin_importance_score=2を送信します。
/insights
インテリジェンス
市場で起きていることを伝える短いストーリー。グローバルまたは特定のアセットやサブジェクトに関するもので、それぞれに見出し、要約、センチメント（−1、0、+1）、タグ、1から3の重要度、および関与するエンティティが含まれます。更新が新しい順で、最新のイベントを先に取得するにはorder_by=start_time_descを送信します。
/insights/attention
インサイト注目度
1つのインテリジェンス項目をめぐる会話：24時間のアテンションウィンドウ、投稿者数とセンチメント数、時間別バケット、クラスター構成、インパクトベクトル、および価格付け可能なリンク済みエンティティごとの価格反応。/insights の後に、読者が1つの項目を開き、ドロワーレベルの完全なコンテキストを必要とするときに使用します。
クラスター
10 エンドポイント/clusters
投稿者クラスター
ある市場におけるすべての投稿者クラスターの活動とセンチメント：投稿数、ユニーク投稿者数、前のウィンドウとの変化、および純センチメント（強気の投稿から弱気の投稿を引いたもの）と時間別シリーズ。asset_class は equity（デフォルト）または crypto です。
/clusters/comparison
クラスター比較
ウィンドウ全体におけるすべての投稿者クラスターの比較：投稿数とその変化、市場に対する強気度（cluster_bullish_share 対 market_bullish_share）、過去7日間で最も注目した資産（trending_asset）、および日別投稿数。
/clusters/comparison/divisive-assets
意見が分かれる資産
クラスター間で最も意見が分かれている、広く議論されている資産。minority_shareは明確に強気または弱気に傾いているクラスターのうち少数派の割合であり、0.5は均等な分裂を意味します。これは議論の分断度を示すものであり、今後の値動きを示すものではありません。
/clusters/comparison/hype-cycles
ハイプサイクル到達
ウィンドウ内の最大のハイプサイクルと、市場のピーク時間に対する各サイクルへのクラスターの到達順序。ピーク前後の市場の時間別投稿付き。
/clusters/comparison/traits
クラスター特性比較
すべてのクラスターにわたるすべての/clusters/profile特性。高い順に並べ、どのグループが各特性で先行または後退しているかを確認できます。
/clusters/hype-cycles
クラスターのハイプサイクル
ハイプサイクルにおいて、あるクラスターが市場と比べてどれだけ早く動き出すか。curve はピークの7日前から7日後までの各サイドの投稿の累積シェアで、線が左にあるほど早いことを示す。lead_days はそのクラスターのリード（正なら早い）、clusters は全クラスターのリードを順位付けしたもの。
/clusters/overlap
クラスターの重複
どのクラスターがこのクラスターと同じ資産を監視しているか、またそれらが一致しているか。overlap_share はピアが共有する上位50資産の割合、direction_agreement_share は同じ方向に傾く頻度、stance_gap はこのクラスターの方が強気な場合に正になります。
/clusters/profile
クラスタープロファイル
1つのクラスターの行動特性。それぞれ他のすべてのクラスターと比較して順位付けされます（rank 1 が最高）。
/clusters/rotation
クラスターローテーション
あるクラスタの関心がどこへ向かっているか：前のウィンドウと比較して投稿シェアを伸ばしている資産と失っている資産（ベーシスポイント）、および投稿が市場、人物、イベントにどう分かれているか。
/clusters/stances
クラスターのスタンス
最も議論されている資産に対するあるクラスタのスタンスを市場のものと並べて示します（−1はすべて弱気、+1はすべて強気）。contrarian_shareは市場と逆方向に傾く頻度で、他のクラスタの平均と比較できます。