AIXBT Docs

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)
GET
/v2/signals

Authorization

ApiKeyAuth
x-api-key<token>

API key to authorize requests

In: header

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

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

detectedAfter?string

Filter signals originally detected after this date (ISO datetime)

Formatdate-time
detectedBefore?string

Filter signals originally detected before this date (ISO datetime)

Formatdate-time
reinforcedAfter?string

Filter signals reinforced after this date (ISO datetime)

Formatdate-time
reinforcedBefore?string

Filter signals reinforced before this date (ISO datetime)

Formatdate-time
page?integer

Page number for pagination (1-indexed)

Default1
limit?integer

Number of results per page (max 50)

Default50
Rangevalue <= 50

Response Body

application/json

curl -X GET "https://api.aixbt.tech/v2/signals?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,
  "data": [
    {
      "id": "string",
      "detectedAt": "2019-08-24T14:15:22Z",
      "reinforcedAt": "2019-08-24T14:15:22Z",
      "description": "string",
      "projectName": "string",
      "projectId": "string",
      "category": "string",
      "officialSources": [
        "string"
      ],
      "clusters": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "totalCount": 0,
    "hasMore": true
  }
}
Empty