Nebula CLI
株式、コモディティ、指数、暗号資産、AI にわたるグローバル市場インテリジェンスを、ターミナル、スクリプト、CI からクエリできます。
インストール
CLI には Node.js 18 以降が必要です。
npm install --global @hiddensystems/nebula-cli
認証
nebula auth login --key YOUR_API_KEY
CLI はキーを ~/.nebula/config.json にオーナー専用の権限で保存します。自動化には代わりに NEBULA_API_KEY を設定してください。
x402 決済
Nebula アカウントや API キーがなくても、別途提供される x402 HTTP API を通じて、Base 上の USDC で対象となる API の読み取りに対して支払うこともできます。支払いはウォレットごとに承認します。MCP と CLI の接続は引き続きアカウント認証とクレジットを使用し、ウォレットによる支払いを自動的に行うことはありません。x402 支払いガイドを参照。
例
nebula api list_assets --asset-class equity --query NVIDIA
nebula api get_sentiment
nebula api get_mindshare --asset-id NVDA --asset-class equity
nebula api create_chat_completion --body '{"messages":[{"content":"What changed in NVIDIA sentiment this week?","role":"user"}],"stream":false,"thinking_mode":"auto"}'
エンドポイント概要
各 CLI コマンドは、REST API、MCP、CLI、Nebula Agent と同じオペレーションレベルの料金と共有アカウント残高を使用します。
- 固定コストの操作は、リクエストごとに記載された数のクレジットを消費します。
- パラメータはオペレーションのコストを変更しません。ただし、その行で価格が指定されている場合は除きます。マインドシェアまたはセンチメントの予測を refresh=true で再実行すると、5 クレジットではなく 10 クレジットかかります。センチメントはクラスターフィルターの有無にかかわらず、常に 1 クレジットです。
- 行には、より少ない回答に対する低い価格が記載されることもあります。資産が取り得ない予測（not_forecastable）は無料で、1アカウントあたり1時間に最大30件までです。それを超えると、エンドポイントは時間が経過するまで429を返します。エラーで終了したリクエストには料金がかかりません。
- Agentリクエストは、トークン量、モデルコスト、ツール呼び出しに基づく変動価格を使用します。完了したレスポンスには使用されたクレジットが報告されます。
- すべてのオペレーションはすべてのプランで利用できます。プランの違いは、履歴ウィンドウ（Free: 90 日、Pro: 各エンドポイントの最大値で、ほとんどの時系列では 1 年）、レート制限（Free: 1 分あたり 60 リクエスト、Pro: 300）、および含まれる月間クレジットです。クレジットを購入すると利用量は拡張されますが、履歴やレート制限は変わりません。
ディスカバリ
| コマンド | クレジット | 説明 |
|---|
nebula api screener |
2 |
スクリーナー |
nebula api get_top_momentum |
2 |
トップモメンタム |
nebula api get_top_trending |
2 |
トップトレンド |
ルックアップ
| コマンド | クレジット | 説明 |
|---|
nebula api list_assets |
1 |
テキストからアセットID |
nebula api search |
1 |
検索 |
nebula api list_subjects |
1 |
テキストからサブジェクトID |
ソーシャル & センチメント
| コマンド | クレジット | 説明 |
|---|
nebula api get_emotions |
1 |
感情分布 |
nebula api get_mindshare |
2 |
マインドシェア |
nebula api get_related_subjects |
2 |
関連トピック |
nebula api get_sentiment |
1 |
センチメント |
nebula api get_sentiment_timeframes |
1 |
時間軸別センチメント |
nebula api get_social_momentum |
2 |
ソーシャルモメンタム |
予測
| コマンド | クレジット | 説明 |
|---|
nebula api list_forecast_assets |
1 |
予測可能な資産 |
nebula api get_mindshare_forecast |
5（refresh=true の場合は 10、not_forecastable の場合は無料、1時間あたり 30） |
マインドシェア予測 |
nebula api get_sentiment_forecast |
5（refresh=true の場合は 10、not_forecastable の場合は無料、1時間あたり 30） |
センチメント予測 |
市場センチメント
| コマンド | クレジット | 説明 |
|---|
nebula api get_calls |
2 |
ロング／ショートコール |
nebula api get_call_returns |
2 |
コール結果の分布 |
nebula api get_conviction_index |
2 |
コンビクション指数 |
nebula api get_fear_greed_index |
1 |
恐怖と強欲指数 |
nebula api get_price_levels |
2 |
ソーシャルで言及された価格水準 |
nebula api get_social_volume_index |
2 |
ソーシャルと取引量の比較 |
nebula api get_social_volume_profile |
2 |
ソーシャルボリュームプロファイル |
市場データ
| コマンド | クレジット | 説明 |
|---|
nebula api get_price_history |
1 |
価格履歴 |
インテリジェンス
| コマンド | クレジット | 説明 |
|---|
nebula api list_calendar_events |
5 |
カレンダーイベント |
nebula api list_insights |
5 |
インテリジェンス |
nebula api get_insight_attention |
5 |
インサイト注目度 |
クラスター
| コマンド | クレジット | 説明 |
|---|
nebula api list_clusters |
2 |
投稿者クラスター |
nebula api compare_clusters |
2 |
クラスター比較 |
nebula api get_divisive_assets |
2 |
意見が分かれる資産 |
nebula api compare_hype_cycles |
2 |
ハイプサイクル到達 |
nebula api compare_cluster_traits |
2 |
クラスター特性比較 |
nebula api get_cluster_hype_cycles |
2 |
クラスターのハイプサイクル |
nebula api get_cluster_overlap |
2 |
クラスターの重複 |
nebula api get_cluster_profile |
2 |
クラスタープロファイル |
nebula api get_cluster_rotation |
2 |
クラスターローテーション |
nebula api get_cluster_stances |
2 |
クラスターのスタンス |
エージェント
| コマンド | クレジット | 説明 |
|---|
nebula api create_chat_completion |
変数 |
Nebula Agent チャット補完 |
アカウント
| コマンド | クレジット | 説明 |
|---|
nebula api get_account |
0 |
アカウント |
生成コマンド
パス、メソッド、ヘルプテキスト、デフォルト値、セレクターの制約、リクエストスキーマ、バリデーションは OpenAPI から直接取得されます。
nebula api compare_cluster_traits | クラスター特性比較 |
|---|
nebula api compare_clusters | クラスター比較 |
|---|
nebula api compare_hype_cycles | ハイプサイクル到達 |
|---|
nebula api create_chat_completion | Nebula Agent チャット補完 |
|---|
nebula api get_account | アカウント |
|---|
nebula api get_call_returns | コール結果の分布 |
|---|
nebula api get_calls | ロング／ショートコール |
|---|
nebula api get_cluster_hype_cycles | クラスターのハイプサイクル |
|---|
nebula api get_cluster_overlap | クラスターの重複 |
|---|
nebula api get_cluster_profile | クラスタープロファイル |
|---|
nebula api get_cluster_rotation | クラスターローテーション |
|---|
nebula api get_cluster_stances | クラスターのスタンス |
|---|
nebula api get_conviction_index | コンビクション指数 |
|---|
nebula api get_divisive_assets | 意見が分かれる資産 |
|---|
nebula api get_emotions | 感情分布 |
|---|
nebula api get_fear_greed_index | 恐怖と強欲指数 |
|---|
nebula api get_insight_attention | インサイト注目度 |
|---|
nebula api get_mindshare | マインドシェア |
|---|
nebula api get_mindshare_forecast | マインドシェア予測 |
|---|
nebula api get_price_history | 価格履歴 |
|---|
nebula api get_price_levels | ソーシャルで言及された価格水準 |
|---|
nebula api get_related_subjects | 関連トピック |
|---|
nebula api get_sentiment | センチメント |
|---|
nebula api get_sentiment_forecast | センチメント予測 |
|---|
nebula api get_sentiment_timeframes | 時間軸別センチメント |
|---|
nebula api get_social_momentum | ソーシャルモメンタム |
|---|
nebula api get_social_volume_index | ソーシャルと取引量の比較 |
|---|
nebula api get_social_volume_profile | ソーシャルボリュームプロファイル |
|---|
nebula api get_top_momentum | トップモメンタム |
|---|
nebula api get_top_trending | トップトレンド |
|---|
nebula api list_assets | テキストからアセットID |
|---|
nebula api list_calendar_events | カレンダーイベント |
|---|
nebula api list_clusters | 投稿者クラスター |
|---|
nebula api list_forecast_assets | 予測可能な資産 |
|---|
nebula api list_insights | インテリジェンス |
|---|
nebula api list_subjects | テキストからサブジェクトID |
|---|
nebula api screener | スクリーナー |
|---|
nebula api search | 検索 |
|---|
JSON とコーディングエージェント
機械可読な出力には --json を追加します。任意のオペレーションの生成パラメータを確認するには nebula api <operation_id> --help を実行します。
MCP ヘルパー
MCP クライアント設定を出力するには nebula mcp を実行します。セットアップの詳細は MCP ドキュメント を参照してください。
CI と自動化
シークレットマネージャーに NEBULA_API_KEY を設定し、構造化出力には --json を使用します。NEBULA_API_BASE_URL は開発またはセルフホスト API にのみ使用してください。