# Notable calls

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

## Description

Returns ranked source posts containing notable long or short calls for one resolved asset, including entry price, direction-aligned performance, outcome, and source attribution. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.

## cURL Example

```bash
curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/notable-calls' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Path Parameters

No path parameters for this endpoint.

## Query Parameters

- `asset_id` (string, 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.
- `asset_class` (string, required, 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: 2160): Lookback window in hours.
- `limit` (integer, optional, default: 12): Maximum results returned.

## Response

OK

- `calls` (array<object>, required): Ranked notable calls.
- `calls[].aligned_return_pct` (number (double), required): Return since entry aligned to call direction, in percentage points; positive means the call was correct.
- `calls[].author_handle` (string, required): Source author's public handle.
- `calls[].author_name` (string, required): Source author's display name.
- `calls[].avatar_url` (string, required): Source author's avatar URL.
- `calls[].call_id` (integer (int64), required): Stable identifier for the market call.
- `calls[].direction` (string, required, enum: long, short): Direction of the call: long or short.
- `calls[].entry_price_usd` (number (double), required): Asset price in US dollars when the call was made.
- `calls[].follower_count` (integer (int64), required): Source author's follower count at ingestion time.
- `calls[].notability_score` (number (double), required): Relative ranking score combining caller influence and directional performance.
- `calls[].outcome` (string, required, enum: win, loss, pending): Resolved classification of the call.
- `calls[].post_id` (string, required): Identifier of the source post.
- `calls[].post_text` (string, required): Text of the source post.
- `calls[].posted_at` (string, required): UTC RFC 3339 time when the source call was published.
- `calls[].price_change_24h_pct` (number (double)): Raw market-price change over 24 hours, in percentage points.
- `calls[].price_change_30d_pct` (number (double)): Raw market-price change over 30 days, in percentage points.
- `calls[].price_change_7d_pct` (number (double)): Raw market-price change over seven days, in percentage points.
- `calls[].profile_url` (string, required): Public URL of the source author's profile.

Media type: `application/json`

## JSON Response

```json
{
  "calls": [
    {
      "aligned_return_pct": 8.7,
      "author_handle": "marketanalyst",
      "author_name": "Market Analyst",
      "avatar_url": "https://cdn.hiddensystems.ai/avatars/marketanalyst.jpg",
      "call_id": 98721,
      "direction": "long",
      "entry_price_usd": 168.25,
      "follower_count": 245000,
      "notability_score": 0.91,
      "outcome": "win",
      "post_id": "1952712345678901234",
      "post_text": "NVIDIA demand remains stronger than consensus expects.",
      "posted_at": "2026-08-05T13:42:00Z",
      "price_change_24h_pct": 2.37,
      "price_change_30d_pct": 12.46,
      "price_change_7d_pct": 5.81,
      "profile_url": "https://x.com/marketanalyst"
    }
  ]
}
```