Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token intelligence

GET /token/{id}/intelligence
GetTokenIdIntelligence

Paginated intelligence for the token. Filter by time range, tags, 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 (e.g. start_time_asc, start_time_desc, updated_at_desc).

Example:string

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 Ruma 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[].embedding
array<number (float)> optional

Numeric embedding vector for semantic similarity search.

insights[].enriched_related_posts
array<object> optional

Posts related to this insight with additional enrichment.
insights[].enriched_related_posts[].allHandles
array<string> optional

No description provided.

insights[].enriched_related_posts[].allProjects
array<object> optional

No description provided.

insights[].enriched_related_posts[].callPerformance
object optional

No description provided.

insights[].enriched_related_posts[].permalink
string optional

No description provided.

insights[].enriched_related_posts[].postId
string optional

No description provided.

insights[].enriched_related_posts[].postType
string optional

No description provided.

insights[].enriched_related_posts[].postedAt
string (date-time) optional

No description provided.

insights[].enriched_related_posts[].project
object optional

No description provided.

insights[].enriched_related_posts[].relatedHandle
string optional

No description provided.

insights[].enriched_related_posts[].relatedToken
integer (int64) optional

No description provided.

insights[].enriched_related_posts[].sentimentScore
number (double) optional

No description provided.

insights[].enriched_related_posts[].source
string optional

Origin/source of the insight data.

insights[].enriched_related_posts[].tags
array<object> optional

Tag selectors applied to the request.

insights[].enriched_related_posts[].tweet
object optional

No description provided.

insights[].enriched_related_posts[].user
object 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 Ruma 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 Ruma 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 Ruma 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).