전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON

REST API
시장 센티먼트

콜 결과 분포

GET /calls/returns

GetCallReturns

최근 콜의 성과를 나타냅니다. 승률, 중앙값 및 평균 수익률, 수익률 분포를 포함합니다. 각 콜은 콜 이후 24시간 동안의 가격 변동을 콜한 사람의 관점에서 평가하므로, 10% 하락에 대한 숏 콜은 +10%가 됩니다. 그룹을 비교하려면 clusters을 전송하세요. 예를 들어 smart_money와 dumb_money을 비교할 수 있습니다.

파라미터 규칙:

asset_class와 asset_id를 함께 보내거나 둘 다 보내지 마세요.

https://nebula-api.hiddensystems.ai/api/v1/x402/calls/returns에서 월렛 결제를 사용할 수 있습니다. 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

resolved_days integer QUERY

포함할 확정 콜의 일수입니다. 24시간 시점이 이 일수 이내에 지난 콜을 포함합니다. 무료 플랜은 90일까지 조회할 수 있으며, 그보다 이전을 요청하면 403을 반환합니다.

Default:7

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/returns' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

200 OK

400 잘못된 요청

401 인증되지 않음

402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.

403 금지됨

404 찾을 수 없음

405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.

429 요청이 너무 많음

500 내부 서버 오류

503 서비스 이용 불가

미디어 타입 application/json

average_return_pct

number (double) 필수

확정 콜 전체의 방향 정렬 평균 수익률이며, 퍼센트 포인트 단위입니다.

buckets

array<object> 필수

오름차순으로 정렬된 수익률 분포 버킷입니다.

buckets[].call_count

integer (int64) 필수

이 수익률 버킷에 속하는 확정 콜 수입니다.

buckets[].capped_total_aligned_return_pct

number (double) 필수

방향 정렬 수익률의 합계로, 각 호출은 ±100%로 상한이 적용되며 단위는 퍼센트 포인트입니다.

buckets[].label

string 필수

사람이 읽을 수 있는 버킷 또는 지수 레이블입니다.

buckets[].lower_bound_pct

number (double) 필수

포함되는 수익률 하한(퍼센트 포인트)입니다. 첫 번째 개방형 구간에서는 null입니다.

buckets[].total_aligned_return_pct

number (double) 필수

이 구간에 속한 방향 정렬 수익률의 합계(퍼센트 포인트)입니다.

buckets[].upper_bound_pct

number (double) 필수

배타적인 수익률 상한(퍼센트 포인트)입니다. 마지막 개방형 구간에서는 null입니다.

losses

integer (int64) 필수

방향 정렬 수익률이 음수인 확정 호출입니다.

median_return_pct

number (double) 필수

확정 호출 전체의 방향 정렬 수익률 중앙값(퍼센트 포인트)입니다.

resolved_calls

integer (int64) 필수

결과가 확정된 호출 수입니다.

resolved_days

integer 필수

통계에 포함되는 확정 호출의 일수입니다.

win_rate_pct

number (double) 필수

확정 호출 중 수익 호출의 비율로, 0에서 100 사이의 값입니다.

wins

integer (int64) 필수

방향 정렬 수익률이 양수인 확정 호출입니다.

{
  "average_return_pct": 4.1,
  "buckets": [
    {
      "call_count": 91,
      "capped_total_aligned_return_pct": -228,
      "label": "-10% to 0%",
      "lower_bound_pct": -10,
      "total_aligned_return_pct": -342.5,
      "upper_bound_pct": 0
    }
  ],
  "losses": 174,
  "median_return_pct": 2.8,
  "resolved_calls": 412,
  "resolved_days": 7,
  "win_rate_pct": 57.77,
  "wins": 238
}