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
- projectRanking filters intel to up to 50 projects in the selected ranking. Live queries use current project scores; historical
atqueries use stored score snapshots at the requested timestamp. - 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)
Query Parameters
Comma-separated list of project IDs to filter by
Comma-separated list of project names to filter by (case-insensitive regex match)
Comma-separated list of X/Twitter handles to filter by
Comma-separated list of token tickers to filter by
Filter intel to up to 50 projects in the selected ranking. With at, the ranking comes from stored score snapshots at the requested timestamp.
"spiking" | "climbing" | "active"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.
Comma-separated list of community cluster IDs to filter by (OR logic)
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
If true, only return intel from official project sources
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.
"true" | "false"Filter intel originally detected after this date (ISO datetime)
date-timeFilter intel originally detected before this date (ISO datetime)
date-timeFilter intel reinforced after this date (ISO datetime)
date-timeFilter intel reinforced before this date (ISO datetime)
date-timeMinimum number of community clusters represented on an intel item. Community clusters are overlapping account archetypes, so this is a coverage filter. Use source and reinforcement details for confirmation. When provided, only intel with at least this many clusters is returned. When omitted, no cluster count filter is applied.
1 <= valueComma-separated sentiment buckets to filter by (OR logic).
Accepted values (case-insensitive): positive, neutral, negative.
Each intel's sentiment field is a continuous value in [-1, 1]
(the average of per-activity sentiments). Buckets are derived
with these thresholds:
- positive: sentiment ≥ 0.25
- neutral: -0.25 < sentiment < 0.25
- negative: sentiment ≤ -0.25
Omitting the param (or selecting all three buckets) applies no filter.
Sort intel by reinforcedAt (default) or detectedAt (original detection date)
"reinforcedAt""reinforcedAt" | "detectedAt"Page number for pagination (1-indexed)
1Number of results per page (max 50)
50value <= 50Controls activity data in the response.
all (default) — full timeline; observations — observation entries only; none — omit activity array.
"all""all" | "observations" | "none"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
citations,observationCount,reinforcedAt,clusters,hasOfficialSource,description,headline, andsentimentare derived from activity at or before the timestamp
date-timeResponse Body
application/json
curl -X GET "https://example.com/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&sentiment=positive%2Cnegative&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",
"citations": [
"string"
],
"projectName": "string",
"projectId": "string",
"category": "string",
"observationCount": 0,
"hasOfficialSource": true,
"sentiment": -1,
"referencesMetrics": true,
"metrics": {
"usd": 0,
"usdMarketCap": 0,
"usd24hVol": 0,
"usd24hChange": 0,
"lastUpdatedAt": 0
},
"clusters": [
{
"id": "string",
"name": "string"
}
],
"activity": [
{
"id": "string",
"date": "2019-08-24T14:15:22Z",
"action": "string",
"source": "string",
"actor": {
"type": "string",
"name": "string"
},
"clusters": [
{
"id": "string",
"name": "string"
}
],
"incoming": "string",
"result": "string",
"headline": "string",
"sentiment": -1,
"citationEvidence": [
{
"id": "string",
"url": "string",
"targetActivityIds": [
"string"
]
}
],
"fromSignal": {
"signalId": "string",
"projectId": "string",
"projectName": "string"
},
"isOfficial": true,
"changelog": "string"
}
]
}
],
"pagination": {
"page": 0,
"limit": 0,
"totalCount": 0,
"hasMore": true
}
}