AIXBT Docs

List Signals (Deprecated)

Deprecated: Use /v2/intel instead.

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

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 signals. EVM addresses are case-insensitive; non-EVM addresses (e.g., Solana) are case-sensitive.

clusterIds?string

Comma-separated list of community 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 signals from official project sources

hasToken?string

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.

Value in"true" | "false"
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
sentiment?string

Comma-separated sentiment buckets to filter by (OR logic). Accepted values (case-insensitive): positive, neutral, negative.

Each signal'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.

sortBy?string

Sort signals 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 signals as they existed at this point in time. Only available for authenticated requests. Must be in the past.

When used:

  • Only signals detected at or before the timestamp are returned
  • Description, clusters, and reinforcedAt are reconstructed from activity at or before the timestamp

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

Formatdate-time

Response 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&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",
      "hasOfficialSource": true,
      "sentiment": -1,
      "clusters": [
        {
          "id": "string",
          "name": "string"
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "totalCount": 0,
    "hasMore": true
  }
}
Empty
Empty