ロング／ショートコール

GET /calls

GetCalls

人々がある資産について、または全市場にわたって、時間の経過とともにどれだけのロングコールとショートコールを行っているか。コールとは、資産が上昇または下落すると述べる、ポジションを開示する、または他者に取るよう促すものであり、単なる意見は該当しません。あるグループのコールをカウントするには clusters を送信します。

パラメータのルール:

asset_classとasset_idを一緒に送信するか、どちらも送信しません。

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

パラメータ

asset_id string QUERY

/assets または /search で取得したアセット ID（NVDA、GLD、SPX、bitcoin など）。一緒に返された asset_class とともに送信してください。

Example:NVDA

asset_class string QUERY

asset_id で指定されたアセットのクラス: equity（株式および ETF）、commodity、index、crypto のいずれか。/assets または /search が asset_id とともに返した asset_class を送信してください。

指定可能な値

equitycommodityindexcrypto

Example:equity

hours integer QUERY

遡及ウィンドウ（時間単位）。無料プランでは 90 日まで遡及できます。それより前を指定すると 403 が返されます。

Default:720

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

Example:smart_money

cURL の例

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

レスポンス

200 OK

400 不正なリクエスト

401 未認証

402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます

403 アクセス拒否

404 見つかりません

405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。

429 リクエストが多すぎます

500 内部サーバーエラー

503 サービス利用不可

メディアタイプ application/json

series

array<object> 必須

時系列順に並んだ観測値。

series[].long_calls

integer (int64) 必須

そのバケット内のロングコール数。

series[].short_calls

integer (int64) 必須

そのバケット内のショートコール数。

series[].timestamp

string 必須

観測値またはバケット開始時点の UTC RFC 3339 タイムスタンプ。

{
  "series": [
    {
      "long_calls": 184,
      "short_calls": 71,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}