Long/short calls

GET /calls

GetCalls

How many long and short calls people are making on an asset, or across every market, over time. A call says an asset will rise or fall, discloses a position, or tells others to take one; plain opinion does not count. Send clusters to count one group's calls.

Parameter rules:

Send asset_class and asset_id together, or neither.

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

Parameters

asset_id string QUERY

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

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

clusters array<string> QUERY

Author clusters to read; repeat to combine, for example clusters=kols&clusters=media. Selected clusters are added together, and an author can belong to several.

Callers: smart_money (best-performing callers), dumb_money (worst-performing), top_degens (best on small-cap crypto)
Timing: early_movers (first to talk about an asset as attention rises), late_movers (arrive at the peak or after)
Builders: developers, founders, team_leaders, project_accounts
Institutions: vcs, asset_managers, dao_guild_funds, incubators, exchanges
Influence: kols, celebrities, media, marketer, shiller
Analysts: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
Traders: position_trader, swing_trader, day_trader
Bias: perma_bull, doomer, tribalist
Other: political, nft, bots, automated_ai

Example:smart_money

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls' \
  --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

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.

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