# List Projects

`GET /v3/projects`

Canonical Project collection. Use `rank` for the committed leaderboard,
ascending and limited to ranked Projects; confidence band precedes score.
`trend` (default) sorts raw score, while `createdAt` and `reinforcedAt`
sort by time, all descending. All filters come
from the documented filter values; catalog-derived values
(categories, chains, asset types) are discoverable via
`GET /v3/vocabulary`.

## Authentication

Required. Send an API key in the `x-api-key` header.

## Parameters

```json
[
  {
    "$ref": "#/components/parameters/Cursor"
  },
  {
    "$ref": "#/components/parameters/Limit"
  },
  {
    "name": "sort",
    "in": "query",
    "schema": {
      "type": "string",
      "enum": [
        "rank",
        "trend",
        "createdAt",
        "reinforcedAt"
      ],
      "default": "trend"
    }
  },
  {
    "name": "ids",
    "in": "query",
    "description": "Comma-separated canonical Project ids.",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "slugs",
    "in": "query",
    "description": "Comma-separated Project slugs (aliases resolve).",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "names",
    "in": "query",
    "description": "Comma-separated display names, case-insensitive.",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "xHandles",
    "in": "query",
    "description": "Comma-separated X handles without the at sign.",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "tickers",
    "in": "query",
    "description": "Comma-separated asset tickers.",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "categories",
    "in": "query",
    "description": "Comma-separated canonical taxonomy slugs.",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "chain",
    "in": "query",
    "description": "Restrict to Projects with an asset deployment on this chain.",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "address",
    "in": "query",
    "description": "Asset contract address (EVM case-insensitive, other chains case-sensitive).",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "assetTypes",
    "in": "query",
    "description": "Comma-separated asset types (see `/v3/vocabulary`).",
    "schema": {
      "type": "string"
    }
  },
  {
    "name": "universe",
    "in": "query",
    "schema": {
      "type": "string",
      "enum": [
        "crypto"
      ],
      "default": "crypto"
    }
  },
  {
    "name": "minTrend",
    "in": "query",
    "description": "Minimum current trend measurement.",
    "schema": {
      "type": "number"
    }
  }
]
```

## Request body

None.

## Responses

```json
{
  "200": {
    "description": "Project page.",
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "data",
            "meta"
          ],
          "properties": {
            "data": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Project"
              }
            },
            "meta": {
              "$ref": "#/components/schemas/CollectionMeta"
            }
          }
        },
        "examples": {
          "success": {
            "summary": "First page of Projects ranked by trend",
            "value": {
              "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": {
                  "lookbackDays": 90,
                  "earliestAvailableAt": "2026-05-07T00:00:00Z"
                },
                "versions": {
                  "trendModel": "trend-v3"
                }
              }
            }
          },
          "empty": {
            "summary": "Filter matched nothing",
            "value": {
              "data": [],
              "meta": {
                "nextCursor": null
              }
            }
          }
        }
      }
    }
  },
  "400": {
    "$ref": "#/components/responses/BadRequest"
  },
  "401": {
    "$ref": "#/components/responses/Unauthorized"
  },
  "403": {
    "$ref": "#/components/responses/Forbidden"
  },
  "429": {
    "$ref": "#/components/responses/RateLimited"
  },
  "500": {
    "$ref": "#/components/responses/Internal"
  },
  "503": {
    "$ref": "#/components/responses/Unavailable"
  }
}
```

## Referenced schemas

