AIXBT Docs
API v3Reference

List Projects

GET
/v3/projects

Canonical Project collection, sorted by trend (default), createdAt, or reinforcedAt, always descending. All filters come from the documented filter values; catalog-derived values (categories, chains, asset types) are discoverable via GET /v3/vocabulary.

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
sort?string
Default"trend"
Value in"trend" | "createdAt" | "reinforcedAt"
ids?string

Comma-separated canonical Project ids.

slugs?string

Comma-separated Project slugs (aliases resolve).

names?string

Comma-separated display names, case-insensitive.

xHandles?string

Comma-separated X handles without the at sign.

tickers?string

Comma-separated asset tickers.

categories?string

Comma-separated canonical taxonomy slugs.

chain?string

Restrict to Projects with an asset deployment on this chain.

address?string

Asset contract address (EVM case-insensitive, other chains case-sensitive).

assetTypes?string

Comma-separated asset types (see /v3/vocabulary).

universe?string
Default"crypto"
Value in"crypto" | "tradfi"
minTrend?number

Minimum current trend measurement.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

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

{
  "data": [
    {
      "id": "665f0a2b1c9d440000a1b2c3",
      "slug": "examplechain",
      "name": "ExampleChain",
      "universe": "crypto",
      "symbol": "EXC",
      "description": "Modular settlement layer for restaked rollups.",
      "identifiers": {
        "coingecko": "examplechain",
        "x": "examplechain"
      },
      "image": "https://images.aixbt.tech/projects/examplechain.png",
      "trend": 87.4,
      "rank": 3,
      "categories": [
        "modular-blockchains",
        "restaking"
      ],
      "assets": [
        {
          "type": "token",
          "chain": "ethereum",
          "address": "0xabc0000000000000000000000000000000000001",
          "primary": true
        }
      ],
      "intel": [
        {
          "id": "6890aa000000000000000001",
          "headline": "Mainnet v2 date confirmed",
          "grade": "polished",
          "detectedAt": "2026-08-04T21:14:00Z"
        }
      ],
      "createdAt": "2026-05-02T10:00:00Z",
      "updatedAt": "2026-08-05T04:58:11Z",
      "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"
    },
    "versions": {
      "trendModel": "trend-v3"
    }
  }
}

{
  "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."
}
{
  "code": "service_unavailable",
  "message": "Measurement history is temporarily unavailable."
}

Reference

Explore and run AIXBT API v3 endpoints

Get a Project GET

Project detail by canonical id or slug. Slug aliases (from renames or merges) resolve to the canonical resource; the response always carries the canonical `slug`. Includes a bounded `relatedProjects` co-mention preview derived from the same posts that support Project Intel; observational only, not partnership or endorsement.