Trading volume

GET /trading-volume

GetTradingVolume

Returns trading-volume observations for one resolved asset. The response declares whether values are shares (equity) or USD (crypto). Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.

Parameters

asset_id string QUERY required

Canonical identifier returned by /assets. Stock, commodity, and index IDs are normally ticker or market symbols and use asset_class=equity; crypto IDs are canonical crypto slugs. asset_class is mandatory whenever asset_id is present.

Example:NVDA

asset_class string QUERY required

Namespace of asset_id, or the market class for endpoints with a class-scoped global view. Stocks, commodities, and indices use equity. Equity is the documented default only where the endpoint description states a default.

Allowed values

equitycrypto

Example:equity

hours integer QUERY

Lookback window in hours.

Default:720

granularity string QUERY

Requested time-series bucket size. When omitted, the service chooses a bucket size appropriate for the lookback window.

Allowed values

1h2h4h12h1d

Example:1h

cURL Example

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/trading-volume' \
  --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 Credit balance exhausted

403 Forbidden

404 Not Found

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Media type application/json

series

array<object> required

Chronologically ordered observations.

series[].timestamp

string (date-time) required

UTC RFC 3339 timestamp for the observation or bucket start.

series[].trading_volume

number (double) required

Trading volume for the observation in the unit declared by the response.

unit

string required

Unit used by every value in the series.

Allowed values

sharesusd

{
  "series": [
    {
      "timestamp": "2026-08-07T15:00:00Z",
      "trading_volume": 18420531
    }
  ],
  "unit": "shares"
}