# Currency Converter — Zapi reference

> Convert monetary amounts between currencies using current exchange rates.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/currency-convert
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Currency Converter

**Category:** finance · **Slug:** `currency-convert`
**Detail page:** https://zpi.web.id/api/finance/currency-convert

Convert monetary amounts between currencies using current exchange rates.

**Tags:** utility, finance, currency

### Convert Currency

Convert an amount from one currency to another.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:currency-convert/convert`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `from` | string | query | no | Source currency (ISO 4217). Default USD |
| `to` | string | query | no | Target currency (ISO 4217). Default IDR |
| `amount` | number | query | no | Amount to convert. Default 1 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:currency-convert/convert?from=USD&to=IDR&amount=100" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:currency-convert/convert?from=USD&to=IDR&amount=100", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:currency-convert/convert?from=USD&to=IDR&amount=100",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "to": "IDR",
  "date": "2026-05-26",
  "from": "USD",
  "rate": 17834.8,
  "amount": 100,
  "result": 1783480
}
```

---


_Generated: 2026-08-02T14:26:05.541Z_