AIXBT Docs
REST APIReference

Get Trending Topics (Legacy Alias)

Deprecated

GET
/v2/grounding

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.

Query Parameters

at?string

Historical timestamp (ISO 8601). Returns the snapshot that was active at this time. Only available for authenticated requests. Must be in the past.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/grounding?at=2026-03-25T12%3A00%3A00Z"
{
  "status": 200,
  "meta": {
    "upgrade": {
      "description": "string",
      "url": "https://aixbt.tech/subscribe"
    }
  },
  "data": {
    "completedAt": "2019-08-24T14:15:22Z",
    "windowStartedAt": "2019-08-24T14:15:22Z",
    "topics": [
      {
        "id": "string",
        "rank": 0,
        "name": "string",
        "summary": "string",
        "score": 0,
        "tweetCount": 0,
        "authorCount": 0,
        "lastSeenAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
{
  "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 API Key Information GET

Returns metadata and expiry for the authenticated API key.

Get Topic Leaderboard History (Legacy Alias) GET

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.