Paid (x402 or MPP)

Full score-history record of one coin (paid, $0.05, x402 or MPP; included with the Premium agent key; sold only beyond the free slice)

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. Flow: POST {"coin": "BTC"} without payment returns 402 with the challenge headers when the record is sellable; pay exactly 50000 units (USDC on Base through x402, or USDC.e on Tempo through MPP) and retry the same request with the payment header; the response is 200 with the full record and a receipt header. When the coin's record has nothing beyond the free slice the request is refused with 400 (reason nothing_beyond_free_slice) before any payment, and the free slice at GET /api/history/{symbol} is the whole record. Premium subscribers send their agent key as Authorization: Bearer tvr_k_... instead of a payment. A lost response is re-delivered on the same proof for 24 hours without a second charge. MCP tool: get_historical_scores with scope "full".

post/premium/score-history

Request

  • Base URL: https://truevaluerankings.com
  • URL: https://truevaluerankings.com/premium/score-history
  • Auth: one of:
    • none
    • HTTP bearer

Headers

PAYMENT-SIGNATUREstring

Base64-encoded x402 PaymentPayload (version 2) signed for the requirements in the PAYMENT-REQUIRED header. Omit it to receive the challenge.

Authorizationstring

MPP credential: "Payment <base64url credential>" built from the WWW-Authenticate challenge after paying 50000 units of USDC.e on Tempo (push mode: the payer broadcasts the transfer). Send either this or PAYMENT-SIGNATURE, not both.

Request body

coinstring required

Ticker or name of a covered coin

Response

Paid and delivered (or included with the agent key). The full record: every dated score state with the TVR Score, method version, source label, public reason where recorded, and record hash.

successboolean
productstring
symbolstring
periodobject
coverageobject
method_versionsobject[]
hash_formatstring
paymentobject
legalobject

Example response

{
  "product": "score_history_full"
}

Changes

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