List Projects
Returns a paginated list of projects with signals, coingeckoData, spikingScore, activeScore, and climbingScore.
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=SOLreturns projects matching (name=eth OR name=btc) AND ticker=SOL
Query Parameters
Page number (1-indexed)
1Number of projects per page (max 50)
50value <= 50Comma-separated list of project ObjectIds to filter by
Comma-separated list of project names to filter by (case-insensitive regex)
Comma-separated list of X/Twitter handles to filter by
Comma-separated list of token tickers to filter by
Filter by blockchain platform. See /projects/chains for values.
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.
Minimum spiking score threshold
Field to sort results by (always descending)
"spikingScore""spikingScore" | "activeScore" | "climbingScore" | "createdAt" | "reinforcedAt"Filter by token presence. true returns only projects with contract addresses, false returns only projects without.
Sort embedded intel by last reinforced date or original detection date
"reinforcedAt""reinforcedAt" | "detectedAt"Controls activity data on embedded intel items.
all (default) — full timeline; observations — observation entries only; none — omit activity array.
"all""all" | "observations" | "none"Filter projects created on or after this date (ISO 8601)
date-timeFilter projects created on or before this date (ISO 8601)
date-timeHistorical 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.
date-timeResponse Body
application/json
curl -X GET "https://example.com/v2/projects?address=0x2260fac5e5542a773aa44fbcfedf7c193bc2c599&at=2026-03-25T12%3A00%3A00Z"{
"status": 200,
"meta": {
"upgrade": {
"description": "string",
"protocol": "x402",
"payment": "USDC on Base",
"options": [
{
"period": "1 day",
"price": "$10",
"method": "POST",
"url": "https://api.aixbt.tech/x402/v2/api-keys/1d"
}
]
}
},
"data": [
{
"id": "string",
"name": "string",
"description": "string",
"rationale": "string",
"xHandle": "string",
"spikingScore": 0,
"spikingScoreDelta": 0,
"activeScore": 0,
"climbingScore": 0,
"rank": 1,
"coingeckoData": {
"apiId": "string",
"symbol": "string",
"slug": "string",
"description": "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",
"provenance": "historical",
"momentumContext": {
"spikingTrajectory": "rising",
"climbingTrajectory": "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",
"date": "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",
"name": "string"
},
"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
}
}