소셜 언급 가격대

GET /price-levels

GetPriceLevels

사람들이 자산에 대해 언급하는 가격(목표가, 지지선, 호가 수준)을 가격과 시간별로 묶은 것으로, 군중이 기대를 어디에 고정하고 있는지 보여줍니다. mentions는 언급된 가격 수준을 세므로 게시물 하나가 여러 개를 추가할 수 있습니다.

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

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/price-levels' \
  --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

levels

array<object> 필수

소셜에서 언급된 가격 수준 버킷.

levels[].mentions

integer 필수

이 버킷의 가격 언급 수.

levels[].price_usd

number (double) 필수

최신 또는 관측된 시장 가격이며 미국 달러 단위입니다.

levels[].timestamp

string (date-time) 필수

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

{
  "levels": [
    {
      "mentions": 43,
      "price_usd": 182.41,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}