소셜 대비 거래량

GET /social-volume-index

GetSocialVolumeIndex

자산에 대해 거래와 대화 중 어느 쪽이 더 활발한지를 각각 자체 90일 평균과 비교한 값입니다. volume_index는 0–100으로, 50이면 둘 다 같은 정도로 활발하고, 50을 넘으면 거래가 대화보다 앞서며, 50 미만이면 대화가 거래보다 앞섭니다. 최대 90일까지 일별로 제공됩니다.

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

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/social-volume-index' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --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[].posts

number (double) 필수

해당 일자의 자산 게시물 수로, 봇은 제외됩니다.

series[].social_relative

number (double) 필수

최근 7일간 자산 게시물 수를 이전 90일간의 중앙 7일 게시물 수로 나눈 배수입니다. 1이 보통입니다.

series[].timestamp

string (date-time) 필수

관측값 또는 버킷 시작 시점의 UTC RFC 3339 타임스탬프입니다.

series[].trading_relative

number (double) 필수

최근 7일간 자산의 달러 거래량을 이전 90일간의 중앙 7일 거래량으로 나눈 배수입니다. 1이 보통입니다.

series[].volume_index

number (double) 필수

0에서 100 사이의 값으로, 50이면 거래와 대화가 각자의 평균 대비 같은 정도로 활발하고, 50을 넘으면 거래가 대화보다 앞서며, 50 미만이면 대화가 거래보다 앞섭니다.

series[].volume_usd

number (double) 필수

해당 일자의 자산 달러 거래량입니다. 주식의 주말처럼 거래가 없는 날에는 0입니다.

{
  "series": [
    {
      "posts": 684,
      "social_relative": 1.84,
      "timestamp": "2026-08-07T15:00:00Z",
      "trading_relative": 1.29,
      "volume_index": 41.2,
      "volume_usd": 41250000000
    }
  ]
}