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

Token intelligence

GET /token/{id}/intelligence
GetTokenIdIntelligence

Paginated curated intelligence for the token. Filter by time range, tags, and order.

Parameters

id string PATH required

Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

Example:bitcoin

limit integer QUERY

Maximum number of items to return (default and max may vary by endpoint).

Example:50

offset integer QUERY

Number of items to skip for pagination (use with limit).

Example:0

startTimeAfter string (date-time) QUERY

Return insights that start after this ISO 8601 date-time.

Example:2026-01-01T00:00:00Z

startTimeBefore string (date-time) QUERY

Return insights that start before this ISO 8601 date-time.

Example:2026-01-01T00:00:00Z

updatedAtAfter string (date-time) QUERY

Return insights last updated after this ISO 8601 date-time.

Example:string

updatedAtBefore string (date-time) QUERY

Return insights last updated before this ISO 8601 date-time.

Example:string

tags string QUERY

Filter insights by tags (comma-separated; include only insights with any of these tags).

Example:top_callers

excludeTags string QUERY

Exclude insights that have any of these tags (comma-separated).

Example:string

orderBy string QUERY

Sort order for insights.

Allowed values
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Example:start_time_asc

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/intelligence' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK
400 Bad Request ErrorResponse

Media type application/json

insights
array<object> optional

Paginated intelligence records related to the token.
insights[].accounts
array<object> optional

No description provided.
insights[].accounts[].author_id
integer (int64) optional

Internal Nebula author identifier for this account.

insights[].accounts[].avatar_url
string optional

URL of the account’s avatar image.

insights[].accounts[].display_name
string optional

Display name of the author account.

insights[].accounts[].handle
string optional

No description provided.

insights[].accounts[].screen_name
string optional

Screen name or handle on the source platform.

insights[].accounts[].source
string optional

Origin/source of the insight data.

insights[].accounts[].source_user_id
string optional

Identifier for the author on the source platform.

insights[].category
string optional

No description provided.

insights[].headline
string optional

No description provided.

insights[].id
integer (int64) optional

No description provided.

insights[].importance_score
integer optional

Relative importance score for the insight (higher is more important).

insights[].primary_subject
object optional

No description provided.
insights[].primary_subject.account
object optional

No description provided.
insights[].primary_subject.account.author_id
integer (int64) optional

Internal Nebula author identifier for this account.

insights[].primary_subject.account.avatar_url
string optional

URL of the account’s avatar image.

insights[].primary_subject.account.display_name
string optional

Display name of the author account.

insights[].primary_subject.account.handle
string optional

No description provided.

insights[].primary_subject.account.screen_name
string optional

Screen name or handle on the source platform.

insights[].primary_subject.account.source
string optional

Origin/source of the insight data.

insights[].primary_subject.account.source_user_id
string optional

Identifier for the author on the source platform.

insights[].primary_subject.project
object optional

No description provided.
insights[].primary_subject.project.handle
string optional

No description provided.

insights[].primary_subject.project.image_url
string optional

Project or token logo URL.

insights[].primary_subject.project.internal_id
integer (int64) optional

Internal Nebula identifier for the account or project.

insights[].primary_subject.project.name
string optional

Display name.

insights[].primary_subject.project.symbol
string optional

Token symbol.

insights[].primary_subject.type
string optional

No description provided.

insights[].projects
array<object> optional

No description provided.
insights[].projects[].handle
string optional

No description provided.

insights[].projects[].image_url
string optional

Project or token logo URL.

insights[].projects[].internal_id
integer (int64) optional

Internal Nebula identifier for the account or project.

insights[].projects[].name
string optional

Display name.

insights[].projects[].symbol
string optional

Token symbol.

insights[].sentiment
integer optional

No description provided.

insights[].start_time
string (date-time) optional

When the insight became active or relevant (UTC).

insights[].summary
string optional

Summary output for the endpoint.

insights[].tags
array<string> optional

Tag selectors applied to the request.

insights[].updated_at
string (date-time) optional

Last time the insight record was updated (UTC).

{
  "insights": [
    {
      "accounts": [
        {
          "author_id": 0,
          "avatar_url": "string",
          "display_name": "string",
          "handle": "string",
          "screen_name": "string",
          "source": "string",
          "source_user_id": "string"
        }
      ],
      "category": "string",
      "headline": "string",
      "id": 0,
      "importance_score": 0,
      "primary_subject": {
        "account": {
          "author_id": 0,
          "avatar_url": "string",
          "display_name": "string",
          "handle": "string",
          "screen_name": "string",
          "source": "string",
          "source_user_id": "string"
        },
        "project": {
          "handle": "string",
          "image_url": "string",
          "internal_id": 0,
          "name": "string",
          "symbol": "string"
        },
        "type": "string"
      },
      "projects": [
        {
          "handle": "string",
          "image_url": "string",
          "internal_id": 0,
          "name": "string",
          "symbol": "string"
        }
      ],
      "sentiment": 0,
      "start_time": "2026-01-15T12:00:00Z",
      "summary": "string",
      "tags": [
        "string"
      ],
      "updated_at": "2026-01-15T12:00:00Z"
    }
  ]
}