API v3
Migrating from v2
Route-by-route and property-by-property mapping from API v2 to v3
API v3 is a redesign: consistent resources, one response envelope, clear error codes, and cursor pagination. v2 keeps working unchanged while you migrate; new integrations should target v3.
Routes
| v2 | v3 |
|---|---|
GET /v2/projects | GET /v3/projects: cursor pagination, slug locators, typed assets |
GET /v2/projects/:id | GET /v3/projects/{idOrSlug}: accepts id or slug |
GET /v2/projects/:id/momentum, /rank | GET /v3/projects/{idOrSlug}/series/{measure}: one series shape, trend or rank |
GET /v2/projects/:id/candles, /metrics | Removed: price and market-cap data are no longer part of the API |
GET /v2/projects/:id/neighbors | relatedProjects on Project detail |
GET /v2/projects/chains | Moved into GET /v3/vocabulary |
GET /v2/topics | GET /v3/topics: free tier, keyless |
GET /v2/topics/:id/report | GET /v3/reports/{id}: top-level Reports with revision history |
GET /v2/grounding | Replaced by GET /v3/topics |
GET /v2/intel (and the /v2/signals alias) | GET /v3/intel: graded, filterable, searchable |
GET /v2/intel/:id | GET /v3/intel/{id}: detail with cluster composition |
GET /v2/intel-categories | Moved into GET /v3/vocabulary |
GET /v2/clusters | GET /v3/clusters |
GET /v2/api-keys/info | GET /v3/me: credential, entitlements, limits, history window |
POST /v2/agents/indigo | Removed: use Ask at aixbt.tech |
/v2/recipes/* | Removed: recipes have been discontinued |
all /v1/* | Migrate to v3 |
Envelope
| v2 | v3 |
|---|---|
Body status integer + data | {data, meta}; the HTTP status is the status |
pagination {page, limit, totalCount, hasMore} | Opaque cursor + limit; follow meta.nextCursor |
| Error strings and per-route codes | One error shape {code, message, details?} with a fixed set of codes |
| One generic 404 | Specific miss codes: not_found (never existed), not_current (no longer current) |
at historical reads | Removed: use the Project or Topic series/{measure} route with a from/to window for measurement history |
Properties
| v2 | v3 |
|---|---|
trendScore | trend: the only measurement name |
trendScoreDelta | trendDelta {value, window: "PT24H"} |
signals[] on Project | intel[]: a short preview of recent intel |
cut (undocumented) | grade: documented values chipped → flawless, filterable |
stanceSeries (undocumented) | stance on Topic detail |
coingeckoData block | Removed: symbol, image, and categories are now top-level fields; provider identifiers are not exposed |
tokens[] | Typed assets[]: {type, chain, address, primary} |
xHandle | identifiers.x (join keys under identifiers, e.g. identifiers.coingecko) |
rationale | Removed: use Intel items and their citations |
frontierReport {url, preview} on topics | report {id, title, publishedAt} ref: fetch via /v3/reports/{id} |
Deprecation headers
Deprecated v2 routes respond with an RFC 9745 Deprecation header and an
RFC 8288 Link header pointing at the v3 successor, so clients can detect
the migration path programmatically.