Overview

API v3 is the primary AIXBT API: one consistent view of Projects, Topics, Intel, Reports, and Clusters, available over REST and MCP with identical data. The base URL is https://api.aixbt.tech/v3; the OpenAPI document is served at /v3/openapi.yaml, with interactive docs at https://api.aixbt.tech/v3/docs.

Authentication

Current Topic list and detail are the keyless free tier:

curl --fail-with-body "https://api.aixbt.tech/v3/topics"

Everything else requires a key from Integrations, sent in the x-api-key header:

curl --fail-with-body "https://api.aixbt.tech/v3/projects?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

Call GET /v3/me to see your credential, entitlements, rate limits, and history window.

One envelope, typed errors

Every success body is {data, meta}. Failures are one error object with a fixed set of code values (invalid_request, credential_required, entitlement_required, history_window_exceeded, not_found, not_current, rate_limited, …), and misses are specific: not_found (never existed) versus not_current (exists, but no longer current).

{
  "data": [],
  "meta": { "nextCursor": null }
}

Cursor pagination

List endpoints page with an opaque cursor and limit (max 50). Follow meta.nextCursor until it is null. A cursor is tied to the query that produced it: reusing it with different parameters fails with invalid_request.

Free-text search

GET /v3/intel?search=... runs deep search across project identity (names, tickers, handles, contract addresses, chains) and intel text, and it combines with every other filter. Matched items carry a searchMatches evidence array explaining each hit. An overly broad query fails with an invalid_request asking for narrower terms.

Vocabulary discovery

GET /v3/vocabulary serves every value a filter accepts: grades, sentiments, stances, sort keys, activity modes, asset types, alert vocabularies, plus catalog-derived project categories, intel categories, and chains.

Measurements

trend (0–100) estimates sustained excess attention over the next six hours; rank is position on the board, updating on 15-minute boundaries. GET /v3/projects/{idOrSlug}/series/{measure} and GET /v3/topics/{topicId}/series/{measure} serve the history of both in one series shape. Topic history, like Project history, requires an API key and follows its history window. The API serves AIXBT's own measurements, not third-party market data; published Reports may quote market figures with source attribution.

Migrating from v2

The migration guide maps every v2 route and field to its v3 equivalent.