# Qotien — Calculateur de plus-value immobilière (France)

> Qotien — Calculateur de plus-value immobilière (France) is a paid API for AI agents from app.qotien.fr, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Calculates French real estate capital gains tax (IR + prélèvements sociaux + surtaxe) including holding-period exemptions, renovation deductions, and LMNP 2025 reform adjustments

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/plus_value_immobiliere
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/qotien-calculateur-de-plus-value-immobili-re-france-08f4925d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o8TnLMWGjIsRGgMLL25o9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability qotien-calculateur-de-plus-value-immobili-re-france-08f4925d -d '<json body>'
```

Example prompt: I'm selling a French apartment I bought for €320,000 in 2010 (14 years ago) and selling for €520,000 today. I spent €40,000 on renovations and paid €8,000 in agency fees on the sale side. Can you calculate my total capital gains tax (IR, social levies, and any surcharge)?

## When to prefer this

Use this endpoint when you need a French-law-compliant capital gains tax calculation for real estate, especially when holding-period abatements, renovation forfaits, LMNP 2025 reform reintegration, or primary-residence exemptions are involved. Prefer this over generic tax calculators because it references Légifrance/BOFiP sources directly and handles all CGI art. 150 U to 150 VH rules including the progressive surcharge. Not appropriate for stock/securities capital gains or non-French jurisdictions.

## Known failure modes

- Missing required fields (prix_cession or prix_acquisition) returns ok:false with an error description
- Negative computed gain (sale at a loss) returns 0 tax — not an error but may be unexpected
- If annees_detention ≥ 30, result may simply be 0 (full social levy exemption)
- lmnp_reel=true without amortissements_deduits may yield an estimate rather than exact figure
- Confidence level may drop to 'estime' or 'partiel' for edge cases not fully covered by the barème

## How this service works

Simulateur IFI, PER, IR et retraite (32 régimes). Logiciel CGP : bilan patrimonial, déclaration 2042, LMNP. Chiffres sourcés Légifrance et BOFiP. 14 jours d'essai.

## Output

Returns a JSON object containing: a boolean `ok` status, the computed capital gain and total tax owed in EUR (IR at 19% + social levies at 17.2% + progressive surcharge if applicable), confidence level (typically 'fiable' for fiscal calculations), the CGI legal sources used, the fiscal year vintage of the tax scales applied, and a disclaimer that the result is informational and not personalised tax advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "travaux": {
   "type": "number",
   "minimum": 0,
   "description": "Travaux (€). Absent → forfait 15 % du prix d'acquisition si détention ≥ 5 ans."
  },
  "lmnp_reel": {
   "type": "boolean",
   "default": false,
   "description": "LMNP au réel : réintègre les amortissements déduits au prix d'acquisition majoré (réforme 2025)."
  },
  "prix_cession": {
   "type": "number",
   "minimum": 0,
   "description": "Prix de cession (€)."
  },
  "frais_cession": {
   "type": "number",
   "minimum": 0,
   "description": "Frais de cession — diagnostics, agence… (€)."
  },
  "annees_detention": {
   "type": "number",
   "minimum": 0,
   "description": "Durée de détention en années (abattements dès 6 ans ; exonération IR à 22 ans, PS à 30 ans)."
  },
  "prix_acquisition": {
   "type": "number",
   "minimum": 0,
   "description": "Prix d'acquisition du bien (€)."
  },
  "frais_acquisition": {
   "type": "number",
   "minimum": 0,
   "description": "Frais d'acquisition réels (€). Absent → forfait 7,5 % du prix d'acquisition."
  },
  "residence_principale": {
   "type": "boolean",
   "default": false,
   "description": "Si vrai : exonération totale (art. 150 U II 1° CGI)."
  },
  "amortissements_deduits": {
   "type": "number",
   "minimum": 0,
   "description": "Amortissements déduits à réintégrer si lmnp_reel (€)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "ok",
   "domaine",
   "capability",
   "result",
   "confiance",
   "sources",
   "millesime_fiscal"
  ],
  "properties": {
   "ok": {
    "type": "boolean",
    "description": "true = succès ; false = erreur (champ \"error\" présent à la place de result)."
   },
   "result": {
    "type": "object",
    "properties": {
     "unit": {
      "type": "string",
      "description": "Unité de value (EUR, PERCENT, RATE…)."
     },
     "label": {
      "type": "string",
      "description": "Libellé lisible du résultat."
     },
     "value": {
      "type": "number",
      "description": "Valeur principale (quand le résultat est scalaire)."
     },
     "confiance": {
      "enum": [
       "fiable",
       "estime",
       "partiel",
       "non_calculable",
       "sourcee",
       "variable"
      ],
      "type": "string",
      "description": "Confiance propre au résultat retraite (prime sur la confiance de capacité)."
     }
    },
    "description": "Résultat. Contient typiquement { value:number, unit:string, label:string } ; les outils retraite ajoutent confiance, fourchette, et le détail par régime."
   },
   "domaine": {
    "enum": [
     "fiscal",
     "retraite",
     "referentiel",
     "qotien"
    ],
    "type": "string",
    "description": "Domaine de la capacité."
   },
   "sources": {
    "type": "array",
    "items": {
     "type": "string"
    },
    "description": "Sources primaires/légales du calcul."
   },
   "confiance": {
    "enum": [
     "fiable",
     "estime",
     "partiel",
     "non_calculable",
     "sourcee",
     "variable"
    ],
    "type": "string",
    "description": "Niveau de confiance de CE résultat (fiscal = fiable ; retraite = variable)."
   },
   "capability": {
    "type": "string",
    "description": "Nom de la capacité appelée."
   },
   "referentiel": {
    "type": "string",
    "description": "Version du référentiel sourcé utilisé."
   },
   "annee_revenus": {
    "type": "number",
    "description": "Année des revenus concernés."
   },
   "avertissement": {
    "type": "string",
    "description": "Avertissement d'usage (résultat brut, pas un conseil personnalisé)."
   },
   "millesime_fiscal": {
    "type": "string",
    "description": "Millésime fiscal (année des barèmes appliqués)."
   }
  }
 },
 "example": {
  "ok": true,
  "result": {
   "unit": "EUR",
   "label": "Plus-value immobilière (IR + PS + surtaxe)",
   "value": 0
  },
  "do
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-calculateur-de-plus-value-immobili-re-france-08f4925d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.qotien.fr](https://www.zero.xyz/host/app.qotien.fr/llms.txt)