# Call activity

- Method: `GET`
- Path: `/calls`
- Tier: Pro
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-calls/
- Interactive docs: https://docs.hiddensystems.ai/nebula/api/#endpoint=get-calls

## Description

Returns long and short call counts over time for one resolved asset. Omit both asset_id and asset_class for the all-market global view; asset_class cannot be used alone. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity. Parameter rules: asset_class requires asset_id. asset_id requires asset_class.

## cURL Example

```bash
curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Path Parameters

No path parameters for this endpoint.

## Query Parameters

- `asset_id` (string, optional): 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.
- `asset_class` (string, optional, allowed: equity, crypto): 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.
- `hours` (integer, optional, default: 720): Lookback window in hours.
- `clusters` (array<string>, optional): Repeatable canonical author-cluster filter. Use /clusters to discover current cluster IDs.

## Response

OK

- `series` (array<object>, required): Chronologically ordered observations.
- `series[].long_calls` (integer (int64), required): Number of long calls in the bucket.
- `series[].short_calls` (integer (int64), required): Number of short calls in the bucket.
- `series[].timestamp` (string, required): UTC RFC 3339 timestamp for the observation or bucket start.

Media type: `application/json`

## JSON Response

```json
{
  "series": [
    {
      "long_calls": 184,
      "short_calls": 71,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}
```