# Qotien — Surtaxe Plus-Value Immobilière

> Qotien — Surtaxe Plus-Value Immobilière is a paid API for AI agents from app.qotien.fr, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Calculates the French high-gain real estate capital gains surtax (surtaxe sur les plus-values immobilières) given a net taxable gain amount, sourced from CGI art. 1609 nonies G.

## Facts

- Endpoint: POST https://app.qotien.fr/api/fiscal/v1/calc/surtaxe_pv_immobiliere
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/qotien-surtaxe-plus-value-immobili-re-a6cb9aa8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hoBiDS7nQgnvpjVS4JDfn

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-surtaxe-plus-value-immobili-re-a6cb9aa8 -d '<json body>'
```

Example prompt: I just sold a French property and my net taxable capital gain is €320,000 — can you calculate the surtaxe sur les plus-values immobilières I'd owe on that?

## When to prefer this

Use this endpoint when you need a legally sourced, precise computation of the French high-gain real estate capital gains surtax (CGI art. 1609 nonies G) based on a single net taxable gain figure. Prefer it over generic tax calculators when accuracy traceable to Légifrance/BOFiP is required, or when building a broader CGP wealth advisory workflow that includes IFI, PER, or retirement simulations on the same platform.

## Known failure modes

- Negative or missing plus_value value — API returns ok:false with error field
- plus_value below the statutory threshold — returns value:0 EUR (not an error, valid zero result)
- Malformed request body — HTTP 400 or ok:false
- Referential data out of date with latest Légifrance update — confiance may downgrade

## 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 with 'ok' status, the surtax amount in EUR with a human-readable label, the fiscal year (millésime_fiscal), a confidence level ('fiable' for this fiscal endpoint), the legal sources used (e.g. CGI art. 1609 nonies G), and an advisory disclaimer that the result is not personalised tax advice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "plus_value": {
   "type": "number",
   "minimum": 0,
   "description": "Plus-value nette imposable (€)."
  }
 }
}
```

## 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": "Surtaxe sur les plus-values immobilières",
   "value": 0
  },
  "doma
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/qotien-surtaxe-plus-value-immobili-re-a6cb9aa8/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)