Paid (x402 or MPP)

Custom-weight rerank of every covered coin (paid, $0.05, x402 or MPP)

Custom-weight rerank of every cryptocurrency covered by True Value Rankings: the full TVR table recomputed with the caller's own weights for the 8 fundamental metrics, using TVR's non-public score transformation. $0.05 per call, paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo, tempo charge, push mode). Educational model output, not a recommendation. Flow: POST without payment returns 402 with the challenge headers; pay exactly 50000 units (USDC on Base through x402, EIP-3009 authorization signed for the payTo address, or USDC.e on Tempo through MPP, push mode) and retry the same request with the payment header; the response is 200 with the ranking and a receipt header. Invalid input is refused with 400 before any payment. A lost response is re-delivered on the same proof for 24 hours without a second charge; the same proof with different inputs is refused with 409. The live x402 offer, field for field, is at https://truevaluerankings.com/.well-known/x402.json. Free alternative: the four built-in presets through POST /api/calculate-batch. MCP tool: get_custom_ranking. A GET on this path returns the same x402 challenge (PAYMENT-REQUIRED header) as a quote, never a sale, and carries no MPP challenge; a POST with no body is answered the same way. Premium subscribers send their agent key as Authorization: Bearer tvr_k_... instead of a payment (one counted Premium operation; 200 directly, no 402).

post/premium/custom-ranking

Request

  • Base URL: https://truevaluerankings.com
  • URL: https://truevaluerankings.com/premium/custom-ranking
  • 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

coinsstring[]

Optional tickers or names (1-50). Omit for all covered coins.

Response

Paid and delivered. The ranking under the caller's weights, with the settlement receipt in PAYMENT-RESPONSE.

successboolean
productstring
countinteger
weights_usedobject

The 8 weights applied, keyed by metric name

weights_arraynumber[]
defaults_applied_forstring[]

Metric names whose weight was missing and took the TVR default

legalobject

Nature of the output, attribution requirement, licence

contextstring
disclaimerstring
attributionstring

Example response

{
  "success": true,
  "product": "custom_ranking"
}

Changes

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