---
title: "Score history of one coin (free slice; scope=full with a Premium agent key)"
method: GET
path: "/api/history/{symbol}"
tags: ["Free"]
---

# Score history of one coin (free slice; scope=full with a Premium agent key)

`GET /api/history/{symbol}`

## Request

- Base URL: `https://truevaluerankings.com`
- URL: `https://truevaluerankings.com/api/history/{symbol}`
- Auth: one of:
  - none
  - HTTP bearer

Score history: every recorded change to a coin's eight metric scores as a dated record with the TVR Score, the scoring method version, a source label (baseline for the opening record, auto_captured for rows written from the change itself), the public reason where one was recorded, and a SHA-256 hash of the record. Forward-only from the day the record began; nothing is reconstructed and no reason is invented. Free slice (the last 90 days or the last 3 records, whichever is longer) at GET https://truevaluerankings.com/api/history/{symbol} and in the MCP tool get_historical_scores. The full record is included with the Premium agent key (scope "full") and is sold per pull ($0.05, x402 or MPP, POST https://truevaluerankings.com/premium/score-history) only once a coin's record extends beyond the free slice; until then the request is refused before any payment and the free slice is the whole record. The response states its own coverage (first and last dates, records in the full record, gaps).

## Path parameters

- `symbol` string, required

## Query parameters

- `scope` 'free' | 'full'

## Response `200`

The free slice, or the full record for an entitled caller.

## Other responses

- `400`: Problem details (RFC 7807) with success false and error.
- `401`: scope=full with an unknown or revoked key.
- `403`: scope=full without entitlement; the free slice needs no key.
- `404`: Coin not covered; the body lists the covered coins.
- `429`: Rate limit or key allowance.

---

[API](https://skmtc.dev/truevaluerankings/apis/true-value-rankings-api.md) · [All operations](https://skmtc.dev/truevaluerankings/apis/true-value-rankings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/truevaluerankings/apis/true-value-rankings-api/revisions/c2cb1728b93c?raw)