Paid (x402 or MPP)

Fundamentals profile of a portfolio (paid, $0.08, x402 or MPP)

Fundamentals profile of a cryptocurrency allocation from True Value Rankings: the allocation-weighted scores for the 8 fundamental metrics, each holding's TVR Score and valuation category, and the portfolio TVR Score computed by TVR's scoring engine (the same calculation as the site's what-if simulator). Scores only; no prices, market caps, gaps or estimated values. $0.08 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 80000 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 profile and a receipt header. Invalid input (unknown coin, duplicate coin, allocation not above 0, empty list) 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. Free alternative: the compare_coins MCP tool and GET /api/rankings for each holding. MCP tool: get_portfolio_analysis. 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/portfolio-analysis

Request

  • Base URL: https://truevaluerankings.com
  • URL: https://truevaluerankings.com/premium/portfolio-analysis
  • 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 80000 units of USDC.e on Tempo (push mode: the payer broadcasts the transfer). Send either this or PAYMENT-SIGNATURE, not both.

Request body

Response

Paid and delivered. The portfolio profile, with the settlement receipt in PAYMENT-RESPONSE (x402) or Payment-Receipt (MPP).

successboolean
productstring
holdings_countinteger
portfolio_tvr_scorenumber

TVR Score of the allocation-weighted metric profile under TVR default weights (same engine as the site's what-if simulator)

blended_metricsobject

Allocation-weighted score for each of the 8 metrics

profileobject

Strongest and weakest blended metric, valuation mix by allocation

weights_usedstring
paymentobject

Rail, network, asset, amount and transaction reference of this purchase

legalobject
contextstring
disclaimerstring

Example response

{
  "success": true,
  "product": "portfolio_analysis",
  "weights_used": "default"
}

Changes

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