True Value Rankings

Free. Returns the TVR Score, rank, valuation category, TVR Estimated Value, fair value gap, and all 8 metric scores for a cryptocurrency. Accepts a ticker (BTC) or a name (Bitcoin). TVR evaluates fundamental strength using Sound Value principles. Data from True Value Rankings (truevaluerankings.com). Rate limit: 100 requests per 15 minutes per IP.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin name"
    },
    "symbol": {
      "type": "string",
      "description": "Ticker"
    },
    "category": {
      "type": "string",
      "description": "TVR coin category"
    },
    "tvr_score": {
      "type": "number",
      "description": "TVR Score, 0 to 100"
    },
    "rank": {
      "type": "number",
      "description": "Rank among evaluated coins, 1 is best"
    },
    "rank_out_of": {
      "type": "number",
      "description": "Number of coins evaluated"
    },
    "valuation": {
      "type": "string",
      "description": "Undervalued, Fair Value or Overvalued"
    },
    "tvr_estimated_value": {
      "type": "string",
      "description": "TVR Estimated Value, formatted in USD"
    },
    "fair_value_gap": {
      "type": "string",
      "description": "Gap between TVR Estimated Value and market price, formatted as a percentage"
    },
    "metric_scores": {
      "description": "All 8 metric scores with their weights"
    },
    "strongest_metric": {},
    "weakest_metric": {},
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Returns TVR's fair value estimate (TVR Estimated Value) for a cryptocurrency, including the fair value gap and valuation category. The TVR Estimated Value compares fundamental quality to current market price. Accepts a ticker or a name. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin name"
    },
    "symbol": {
      "type": "string",
      "description": "Ticker"
    },
    "tvr_estimated_value": {
      "type": "string",
      "description": "TVR Estimated Value, formatted in USD"
    },
    "fair_value_gap": {
      "type": "string",
      "description": "Gap between TVR Estimated Value and market price, formatted as a percentage"
    },
    "valuation": {
      "type": "string",
      "description": "Undervalued, Fair Value or Overvalued"
    },
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Compares 2 to 5 cryptocurrencies on TVR Score, rank, valuation, TVR Estimated Value, fair value gap, and all 8 metric scores side by side. Identifies the largest scoring difference. Accepts tickers or names. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "coins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 5,
      "description": "Array of 2-5 cryptocurrency tickers or names to compare (e.g., [\"BTC\", \"Ethereum\", \"SOL\"])"
    }
  },
  "required": [
    "coins"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "comparison": {
      "description": "Per-coin scores, ranks and valuations"
    },
    "coins_compared": {
      "type": "number"
    },
    "total_coins_evaluated": {
      "type": "number"
    },
    "key_difference": {
      "description": "The largest gap between the compared coins"
    },
    "metric_comparison": {
      "description": "Metric-by-metric table"
    },
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Returns the top N cryptocurrencies by a chosen ranking method: tvr_score (fundamental strength), most_undervalued (largest positive fair value gap), or most_overvalued (largest negative fair value gap). Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 5,
      "description": "Number of coins to return (default 5)"
    },
    "rank_by": {
      "type": "string",
      "enum": [
        "tvr_score",
        "most_undervalued",
        "most_overvalued"
      ],
      "default": "tvr_score",
      "description": "Ranking method: tvr_score, most_undervalued, or most_overvalued"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "rank_by": {
      "type": "string",
      "description": "The ranking basis used"
    },
    "rank_by_description": {
      "type": "string"
    },
    "rankings": {
      "type": "array",
      "description": "Ordered list of coins"
    },
    "total_coins_evaluated": {
      "type": "number"
    },
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Explains how True Value Rankings scores cryptocurrencies: the 8 metrics, their current default weights, the 4 built-in weight presets, and the general scoring approach. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "methodology": {
      "description": "The 8 metrics, their default weights and how the TVR Score is built"
    },
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Lists all cryptocurrencies currently evaluated by True Value Rankings with their symbol, name, and category. New coins are added regularly. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "coins": {
      "type": "array",
      "description": "Covered coins with ticker and name"
    },
    "total": {
      "type": "number"
    },
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Returns the complete fundamental analysis for a cryptocurrency: all 8 metric scores with weights, the scoring factors that shaped them, the valuation note, and ranking context. Accepts a ticker or a name. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Cryptocurrency ticker or name (e.g., BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin name"
    },
    "symbol": {
      "type": "string",
      "description": "Ticker"
    },
    "category": {
      "type": "string",
      "description": "TVR coin category"
    },
    "tvr_score": {
      "type": "number",
      "description": "TVR Score, 0 to 100"
    },
    "rank": {
      "type": "number",
      "description": "Rank among evaluated coins, 1 is best"
    },
    "rank_out_of": {
      "type": "number",
      "description": "Number of coins evaluated"
    },
    "valuation": {
      "type": "string",
      "description": "Undervalued, Fair Value or Overvalued"
    },
    "tvr_estimated_value": {
      "type": "string",
      "description": "TVR Estimated Value, formatted in USD"
    },
    "fair_value_gap": {
      "type": "string",
      "description": "Gap between TVR Estimated Value and market price, formatted as a percentage"
    },
    "metric_scores": {},
    "scoring_factors": {
      "description": "The reasoning behind each metric score"
    },
    "scoring_methodology_note": {
      "type": "string"
    },
    "valuation_note": {
      "type": "string"
    },
    "ranking_context": {},
    "context": {
      "description": "Standing context about TVR and how to read its outputs"
    },
    "summary": {
      "type": "string",
      "description": "Plain-language summary of the answer"
    },
    "data_sources": {
      "description": "Where the numbers come from"
    },
    "attribution": {
      "type": "string",
      "description": "Required attribution text"
    },
    "disclaimer": {
      "type": "string",
      "description": "Model-derived assessment, not investment advice"
    },
    "learn_more": {
      "description": "Links for more detail"
    },
    "error": {
      "description": "false on a normal answer, or an error message"
    },
    "status": {
      "type": "string",
      "description": "Present when the request could not be answered as asked, for example not_available"
    },
    "requested": {
      "type": "string",
      "description": "What was asked for, when it could not be resolved"
    }
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid. Reranks every coin TVR covers with your own weights for the 8 fundamental metrics, applying TVR's non-public score transformation. Returns rank, TVR Score, valuation category, fair value gap and TVR Estimated Value per coin. $0.05 per call, paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo), or included with a Premium agent key (HTTP header Authorization: Bearer tvr_k_... on this connection); an unpaid call returns the offer (isError with the x402 PaymentRequired in structuredContent) and charges nothing. Invalid input is refused before any payment. Free alternative: get_top_ranked and the four presets. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "weights": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "maxItems": 8
        },
        {
          "type": "object",
          "additionalProperties": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          }
        }
      ],
      "description": "Up to 8 weights (0-100) in this order: economic_model, network_security, adoption, privacy, longevity, liquidity, legal_clarity, technical_dev, or an object keyed by those names. Missing entries take TVR defaults."
    },
    "coins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 50,
      "description": "Optional tickers or names (1-50). Omit for all covered coins."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "product": {
      "type": "string"
    },
    "rankings": {
      "type": "array",
      "description": "Ranked coins under the requested weights"
    },
    "weights_used": {},
    "defaults_applied_for": {},
    "count": {
      "type": "number"
    },
    "payment": {},
    "redelivery": {},
    "legal": {},
    "error": {},
    "status": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "how_to_pay": {},
    "context": {},
    "disclaimer": {},
    "learn_more": {}
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Paid. Fundamentals profile of a portfolio: allocation-weighted scores for the 8 metrics, each holding's TVR Score and valuation category, and the portfolio TVR Score from TVR's scoring engine (scores only, no prices). $0.08 per call, paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo), or included with a Premium agent key (HTTP header Authorization: Bearer tvr_k_... on this connection); an unpaid call returns the offer (isError with the x402 PaymentRequired in structuredContent) and charges nothing. Invalid input is refused before any payment. Free alternative: compare_coins. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "portfolio": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "coin": {
            "type": "string",
            "description": "Ticker or name of a coin covered by TVR"
          },
          "allocation": {
            "type": "number",
            "description": "Allocation above 0 (percent or any weight; normalised to 100%)"
          }
        },
        "required": [
          "coin",
          "allocation"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 50,
      "description": "The holdings to analyse"
    }
  },
  "required": [
    "portfolio"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "product": {
      "type": "string"
    },
    "holdings": {
      "type": "array"
    },
    "portfolio_tvr_score": {
      "type": "number"
    },
    "blended_metrics": {},
    "profile": {},
    "weights_used": {
      "type": "string"
    },
    "payment": {},
    "redelivery": {},
    "legal": {},
    "access": {},
    "error": {},
    "status": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "how_to_pay": {},
    "context": {},
    "disclaimer": {},
    "learn_more": {}
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free slice, paid full record. Score history of one coin: every recorded change to its 8 metric scores as a dated record with the TVR Score, the method version, a source label (baseline for the opening record, auto_captured for rows written from the change itself), the public reason where recorded and a SHA-256 hash per record; forward-only from the day the record began. Without scope (or scope "free"): the last 90 days or the last 3 records, free, no payment, no key. scope "full": the whole record, included with a Premium agent key (Authorization: Bearer on this connection), or $0.05 per pull paid in-band with x402 (USDC on Base) or MPP (USDC.e on Tempo) once the record extends beyond the free slice; until then the free record is returned and nothing is charged. Data from True Value Rankings (truevaluerankings.com).

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Ticker or name of a coin covered by TVR (BTC, Bitcoin, ETH, LTC, XMR, SOL, ADA, AVAX, DOT, POL, LINK)"
    },
    "scope": {
      "type": "string",
      "enum": [
        "free",
        "full"
      ],
      "description": "free (default): the last 90 days or the last 3 records, no payment. full: the whole record; included with a Premium agent key, or paid per pull once the record extends beyond the free slice."
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "product": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "scope": {
      "type": "string"
    },
    "period": {},
    "coverage": {},
    "method_versions": {},
    "records": {
      "type": "array",
      "description": "Dated score states, newest first: as_of, revision, source, scores, tvr_score, method_version, changed_metrics, reason_public, published_at, record_hash"
    },
    "full_record": {},
    "hash_format": {
      "type": "string"
    },
    "hash_note": {
      "type": "string"
    },
    "payment": {},
    "redelivery": {},
    "legal": {},
    "access": {},
    "note": {},
    "error": {},
    "status": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "how_to_pay": {},
    "context": {},
    "disclaimer": {},
    "learn_more": {}
  },
  "additionalProperties": true,
  "$schema": "http://json-schema.org/draft-07/schema#"
}