가격 이력

GET /price-history

GetPriceHistory

자산의 소셜 데이터와 비교해 볼 수 있는 시간 경과에 따른 가격입니다. 지수 값은 지수 포인트 단위입니다. 암호화폐 자산에 거래소 캔들이 없으면 high_usd 및 low_usd는 최근 24시간 범위입니다.

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

granularity string QUERY

요청한 시계열 버킷 크기입니다. 생략하면 서비스가 조회 기간(lookback window)에 적합한 버킷 크기를 선택합니다.

허용 값

1h2h4h12h1d

Example:1h

cURL 예제

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

number (double) 선택 사항

관측된 최고가이며 미국 달러 단위입니다.

series[].low_usd

number (double) 선택 사항

관측된 최저가이며 미국 달러 단위입니다.

series[].price_usd

number (double) 선택 사항

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

series[].timestamp

string (date-time) 필수

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

{
  "series": [
    {
      "high_usd": 184.17,
      "low_usd": 179.82,
      "price_usd": 182.41,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}