AIXBT Docs
API v3Reference

List Intel

GET
/v3/intel

Discrete evidence-graded developments. grades filters on the evidence ladder from chipped to flawless. Project filters combine with AND across kinds and OR within one comma-separated value.

search is free-text search: the query parses into meaningful terms that must all match, against project identity (names, tickers, handles, addresses, chains) and intel text. Matched items carry a searchMatches array explaining each match. Search results page through meta.nextCursor. Every non-empty query shape is accepted. When responsive candidate or recent-result bounds may omit matches, meta.searchCoverage names the bound and meta.executedSearch discloses any normalized scope that differs from the request.

Authorization

ApiKeyAuth
x-api-key<token>

API key. The Authorization header is accepted as an equivalent carrier. Responses echo the credential class in X-API-Key-Type.

In: header

Query Parameters

cursor?string

Opaque cursor from meta.nextCursor.

limit?integer
Default50
Range1 <= value <= 50
search?string

Free-text deep search; combines with every other filter.

sort?string

detectedAt orders by first sighting; reinforcedAt by the latest confirming observation of any kind (an echoed story).

Default"detectedAt"
Value in"reinforcedAt" | "detectedAt"
projectIds?string
projectSlugs?string
names?string
xHandles?string
tickers?string
address?string
assetTypes?string

Comma-separated asset types of the parent Project.

projectRanking?string

Restrict to Projects in the named ranking cohort.

Value in"trend"
clusterIds?string
categories?string

Comma-separated intel event categories (see /v3/vocabulary).

grades?string

Comma-separated evidence grades.

sentiments?string

Comma-separated sentiment values.

hasOfficialSource?boolean
minClusters?integer
Range1 <= value
detectedAfter?string
Formatdate-time
detectedBefore?string
Formatdate-time
reinforcedAfter?string
Formatdate-time
reinforcedBefore?string
Formatdate-time
activity?string
Default"all"
Value in"all" | "observations" | "none"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v3/intel"

{
  "data": [
    {
      "id": "6890aa000000000000000001",
      "headline": "Mainnet v2 date confirmed",
      "description": "ExampleChain confirmed the v2 mainnet date for September 3rd with a public changelog entry.",
      "grade": "polished",
      "project": {
        "id": "665f0a2b1c9d440000a1b2c3",
        "slug": "examplechain",
        "name": "ExampleChain"
      },
      "category": "product-launch",
      "clusters": [
        {
          "id": "cl_defi",
          "name": "DeFi researchers"
        }
      ],
      "observationCount": 9,
      "hasOfficialSource": true,
      "citations": [
        "https://blog.example.chain/v2-mainnet"
      ],
      "sentiment": {
        "value": "positive"
      },
      "detectedAt": "2026-08-04T21:14:00Z",
      "reinforcedAt": "2026-08-05T03:40:00Z"
    }
  ],
  "meta": {
    "nextCursor": "b3BhcXVlLWN1cnNvcg",
    "history": {
      "archiveAccess": false,
      "enforced": true,
      "lookbackDays": 90,
      "earliestAvailableAt": "2026-05-07T00:00:00Z",
      "enforcementAt": "2026-08-17T00:00:00Z"
    }
  }
}

{
  "code": "invalid_request",
  "message": "minTrend must be numeric",
  "details": {
    "fields": [
      "minTrend"
    ]
  }
}

{
  "code": "credential_required",
  "message": "Provide an API key via the x-api-key header."
}

{
  "code": "entitlement_required",
  "message": "This resource requires the topic-reports entitlement.",
  "details": {
    "entitlement": "topic-reports"
  }
}

{
  "code": "rate_limited",
  "message": "Minute limit reached.",
  "details": {
    "limit": 30,
    "window": "minute"
  }
}
{
  "code": "internal_error",
  "message": "Unexpected error."
}

Get a Topic measurement series GET

The same measurement-series contract used by Projects, for one known Topic id. `trend` keeps the newest real completed score boundary in each hourly bucket. `rank` is the committed boundary series reduced to change points; `value` is `null` when a complete leaderboard publishes the Topic as unranked. Point timestamps preserve the actual completed measurement boundary. Topic history requires an API key.

Get an Intel item GET

Intel detail with the activity trail and cluster composition. The history boundary is enforced against the intel's own recency (`reinforcedAt`, falling back to `detectedAt`).