API Reference

Getting Started

Get your API key and make your first conversion in under a minute.

1. Create an account

Head to app.currency-core.com and sign up for free. No credit card required.

2. Create an API key

Once logged in, create an organization and generate an API key from the API Keys section. Your key will look like cc_live_xxxxxxxxxxxxxxxx.

Keep your key secret. It carries bearer-token authentication — treat it like a password.

3. Make your first request

curl "https://api.currency-core.com/v1/convert?from=USD&to=EUR&amount=100" \
  -H "Authorization: Bearer cc_live_your_key"

const res = await fetch(
  "https://api.currency-core.com/v1/convert?from=USD&to=EUR&amount=100",
  { headers: { Authorization: "Bearer cc_live_your_key" } },
);
const data = await res.json();
console.log(data.results[0].result);

import requests

res = requests.get(
    "https://api.currency-core.com/v1/convert",
    params={"from": "USD", "to": "EUR", "amount": 100},
    headers={"Authorization": "Bearer cc_live_your_key"},
)
print(res.json()["results"][0]["result"])

req, _ := http.NewRequest("GET",
	"https://api.currency-core.com/v1/convert?from=USD&to=EUR&amount=100", nil)
req.Header.Set("Authorization", "Bearer cc_live_your_key")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.currency-core.com/v1/convert?from=USD&to=EUR&amount=100"))
    .header("Authorization", "Bearer cc_live_your_key")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

<?php
$ch = curl_init("https://api.currency-core.com/v1/convert?from=USD&to=EUR&amount=100");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer cc_live_your_key"]);
echo curl_exec($ch);
curl_close($ch);

Response:

{
  "from": "USD",
  "to": "EUR",
  "amount": 100,
  "result": 92.14,
  "rate": 0.9214,
  "date": "2024-11-01",
  "ppp": { "applied": false }
}

4. Explore the API

Endpoint	Description
`GET /v1/convert`	Convert between any two currencies
`GET /v1/rates`	Fetch the full rates snapshot for a date
`GET /v1/ppp`	Look up the PPP factor for a country/year
`GET /v1/countries`	Reference list of supported country codes

Base URL & versioning

All endpoints live under a version prefix:

https://api.currency-core.com/v1

The version is pinned in the path, so a future /v2 can introduce breaking changes while /v1 keeps serving your existing integration unchanged. We’ll announce any new version well ahead of time — you upgrade on your own schedule.

Continue to Authentication to learn about key management and rate limits.