AIXBT Docs

List Intel

Returns intel (formerly summaries) with filtering and pagination support.

Filter Behavior:

  • Project filters (projectIds, names, xHandles, tickers) use AND logic between different filters
  • Multiple values within a single filter use OR logic
  • Cluster filter returns intel containing ANY of the specified cluster IDs
  • Category filter returns intel matching ANY of the specified categories (OR logic)
  • Date filters (detectedAfter/detectedBefore) filter by original detection date
  • Date filters (reinforcedAfter/reinforcedBefore) filter by last reinforced date
  • All date filters can be used independently, together, or combined (AND logic)
GET
/v2/intel

Query Parameters

projectIds?string

Comma-separated list of project IDs to filter by

names?string

Comma-separated list of project names to filter by (case-insensitive regex match)

xHandles?string

Comma-separated list of X/Twitter handles to filter by

tickers?string

Comma-separated list of token tickers to filter by

address?string

Filter by contract address. Finds projects matching the address, then returns their intel. EVM addresses are case-insensitive; non-EVM addresses (e.g., Solana) are case-sensitive.

clusterIds?string

Comma-separated list of cluster IDs to filter by (OR logic)

categories?string

Comma-separated category names to filter by (OR logic). Valid values: FINANCIAL_EVENT, TOKEN_ECONOMICS, TECH_EVENT, MARKET_ACTIVITY, ONCHAIN_METRICS, PARTNERSHIP, TEAM_UPDATE, REGULATORY, WHALE_ACTIVITY, RISK_ALERT, VISIBILITY_EVENT, OPINION_SPECULATION

hasOfficialSource?boolean

If true, only return intel from official project sources

hasToken?string

Filter intel by whether their associated project has at least one token. When 'true', only intel from projects with tokens is returned. When 'false', only intel from projects without tokens is returned.

Value in"true" | "false"
detectedAfter?string

Filter intel originally detected after this date (ISO datetime)

Formatdate-time
detectedBefore?string

Filter intel originally detected before this date (ISO datetime)

Formatdate-time
reinforcedAfter?string

Filter intel reinforced after this date (ISO datetime)

Formatdate-time
reinforcedBefore?string

Filter intel reinforced before this date (ISO datetime)

Formatdate-time
minClusters?integer

Minimum number of clusters an intel item must belong to. When provided, only intel with at least this many clusters is returned. When omitted, no cluster count filter is applied.

Range1 <= value
sortBy?string

Sort intel by reinforcedAt (default) or detectedAt (original detection date)

Default"reinforcedAt"
Value in"reinforcedAt" | "detectedAt"
page?integer

Page number for pagination (1-indexed)

Default1
limit?integer

Number of results per page (max 50)

Default50
Rangevalue <= 50
at?string

Historical timestamp (ISO 8601). Returns intel as it existed at this point in time. Only available for authenticated requests. Must be in the past.

When used:

  • Only intel detected at or before the timestamp is returned
  • Each intel's activity array is pruned to entries at or before the timestamp
  • reinforcedAt is recalculated from the remaining activity entries

Note: reinforcedAfter/reinforcedBefore filters apply to the stored (unpruned) reinforcedAt. Results may include intel whose pruned reinforcedAt differs from the filter criteria.

Formatdate-time

Response Body

application/json

curl -X GET "https://api.aixbt.tech/v2/intel?address=0x2260fac5e5542a773aa44fbcfedf7c193bc2c599&categories=TECH_EVENT%2CPARTNERSHIP&detectedAfter=2025-01-01T00%3A00%3A00Z&detectedBefore=2025-01-31T23%3A59%3A59Z&reinforcedAfter=2025-01-01T00%3A00%3A00Z&reinforcedBefore=2025-01-31T23%3A59%3A59Z&at=2026-03-25T12%3A00%3A00Z"
{
  "status": 200,
  "meta": {
    "upgrade": {
      "description": "string",
      "protocol": "x402",
      "payment": "USDC on Base",
      "options": [
        {
          "period": "1 day",
          "price": "$10",
          "method": "POST",
          "url": "https://api.aixbt.tech/x402/v2/api-keys/1d"
        }
      ]
    }
  },
  "data": [
    {
      "id": "string",
      "detectedAt": "2019-08-24T14:15:22Z",
      "reinforcedAt": "2019-08-24T14:15:22Z",
      "description": "string",
      "projectName": "string",
      "projectId": "string",
      "category": "string",
      "hasOfficialSource": true,
      "clusters": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "activity": [
        {
          "date": "2019-08-24T14:15:22Z",
          "source": "string",
          "cluster": {
            "id": "string",
            "name": "string"
          },
          "incoming": "string",
          "result": "string",
          "isOfficial": true,
          "fromSignal": {
            "signalId": "string",
            "projectId": "string",
            "projectName": "string"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "totalCount": 0,
    "hasMore": true
  }
}
Empty
Empty