ソーシャルで言及された価格水準

GET /price-levels

GetPriceLevels

人々がアセットに対して挙げる価格（ターゲット、サポート、気配値）を、価格と時間でバケット化したもの：群衆がどこに期待を置いているかを示します。mentionsは明示された水準を数えるため、1件の投稿が複数の水準を追加することがあります。

ウォレット支払いは 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"
    }
  ]
}