All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Calls

Notable calls

GET /notable-calls
GetNotableCalls

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.

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:2160

limit integer QUERY

Maximum results returned.

Default:12

cURL Example

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'

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

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

Direction of the call: long or short.

Allowed values
longshort
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

Resolved classification of the call.

Allowed values
winlosspending
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) optional

Raw market-price change over 24 hours, in percentage points.

calls[].price_change_30d_pct
number (double) optional

Raw market-price change over 30 days, in percentage points.

calls[].price_change_7d_pct
number (double) optional

Raw market-price change over seven days, in percentage points.

calls[].profile_url
string required

Public URL of the source author's profile.

{
  "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"
    }
  ]
}