AIXBT Docs
REST APIReference

Get Topic Leaderboard History (Legacy Alias)

Deprecated

GET
/v2/grounding/history

Deprecated compatibility path for paginated historical topic leaderboard snapshots. New integrations should use GET /v2/topics.

Each snapshot contains up to 10 structured topics in attention-rank order. Supports date range filtering with from/to and anchor clamping with at. Requires authentication.

Authorization

ApiKeyAuth
x-api-key<token>

API key to authorize requests

In: header

Query Parameters

at?string

Anchor timestamp. Clamps to if it exceeds this value. Defaults to now.

Formatdate-time
from?string

Range start (createdAt >= from)

Formatdate-time
to?string

Range end (createdAt <= to), clamped by at

Formatdate-time
page?integer
Default1
limit?integer
Default50
Rangevalue <= 50

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/grounding/history"
{
  "status": 200,
  "meta": {
    "history": {
      "archiveAccess": true,
      "enforced": true,
      "lookbackDays": 90,
      "earliestAvailableAt": "2019-08-24T14:15:22Z",
      "enforcementAt": "2026-08-17T00:00:00.000Z"
    }
  },
  "data": [
    {
      "completedAt": "2019-08-24T14:15:22Z",
      "latestEvidenceAt": "2019-08-24T14:15:22Z",
      "windowStartedAt": "2019-08-24T14:15:22Z",
      "topics": [
        {
          "id": "string",
          "rank": 1,
          "name": "string",
          "summary": "string",
          "score": 0,
          "tweetCount": 0,
          "authorCount": 0,
          "lastSeenAt": "2019-08-24T14:15:22Z"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  }
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

Get Trending Topics (Legacy Alias) GET

Deprecated compatibility path returning the top 10 trending crypto topics. New integrations should use `GET /v2/topics`. Topics are sorted by recency-weighted 48-hour attention rank and include summary, score, latest-24-hour tweet/author breadth, and freshness. **No authentication required.** Returns real-time data for all requests. Unauthenticated responses include `meta` with upgrade information. **Authenticated:** Supports historical snapshots via `?at=`. Using `?at=` without authentication returns 403.

Get Trending Topics GET

Returns the top 25 crypto narratives drawing the most attention on X, ranked and refreshed hourly. This is the REST equivalent of the MCP `get_trending_topics` tool. No authentication is required.