Socially mentioned price levels

GET /price-levels

GetPriceLevels

The prices people name for an asset (targets, supports, and quoted levels), bucketed by price and time: where the crowd is anchoring its expectations. mentions counts stated levels, so one post can add several.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/price-levels. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

asset_id string QUERY required

Asset ID from /assets or /search, such as NVDA, GLD, SPX, or bitcoin. Send it with the asset_class returned alongside it.

Example:NVDA

asset_class string QUERY required

Class of the asset named by asset_id: equity (stocks and ETFs), commodity, index, or crypto. Send the asset_class that /assets or /search returned alongside the asset_id.

Allowed values

equitycommodityindexcrypto

Example:equity

hours integer QUERY

Lookback window in hours. Free plans reach back 90 days; further returns 403.

Default:720

cURL Example

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'

Responses

200 OK

400 Bad Request

401 Unauthorized

402 Credits used up; response includes renewal timing and purchased credit balance

403 Forbidden

404 Not Found

405 Method not allowed; the Allow header lists the supported method

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Media type application/json

levels

array<object> required

Socially mentioned price-level buckets.

levels[].mentions

integer required

Price mentions in this bucket.

levels[].price_usd

number (double) required

Latest or observed market price in US dollars.

levels[].timestamp

string (date-time) required

UTC RFC 3339 timestamp for the observation or bucket start.

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