# Kurs Valuta (ECB) API

> Kurs Valuta (ECB) API on Apizie: 4 endpoints (Kurs Terbaru, Konversi, Riwayat Kurs, Daftar Mata Uang) returned as clean JSON through one API key. 4 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/finance:fx/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:fx`
- Category: Finance
- Status: live
- Source: https://ecb.europa.eu
- Page: https://zieapi.vercel.app/api/finance/fx
- OpenAPI: https://zieapi.vercel.app/api/finance/fx/openapi.json

Kurs referensi harian Bank Sentral Eropa (ECB) via Frankfurter: kurs terbaru, konversi, riwayat, dan daftar mata uang, termasuk Rupiah (IDR).

## Endpoints

### Kurs Terbaru
`GET https://zieapi.vercel.app/v1/finance:fx/latest`

| Parameter | Type | Required | Description |
|---|---|---|---|
| base | string | no | Mata uang dasar (ISO 4217) |
| symbols | string | no | Mata uang tujuan, pisahkan dengan koma |
| date | string | no | Tanggal kurs (YYYY-MM-DD), kosong = terbaru |

### Konversi
`GET https://zieapi.vercel.app/v1/finance:fx/convert`

| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | number | yes | Nominal |
| from | string | yes |  |
| to | string | yes |  |
| date | string | no | Tanggal kurs (YYYY-MM-DD) |

### Riwayat Kurs
`GET https://zieapi.vercel.app/v1/finance:fx/history`

| Parameter | Type | Required | Description |
|---|---|---|---|
| start | string | yes | Tanggal awal (YYYY-MM-DD) |
| end | string | no | Tanggal akhir (YYYY-MM-DD), kosong = hari ini |
| base | string | no |  |
| symbols | string | no | Mata uang tujuan, pisahkan dengan koma |

### Daftar Mata Uang
`GET https://zieapi.vercel.app/v1/finance:fx/currencies`

## Example
```
curl "https://zieapi.vercel.app/v1/finance:fx/latest" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Kurs Valuta (ECB) API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/finance:fx/latest with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Kurs Valuta (ECB) API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Kurs Valuta (ECB) API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:fx.

### What is the status of the Kurs Valuta (ECB) API?
Live: works with just an Apizie key