```json
{
  "Project": {
    "type": "object",
    "required": [
      "id",
      "slug",
      "name",
      "universe",
      "trend",
      "categories",
      "assets",
      "createdAt",
      "updatedAt"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "slug": {
        "type": "string"
      },
      "name": {
        "type": "string"
      },
      "universe": {
        "type": "string",
        "enum": [
          "crypto"
        ],
        "description": "Entity universe; shares the Cluster enum."
      },
      "symbol": {
        "type": "string"
      },
      "description": {
        "type": "string"
      },
      "identifiers": {
        "$ref": "#/components/schemas/Identifiers"
      },
      "image": {
        "type": "string",
        "format": "uri"
      },
      "trend": {
        "type": "number",
        "description": "Canonical trend measurement from the shared trend model.\nComparable only within the same `meta.versions.trendModel`.\n"
      },
      "trendDelta": {
        "type": "object",
        "required": [
          "value",
          "window"
        ],
        "description": "The current trend minus the trend at the scoring boundary 24 hours\nearlier (0 when that boundary had no estimate). Emitted on Project\ndetail; absent when neither has an estimate or history is\nunavailable.\n",
        "properties": {
          "value": {
            "type": "number"
          },
          "window": {
            "type": "string",
            "enum": [
              "PT24H"
            ]
          }
        }
      },
      "rank": {
        "type": "integer",
        "description": "Committed leaderboard rank within the Project's universe; absent while unranked."
      },
      "rankBand": {
        "type": "string",
        "enum": [
          "strong",
          "corroborated"
        ],
        "description": "Evidence band used before score in the Project leaderboard; absent while unranked."
      },
      "categories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Canonical taxonomy slugs."
      },
      "assets": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Asset"
        }
      },
      "intel": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/IntelRef"
        },
        "description": "Bounded preview of current Intel, newest first."
      },
      "createdAt": {
        "type": "string",
        "format": "date-time"
      },
      "updatedAt": {
        "type": "string",
        "format": "date-time"
      },
      "reinforcedAt": {
        "type": "string",
        "format": "date-time"
      }
    }
  },
  "Identifiers": {
    "type": "object",
    "description": "Stable external join keys for composing AIXBT data with sources the\nconsumer licenses directly. Keys are additive; values are\nidentifiers only; v3 never attaches the external source's data to\nthem.\n",
    "properties": {
      "coingecko": {
        "type": "string",
        "description": "CoinGecko API id of the primary asset."
      },
      "x": {
        "type": "string",
        "description": "X handle without the at sign."
      }
    }
  },
  "Asset": {
    "type": "object",
    "required": [
      "type",
      "primary"
    ],
    "description": "Canonical instrument identity owned by the Asset registry. Identity\nonly; v3 never attaches third-party market values to an asset.\nUniverse-specific fields are additive per type (crypto types carry\n`chain` and `address`).\n",
    "properties": {
      "type": {
        "type": "string",
        "enum": [
          "token",
          "stablecoin",
          "nft-collection"
        ]
      },
      "chain": {
        "type": "string"
      },
      "address": {
        "type": "string"
      },
      "symbol": {
        "type": "string"
      },
      "primary": {
        "type": "boolean",
        "description": "The Project's primary instrument."
      }
    }
  },
  "IntelRef": {
    "type": "object",
    "required": [
      "id",
      "grade",
      "detectedAt"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "headline": {
        "type": "string"
      },
      "grade": {
        "$ref": "#/components/schemas/Grade"
      },
      "detectedAt": {
        "type": "string",
        "format": "date-time"
      }
    }
  },
  "Grade": {
    "type": "string",
    "enum": [
      "chipped",
      "flawed",
      "cut",
      "polished",
      "flawless"
    ],
    "description": "Evidence grade of an Intel item, lowest to highest. Grades describe\nthe shape of the evidence, never the truth of the claim.\n"
  },
  "CollectionMeta": {
    "allOf": [
      {
        "$ref": "#/components/schemas/Meta"
      },
      {
        "type": "object",
        "required": [
          "nextCursor"
        ],
        "properties": {
          "nextCursor": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cursor for the next page; `null` on the last page."
          }
        }
      }
    ]
  },
  "Meta": {
    "type": "object",
    "description": "Response metadata. Empty when nothing applies.",
    "properties": {
      "history": {
        "$ref": "#/components/schemas/HistoryMeta"
      },
      "versions": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "Named component versions that shaped this response."
      }
    }
  },
  "HistoryMeta": {
    "type": "object",
    "description": "The history window applied to this response. Both fields are null when the account has no history limit.",
    "required": [
      "lookbackDays",
      "earliestAvailableAt"
    ],
    "properties": {
      "lookbackDays": {
        "oneOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ]
      },
      "earliestAvailableAt": {
        "oneOf": [
          {
            "type": "string",
            "format": "date-time"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  }
}
```

Schema references resolve against the [canonical OpenAPI specification](https://api.aixbt.tech/v3/openapi.yaml).