Signal Projects

GET/gateway/v1/heatscore/projects

Returns a paginated ranked snapshot of project signal cards.

Included fields: project identity, score, latest price, price-change percentages, core state, dimension scores, compact token signals, AI summaries, and supporting market metrics.

Filters: `time_range` (`24h` or `7d`). Supports `limit`/`offset` pagination.

Query Parameters

time_rangeenum<string>

Window to compute signal scores over: 24h or 7d. Returns a ranked snapshot, not a time-series.

Available options:24h7d

Example: 24h

limitinteger

Results per page

Example: 20

offsetinteger

Pagination offset

Example: 0

Signal Projects

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/heatscore/projects?time_range=24h&limit=20&offset=0', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseSignalProject.json",
  "data": [
    {
      "ai_summary": {},
      "baseline": 123,
      "change_percent": 123,
      "change_vs_previous_percent": 123,
      "computed_hour": 123,
      "core_state": {
        "driver": "<string>",
        "priority": 123,
        "reason": "<string>",
        "state": "<string>",
        "state_type": "<string>",
        "strength": "<string>"
      },
      "driver": "<string>",
      "evidence_score": 123,
      "heat_dimensions": {
        "derivative": 123,
        "derivative_components": [
          {
            "metric": "<string>",
            "score": 123,
            "used": true,
            "weight": 123
          }
        ],
        "flow": 123,
        "movement": 123,
        "social": 123
      },
      "heat_score": 123,
      "heat_score_by_range": {},
      "heat_score_change_vs_previous_percent_by_range": {},
      "heat_score_previous_by_range": {},
      "liquidation_long_24h": 123,
      "liquidation_long_short_ratio_24h": 123,
      "liquidation_short_24h": 123,
      "logo": "<string>",
      "market_relevance": 123,
      "metric": "<string>",
      "name": "<string>",
      "open_interest": 123,
      "points_used": 123,
      "previous_value": 123,
      "price": 123,
      "price_change_percent": {
        "1h": 123,
        "24h": 123,
        "7d": 123
      },
      "project_id": "<string>",
      "project_slug": "<string>",
      "rank": 123,
      "score": 123,
      "signed_z": 123,
      "symbol": "<string>",
      "time_range": "<string>",
      "token_id": "<string>",
      "token_signals": {},
      "updated_at": 123,
      "value": 123,
      "volume_24h": 123,
      "volume_24h_change_percent": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}