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 substantive evolution (default), supporting-evidence recency, or original detection date (createdAt and detectedAt are aliases)

Default"lastEvolvedAt"
Value in"lastEvolvedAt" | "reinforcedAt" | "createdAt" | "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,
      "rankBand": "strong",
      "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.