Signal Detail

GET/gateway/v1/heatscore/detail

Returns one project signal card.

Lookup: pass exactly one of `id` (Surf token UUID) or `project_slug`. Use `time_range` (`24h` or `7d`) to select the score window.

Query Parameters

idstring

Surf token UUID. Pass exactly one of id or project_slug.

Example: 25c6612a-395c-4974-94eb-3b5f9f4b2ed7

project_slugstring

Project slug. Pass exactly one of id or project_slug.

Example: synapse

time_rangeenum<string>

Window to compute signal score over: 24h or 7d.

Available options:24h7d

Example: 24h

Signal Detail

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/heatscore/detail?id=25c6612a-395c-4974-94eb-3b5f9f4b2ed7&project_slug=synapse&time_range=24h', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataObjectResponseSignalProject.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>"
  }
}