Intelligence

Query historical Trail Heat snapshots

Requires Pioneer or Syndicate access through the TollBooth. Scout receives 402 even within its free quota. Requires the trail_heat_snapshots store; missing storage or query failures return 503 rather than fabricated history. With protocolId, returns that protocol's daily history; without it, returns the latest snapshot per protocol in the requested window. Legacy editorial and canonical-live vintages are not quantitatively comparable; inspect data_evidence, evidence_vintage and data_quality before trend analysis.

get/v1/agent/historical-trailheat

Request

  • Base URL: https://www.farmdash.one/api
  • URL: https://www.farmdash.one/api/v1/agent/historical-trailheat
  • Auth: HTTP bearer

Query parameters

protocolIdstring

Optional protocol identifier; runtime removes characters outside a-z, A-Z, 0-9 and underscore, then truncates to 64 characters. Omit or send empty for all protocols.

daysinteger

Runtime uses parseInt base 10, defaults falsy or invalid results to 30, then clamps to 1 through 365; out-of-range input is normalized, not rejected.

Headers

X-ClawHub-Skillstring
Example:farmdash-signal-architect

ClawHub skill attribution. An installed FarmDash skill sends its canonical skill slug (e.g. farmdash-signal-architect) on every FarmDash API request so anonymous Scout usage can be attributed to the skill that drove it. Optional and analytics-only: absence never blocks a request, and malformed values are ignored. This is a skill identity, never a wallet address, API key, or user ID.

Response

Stored snapshots with explicit scoring provenance

protocolIdstring

Present only for a specific protocol query; sanitized identifier

countinteger required
daysinteger required
score_semanticsstring required

Changes

No recorded changes to this operation across all 1 revision of this API.