AIXBT Docs

Momentum History

Returns hourly momentum history with cluster attribution breakdown. A multi-cluster source appears once under each cluster. Includes score history for a project over a specified time period. Default period is the last 7 days.

GET
/v2/projects/{id}/momentum

Path Parameters

id*string

The project ID

Query Parameters

start?string

Start timestamp (ISO 8601 format). Defaults to 7 days ago.

Formatdate-time
end?string

End timestamp (ISO 8601 format). Defaults to now.

Formatdate-time
at?string

Historical anchor timestamp (ISO 8601). Sets the end of the momentum time window. Must be in the past.

When used:

  • If end is not provided, at sets the end of the window
  • If end is provided, at acts as a ceiling — end is capped to whichever is earlier
  • If start is not provided, it defaults to 7 days before at
Formatdate-time
includeClusters?string

Whether to include per-hour cluster attribution breakdown. Set to "false" to return only momentum scores (faster, smaller response).

Default"true"
Value in"true" | "false"

Response Body

application/json

curl -X GET "https://api.aixbt.tech/v2/projects/string/momentum?start=2025-11-21T00%3A00%3A00.000Z&end=2025-11-28T00%3A00%3A00.000Z&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"
        }
      ]
    }
  },
  "error": "",
  "data": {
    "projectId": "507f1f77bcf86cd799439011",
    "projectName": "ethereum",
    "data": [
      {
        "timestamp": "2025-11-30T12:00:00.000Z",
        "momentumScore": 0.43,
        "clusters": [
          {
            "id": "VC",
            "name": "VC",
            "count": 3
          }
        ]
      }
    ]
  }
}
Empty
Empty
Empty
Empty