AIXBT Docs
REST APIReference

List Projects

GET
/v2/projects

Returns a paginated list of projects with signals, coingeckoData, one canonical trendScore, and one trend rank.

Filter Behavior:

  • Multi-value filters (projectIds, names, xHandles, tickers) use OR logic within the same filter
  • Different filters use AND logic between them
  • Project category filters accept canonical taxonomy slugs or supported CoinGecko aliases and match any listed category
  • Market-cap filters require a known positive USD market cap; missing, null, or zero market cap is excluded
  • Example: names=eth,btc&tickers=SOL returns projects matching (name=eth OR name=btc) AND ticker=SOL

Authorization

ApiKeyAuth
x-api-key<token>

API key to authorize requests

In: header

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.

categories?string

Comma-separated canonical project category slugs or supported CoinGecko aliases to filter by

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.

minTrendScore?number

Minimum trend score threshold (0-100)

minMarketCap?number

Minimum USD market cap. Requires projects to have a known positive market cap.

Range0 <= value
maxMarketCap?number

Maximum USD market cap. Requires projects to have a known positive market cap.

Range0 <= value
sortBy?string

Field to sort results by (always descending)

Default"trendScore"
Value in"trendScore" | "createdAt" | "reinforcedAt"
hasToken?boolean

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

intelSortBy?string

Sort embedded intel by last reinforced date or original detection date

Default"reinforcedAt"
Value in"reinforcedAt" | "detectedAt"
intelActivity?string

Controls activity data on embedded intel items. all (default) — full timeline; observations — observation entries only; none — omit activity array.

Default"all"
Value in"all" | "observations" | "none"
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
at?string

Historical timestamp (ISO 8601). Returns project data as it existed at this point in time. Must be in the past. When used, responses include a provenance field indicating data source.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/projects?address=0x2260fac5e5542a773aa44fbcfedf7c193bc2c599&at=2026-03-25T12%3A00%3A00Z"
{
  "status": 200,
  "meta": {
    "history": {
      "archiveAccess": true,
      "enforced": true,
      "lookbackDays": 90,
      "earliestAvailableAt": "2019-08-24T14:15:22Z",
      "enforcementAt": "2026-08-17T00:00:00.000Z"
    }
  },
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "rationale": "string",
      "xHandle": "string",
      "trendScore": 0,
      "trendScoreDelta": 0,
      "rank": 1,
      "coingeckoData": {
        "apiId": "string",
        "symbol": "string",
        "slug": "string",
        "description": "string",
        "contractAddress": "string",
        "categories": [
          "string"
        ],
        "image": {
          "thumb": "http://example.com",
          "small": "http://example.com",
          "large": "http://example.com"
        }
      },
      "metrics": {
        "usd": 0,
        "usdMarketCap": 0,
        "usd24hVol": 0,
        "usd24hChange": 0,
        "lastUpdatedAt": 0,
        "high24h": 0,
        "low24h": 0,
        "athUsd": 0,
        "athDate": "2019-08-24T14:15:22Z",
        "athChangePct": 0,
        "priceChange7d": 0,
        "priceChange14d": 0,
        "priceChange30d": 0
      },
      "tokens": [
        {
          "chain": "string",
          "address": "string",
          "source": "string",
          "primary": true
        }
      ],
      "primaryComputedAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "reinforcedAt": "2019-08-24T14:15:22Z",
      "provenance": "historical",
      "momentumContext": {
        "trendTrajectory": "rising",
        "distinctClusters": 0,
        "peakRank48h": 0,
        "bestRank14d": 0,
        "rankedSince": "2019-08-24T14:15:22Z",
        "leaderboard": {
          "top10": {
            "enteredAt": "2019-08-24T14:15:22Z",
            "currentHours": 0,
            "wasYesterday": true,
            "entryCount24h": 0,
            "stabilityLabel": "flash"
          },
          "top25": {
            "enteredAt": "2019-08-24T14:15:22Z",
            "currentHours": 0,
            "wasYesterday": true,
            "entryCount24h": 0,
            "stabilityLabel": "flash"
          }
        }
      },
      "signals": [
        {
          "id": "string",
          "detectedAt": "2019-08-24T14:15:22Z",
          "reinforcedAt": "2019-08-24T14:15:22Z",
          "description": "string",
          "headline": "string",
          "projectName": "string",
          "projectId": "string",
          "citations": [
            "string"
          ],
          "category": "string",
          "observationCount": 0,
          "hasOfficialSource": true,
          "sentiment": -1,
          "referencesMetrics": true,
          "clusters": [
            {
              "id": "string",
              "name": "string"
            }
          ],
          "activity": [
            {
              "id": "string",
              "date": "2019-08-24T14:15:22Z",
              "action": "string",
              "source": "string",
              "actor": {
                "type": "string"
              },
              "officialSourceUrl": "http://example.com",
              "clusters": [
                {
                  "id": "string",
                  "name": "string"
                }
              ],
              "incoming": "string",
              "result": "string",
              "headline": "string",
              "sentiment": -1,
              "citationEvidence": [
                {
                  "id": "string",
                  "url": "string",
                  "targetActivityIds": [
                    "string"
                  ]
                }
              ],
              "fromSignal": {
                "signalId": "string",
                "projectId": "string",
                "projectName": "string"
              },
              "isOfficial": true,
              "changelog": "string"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "totalCount": 0,
    "hasMore": true
  }
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "error": "string",
  "message": "string",
  "code": "string",
  "status": 0,
  "data": null,
  "meta": {},
  "details": {},
  "pagination": {
    "page": 1,
    "limit": 1,
    "totalCount": 0,
    "hasMore": true
  },
  "limitType": "minute",
  "retryAfterMs": 0,
  "limits": {
    "minute": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    },
    "day": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "2019-08-24T14:15:22Z"
    }
  },
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

Get a Frontier Report GET

Returns the latest published full Frontier Report for a topic. The `id` is the topic id returned by `GET /v2/topics`. This endpoint requires an account-backed credential with Frontier Reports access.

Get Project GET

Returns a project by ID, including the 10 most recent signals, full coingeckoData, and its canonical trend score.