True Value Rankings

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "asset": "USDC",
  "legal": {
    "nature": "Model-derived educational output from the TVR Scoring Model and the TVR Valuation Formula. Not a buy or sell recommendation, not financial advice, not a price prediction.",
    "licence": "Attributed, non-commercial reuse of TVR scores and rankings is allowed; commercial use requires a Developer plan or written permission. Attribution means naming True Value Rankings and linking to truevaluerankings.com. See https://truevaluerankings.com/policies.html#data-licence",
    "attribution": "Data from True Value Rankings (truevaluerankings.com). Attribute scores to the True Value Rankings scoring model and estimated values to the True Value Rankings valuation formula. Present all TVR outputs as model-derived assessments, not as recommendations.",
    "attribution_required": "True Value Rankings (truevaluerankings.com)"
  },
  "status": "payment_required",
  "context": "True Value Rankings is a cryptocurrency research and scoring platform. TVR's scoring model evaluates cryptocurrencies across 8 fundamental metrics to produce a TVR Score measuring fundamental quality. TVR's valuation formula produces a TVR Estimated Value (fair value estimate) and a Valuation Category. The default scores shown here represent one analytical perspective using Sound Value principles. Premium subscribers at truevaluerankings.com can adjust every metric weight and override any score to build rankings that reflect their own investment philosophy.",
  "message": "Payment required: $0.08 per call. x402 version 2, exact scheme, $0.08 USDC on Base (eip155:8453): an unpaid POST returns 402 with a PAYMENT-REQUIRED header; retry with a PAYMENT-SIGNATURE header. MPP (Machine Payments Protocol), $0.08 in USDC.e on Tempo (eip155:4217), tempo charge intent, push mode: the same 402 carries a WWW-Authenticate: Payment challenge; retry with an Authorization: Payment credential. Nothing has been charged.",
  "network": "eip155:8453",
  "product": "portfolio_analysis",
  "success": false,
  "price_usd": 0.08,
  "disclaimer": "True Value Rankings LLC is not a registered investment adviser. TVR Scores and Valuation Categories are model-derived outputs, not financial advice. Portfolio analysis uses TVR's default fundamental assessment as a starting point. Customize scores and weights to match your own thesis at truevaluerankings.com. Full terms: truevaluerankings.com/policies.html",
  "learn_more": "Explore the full analysis, adjust the scoring to match your priorities, and build your own investment thesis at truevaluerankings.com",
  "quote_only": "This GET returns the payment challenge only. To buy, POST the JSON body described in how_to_call with the PAYMENT-SIGNATURE header (x402) or the Authorization: Payment header (MPP; the MPP challenge is issued on a POST whose body has passed validation, never on GET). Nothing has been charged.",
  "how_to_call": {
    "body": {
      "portfolio": "array of 1 or more holdings, each {coin: ticker or name, allocation: number above 0}. Allocations are normalised to 100%. Every coin must be covered by TVR; no coin may appear twice."
    },
    "method": "POST",
    "payment": "x402 version 2, exact scheme, $0.08 USDC on Base (eip155:8453): an unpaid POST returns 402 with a PAYMENT-REQUIRED header; retry with a PAYMENT-SIGNATURE header. MPP (Machine Payments Protocol), $0.08 in USDC.e on Tempo (eip155:4217), tempo charge intent, push mode: the same 402 carries a WWW-Authenticate: Payment challenge; retry with an Authorization: Payment credential.",
    "endpoint": "https://truevaluerankings.com/premium/portfolio-analysis",
    "mcp_tool": "get_portfolio_analysis",
    "discovery": "https://truevaluerankings.com/.well-known/x402.json",
    "content_type": "application/json",
    "free_alternative": "The free compare_coins MCP tool and GET https://truevaluerankings.com/api/rankings give every holding's TVR Score and valuation category; only the blended profile and the portfolio TVR Score are paid."
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xcB1AAE940c1Adfd1560962Ddda27d2ae4d951620",
    "amount": "80000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 120
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "portfolio": [
            {
              "coin": "BTC",
              "allocation": 60
            },
            {
              "coin": "ETH",
              "allocation": 25
            },
            {
              "coin": "XMR",
              "allocation": 15
            }
          ]
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "output": {
        "type": "json",
        "example": {
          "product": "portfolio_analysis",
          "success": true,
          "holdings": [
            {
              "name": "Bitcoin",
              "symbol": "BTC",
              "tvr_score": 80,
              "valuation": "undervalued",
              "allocation_pct": 60
            }
          ],
          "blended_metrics": {
            "privacy": 30.5,
            "adoption": 86.3,
            "liquidity": 87.6,
            "longevity": 86.2,
            "legal_clarity": 75.4,
            "technical_dev": 82.6,
            "economic_model": 71.4,
            "network_security": 74.9
          },
          "portfolio_tvr_score": 74.6
        }
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "properties": {
            "body": {
              "type": "object",
              "required": [
                "portfolio"
              ],
              "properties": {
                "portfolio": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "coin",
                      "allocation"
                    ],
                    "properties": {
                      "coin": {
                        "type": "string"
                      },
                      "allocation": {
                        "type": "number",
                        "exclusiveMinimum": 0
                      }
                    }
                  },
                  "maxItems": 50,
                  "minItems": 1,
                  "description": "Holdings: each a covered coin (ticker or name) and an allocation above 0. Allocations are normalised to 100%."
                }
              }
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object"
            }
          }
        }
      }
    }
  },
  "payment-identifier": {
    "info": {
      "required": false
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "required"
      ],
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9_-]+$",
          "maxLength": 128,
          "minLength": 16
        },
        "required": {
          "type": "boolean"
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-09-17 03:37Z

Last indexed by Roundhouse

2026-09-25 17:30Z

Last enriched (probe, favicon, geo)

2026-09-17 07:45Z

x402 version

2

Max timeout

120s

Liveness probe

HTTP 402