롱/숏 콜

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). 선택한 클러스터는 합산되며, 한 작성자가 여러 클러스터에 속할 수 있습니다.

Callers: smart_money(성과가 가장 좋은 콜러), dumb_money(성과가 가장 나쁜 콜러), top_degens(소형주 크립토에서 가장 우수한 콜러)
Timing: early_movers(관심이 높아질 때 자산에 대해 가장 먼저 언급), late_movers(정점이나 그 이후에 진입)
빌더: developers, founders, team_leaders, project_accounts
기관: vcs, asset_managers, dao_guild_funds, incubators, exchanges
인플루언스: kols, celebrities, media, marketer, shiller
애널리스트: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
트레이더: position_trader, swing_trader, day_trader
바이어스: perma_bull, doomer, tribalist
기타: 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"
    }
  ]
}