AIXBT Docs

List Projects

Returns a paginated list of projects with signals, coingeckoData, and popularityScore.

Filter Behavior:

  • Multi-value filters (projectIds, names, xHandles, tickers) use OR logic within the same filter
  • Different filters use AND logic between them
  • Example: names=eth,btc&tickers=SOL returns projects matching (name=eth OR name=btc) AND ticker=SOL
GET
/v2/projects

Query Parameters

page?integer

Page number (1-indexed)

Default1
limit?integer

Number of projects per page (max 50)

Default50
Rangevalue <= 50
projectIds?string

Comma-separated list of project ObjectIds to filter by

names?string

Comma-separated list of project names to filter by (case-insensitive regex)

xHandles?string

Comma-separated list of X/Twitter handles to filter by

tickers?string

Comma-separated list of token tickers to filter by

chain?string

Filter by blockchain platform. See /projects/chains for values.

address?string

Filter by contract address. EVM addresses are case-insensitive; non-EVM addresses (e.g., Solana) are case-sensitive. Can be combined with chain to filter by specific chain + address.

minMomentumScore?number

Minimum momentum score threshold

sortBy?string

Field to sort results by (always descending)

Default"momentumScore"
Value in"momentumScore" | "popularityScore" | "createdAt" | "reinforcedAt"
hasToken?boolean

Filter by token presence. true returns only projects with contract addresses, false returns only projects without.

signalSortBy?string

Sort embedded signals by last reinforced date or original detection date

Default"reinforcedAt"
Value in"reinforcedAt" | "detectedAt"
excludeStables?boolean

Exclude stablecoin projects

Defaultfalse
createdAfter?string

Filter projects created on or after this date (ISO 8601)

Formatdate-time
createdBefore?string

Filter projects created on or before this date (ISO 8601)

Formatdate-time

Response Body

application/json

curl -X GET "https://api.aixbt.tech/v2/projects?address=0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
{
  "status": 200,
  "meta": {
    "tier": "free",
    "dataDelayHours": 12,
    "dataAsOf": "2019-08-24T14:15:22Z",
    "upgrade": {
      "description": "string",
      "protocol": "x402",
      "payment": "USDC on Base",
      "options": [
        {
          "period": "1 day",
          "price": "$0.1",
          "method": "POST",
          "url": "https://api.aixbt.tech/x402/v2/api-keys/1d"
        }
      ]
    }
  },
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "rationale": "string",
      "xHandle": "string",
      "momentumScore": 0,
      "scoreDelta": 0,
      "popularityScore": 0,
      "coingeckoData": {
        "apiId": "string",
        "type": "coin",
        "symbol": "string",
        "slug": "string",
        "description": "string",
        "homepage": "string",
        "contractAddress": "string",
        "categories": [
          "string"
        ]
      },
      "metrics": {
        "usd": 0,
        "usdMarketCap": 0,
        "usd24hVol": 0,
        "usd24hChange": 0,
        "lastUpdatedAt": 0
      },
      "tokens": [
        {
          "chain": "string",
          "address": "string",
          "source": "string"
        }
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "reinforcedAt": "2019-08-24T14:15:22Z",
      "signals": [
        {
          "id": "string",
          "date": "2019-08-24T14:15:22Z",
          "reinforcedAt": "2019-08-24T14:15:22Z",
          "description": "string",
          "projectName": "string",
          "projectId": "string",
          "category": "string",
          "clusters": [
            {
              "id": "string",
              "name": "string"
            }
          ],
          "activity": [
            {
              "date": "2019-08-24T14:15:22Z",
              "source": "string",
              "cluster": {
                "id": "string",
                "name": "string"
              },
              "incoming": "string",
              "result": "string",
              "fromSignal": {
                "signalId": "string",
                "projectId": "string",
                "projectName": "string"
              }
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "totalCount": 0,
    "hasMore": true
  }
}
Empty