Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token insights

GET /token/{id}/insights

Scale

Description

Paginated list of insights for the token. Filter by time range, tags, order.

Path Parameters

id

stringrequired

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

Query Parameters

limit

integeroptional

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

offset

integeroptional

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

startTimeAfter

string (date-time)optional

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

startTimeBefore

string (date-time)optional

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

updatedAtAfter

string (date-time)optional

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

updatedAtBefore

string (date-time)optional

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

tags

stringoptional

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

excludeTags

stringoptional

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

orderBy

stringoptional

Sort order for insights (e.g. start_time_asc, start_time_desc, updated_at_desc).

Responses

Media type: application/json

insights

array<object> optional

Paginated insight 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[].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[].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).

cURL Example

curl --request GET \
  --url 'https://api.ruma.fun/api/v1/public/token/bitcoin/insights' \
  --header 'X-API-Key: YOUR_API_KEY'

JSON Response

200 · application/json

{
  "insights": [
    {
      "accounts": [
        {
          "author_id": 0,
          "avatar_url": "string",
          "display_name": "string",
          "handle": "string",
          "screen_name": "string",
          "source": "string",
          "source_user_id": "string"
        }
      ],
      "embedding": [
        0
      ],
      "enriched_related_posts": [
        {
          "allHandles": [],
          "allProjects": [],
          "callPerformance": {},
          "permalink": "string",
          "postId": "string",
          "postType": "string",
          "postedAt": "2026-01-15T12:00:00Z",
          "project": {},
          "relatedHandle": "string",
          "relatedToken": 0,
          "sentimentScore": 0,
          "source": "string",
          "tags": [],
          "tweet": {},
          "user": {}
        }
      ],
      "headline": "string",
      "id": 0,
      "importance_score": 0,
      "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"
    }
  ]
}