List Signals
Returns signals (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 signals containing ANY of the specified cluster IDs
- Category filter returns signals 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 by contract address. Finds projects matching the address, then returns their signals. EVM addresses are case-insensitive; non-EVM addresses (e.g., Solana) are case-sensitive.
Comma-separated list of 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 signals from official project sources
Filter signals by whether their associated project has at least one token. When 'true', only signals from projects with tokens are returned. When 'false', only signals from projects without tokens are returned.
"true" | "false"Filter signals originally detected after this date (ISO datetime)
date-timeFilter signals originally detected before this date (ISO datetime)
date-timeFilter signals reinforced after this date (ISO datetime)
date-timeFilter signals reinforced before this date (ISO datetime)
date-timeSort signals 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 <= 50Response Body
application/json
curl -X GET "https://api.aixbt.tech/v2/signals?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"{
"status": 200,
"meta": {
"tier": "free",
"dataDelayHours": 12,
"dataAsOf": "2019-08-24T14:15:22Z",
"upgrade": {
"description": "string",
"protocol": "x402",
"payment": "USDC on Base",
"options": [
{
"period": "1 day",
"price": "$0.1",
"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
}
}