> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversione valutaria

> L'endpoint `convert` consente una conversione valutaria precisa trasformando importi specifici tra valute utilizzando tassi di cambio in tempo reale, ideale per calcoli finanziari e l'elaborazione dei pagamenti.

## Per iniziare

### URL di base

```
https://exchange-rates.cleariflow.com/v1/convert
```

### Endpoint di validazione

L'endpoint `convert` richiede la tua chiave API, una valuta di base e un parametro target per eseguire conversioni valutarie.

```
https://exchange-rates.cleariflow.com/v1/convert
? api_key = YOUR_UNIQUE_API_KEY
& base = EUR
& target = USD
```

Questa richiesta riuscita converte 1 EUR in USD utilizzando il tasso di cambio più aggiornato:

<ResponseExample>
  ```json theme={"system"}
  {
      "base": "EUR",
      "target": "USD",
      "base_amount": 1,
      "converted_amount": 1.160968,
      "exchange_rate": 1.160968,
      "last_updated": 1755806612
  }
  ```
</ResponseExample>

### Parametri della richiesta

<ParamField query="api_key" type="String" required>
  La tua chiave API univoca. Nota che ogni utente ha chiavi API univoche *per ciascuna delle
  API Cleariflow*, quindi la chiave dell'API tassi di cambio non funzionerà per l'API di
  geolocalizzazione IP, ad esempio.
</ParamField>

<ParamField query="base" type="String" required>
  La valuta di base usata per ottenere l'ultimo/i tasso/i di cambio. Usa lo standard valutario ISO 4217 (es. USD per dollari statunitensi), come tutti i parametri valuta in questa API.
</ParamField>

<ParamField query="target" type="String" required>
  La valuta o le valute di destinazione per ottenere il tasso di cambio rispetto alla valuta di base. Come i parametri base, qualsiasi valuta passata qui segue lo standard ISO 4217. Nota che, a differenza degli altri endpoint, `convert` accetta solo una valuta di destinazione alla volta.
</ParamField>

<ParamField query="date" type="String">
  La data storica da cui desideri ottenere i tassi, nel formato YYYY-MM-DD. Se lasci vuoto, verranno usati gli ultimi tassi disponibili.
</ParamField>

<ParamField query="base_amount" type="Float">
  L'importo della valuta di base che desideri convertire nella valuta di destinazione.
</ParamField>

### Parametri della risposta

La risposta API viene restituita in un [formato JSON](https://www.json.org/json-en.html) universale e leggero.

<ResponseField name="base" type="String">
  La valuta di base usata per ottenere i tassi di cambio.
</ResponseField>

<ResponseField name="target" type="String">
  La valuta di destinazione in cui è stato convertito base\_amount.
</ResponseField>

<ResponseField name="date" type="String">
  La data da cui sono stati estratti i tassi, secondo la richiesta riuscita.
</ResponseField>

<ResponseField name="base_amount" type="Float">
  L'importo della valuta di base dalla richiesta.
</ResponseField>

<ResponseField name="converted_amount" type="Float">
  L'importo della valuta di destinazione in cui base\_amount è stato convertito.
</ResponseField>

<ResponseField name="exchange_rate" type="Float">
  Il tasso di cambio usato per convertire base\_amount dalla valuta di base alla valuta di destinazione.
</ResponseField>