Rankings

Ranking de retenção de valor

Os anos-modelo que mais e menos retêm valor, por tipo de veículo e idade (1 a 10 anos), na referência mais recente.

  • Retenção = preço FIPE atual ÷ primeiro preço que a FIPE publicou para aquele ano-modelo da versão (não é o preço de tabela do 0 km). Em reais nominais: acima de 1 significa que o preço FIPE subiu desde a primeira publicação (comum em carros de 5+ anos, efeito da inflação e da alta de usados de 2021-2022).
  • Idade = ano civil da referência atual − ano civil da primeira publicação (granularidade de ano civil, não de meses): em out/2026, idade 1 = primeiro preço publicado em 2025.
  • Entram só anos-modelo com preço na referência mais recente (o mv_best_retention mantém também versões que a FIPE parou de publicar, avaliadas pelo último preço) e cuja primeira publicação ocorreu até o próprio ano-modelo: a FIPE às vezes inclui um ano-modelo anos depois (Corsa 2012 publicado pela primeira vez em 2023), e aí o "primeiro preço" já é de usado.
  • Cada versão aparece no máximo uma vez por lista (no ano-modelo mais extremo). A mediana do grupo (median_retention_pct) e variant_count usam todos os anos-modelo do grupo. 0 km não entra.
get/v1/rankings/retention

Request

  • Base URL: https://api.fipex.com.br
  • URL: https://api.fipex.com.br/v1/rankings/retention
  • Auth: none declared

Query parameters

vehicle_type'carro' | 'moto' | 'caminhao'

Restringe a um tipo (slug de /v1/vehicle-types).

ageinteger

Restringe a uma idade (anos).

limitinteger

Tamanho de cada lista (melhores e piores) por grupo.

Response

Grupos tipo × idade com melhores e piores.

Example response

{
  "data": {
    "ref_year": 2026,
    "ref_month": 10,
    "cohorts": [
      {
        "age_years": 3,
        "variant_count": 779,
        "median_retention_pct": 0.812,
        "best": [
          {
            "version": {
              "model_name": "SLS-63 AMG 6.2 8V Black Series Automático",
              "make_slug": "mercedes-benz-39",
              "model_slug": "sls-63-amg-6-2-8v-black-series-aut",
              "fuel_acronym": "g",
              "fuel_name": "Gasolina",
              "fipe_code": "021303-9",
              "vehicle_type": "carro",
              "brand_slug": "mercedes-benz",
              "brand_name": "Mercedes-Benz",
              "family_slug": "sls",
              "family_name": "SLS"
            },
            "year": {
              "value": "2020"
            },
            "first_price_cents": 1927100,
            "first_formatted_price": "R$ 19.271,00",
            "first_ref_year": 2023,
            "price_cents": 2332600,
            "formatted_price": "R$ 23.326,00",
            "retention_pct": 1.2104198
          }
        ],
        "worst": [
          {
            "version": {
              "model_name": "SLS-63 AMG 6.2 8V Black Series Automático",
              "make_slug": "mercedes-benz-39",
              "model_slug": "sls-63-amg-6-2-8v-black-series-aut",
              "fuel_acronym": "g",
              "fuel_name": "Gasolina",
              "fipe_code": "021303-9",
              "vehicle_type": "carro",
              "brand_slug": "mercedes-benz",
              "brand_name": "Mercedes-Benz",
              "family_slug": "sls",
              "family_name": "SLS"
            },
            "year": {
              "value": "2020"
            },
            "first_price_cents": 1927100,
            "first_formatted_price": "R$ 19.271,00",
            "first_ref_year": 2023,
            "price_cents": 2332600,
            "formatted_price": "R$ 23.326,00",
            "retention_pct": 1.2104198
          }
        ]
      }
    ]
  }
}

Changes

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