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 the current ranked project roster, up to 100 projects. Live queries use current project ranks; historical at queries 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)
Every non-empty search shape is accepted; responsive bounds and the exact executed scope are disclosed in pagination

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

projectRanking?string

Filter intel to the current ranked project roster, up to 100 projects.

Value in"trend"

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 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 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 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.

Range1 <= value

sentiment?string

Comma-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.

search?string

Free-text Intel search. Every query shape is accepted; pagination metadata discloses responsive coverage bounds and the exact executed scope.

sortBy?string

Sort intel by original detection date (default) or supporting-evidence recency

Default"detectedAt"

Value in"reinforcedAt" | "createdAt" | "detectedAt"

page?integer

Page number for pagination (1-indexed)

Default1

limit?integer

Number of results per page (max 50)

Default50

Rangevalue <= 50

activity?string

Controls activity data in the response. all (default) — full timeline; observations — observation entries only; none — omit activity array.

Default"all"

Value in"all" | "observations" | "none"

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
citations, observationCount, reinforcedAt, clusters, hasOfficialSource, description, headline, and sentiment are derived from activity at or before the timestamp

Formatdate-time

Response 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": {
    "history": {
      "archiveAccess": true,
      "enforced": true,
      "lookbackDays": 90,
      "earliestAvailableAt": "2019-08-24T14:15:22Z",
      "enforcementAt": "2026-08-17T00:00:00.000Z"
    }
  },
  "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,
      "officialSourceUrl": "http://example.com",
      "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"
          },
          "officialSourceUrl": "http://example.com",
          "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,
    "totalCountExact": true,
    "hasMore": true,
    "searchCoverage": "bounded_candidates",
    "searchQuery": "string",
    "executedSearch": "string"
  }
}

{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

List Intel

Authorization

Query Parameters

Response Body

200application/json

400application/json

403application/json

`application/json`

`application/json`

`application/json`