Aloittaminen
Finexly API tarjoaa reaaliaikaiset ja historialliset valuuttakurssit yli 170 valuutalle. Aloittaminen on helppoa:
- Rekisteröidy ilmaiseksi tilille
- Hae API-käyttöavain hallintapaneelista
- Tee ensimmäinen API-pyyntösi
Perus-URL-osoite
https://api.finexly.com/v1/
Todennus
Kaikki API-pyynnöt vaativat todennuksen Bearer-tokenin avulla. Sisällytä API-avaimesi Authorization-otsikkoon:
Vaihtoehto 1: Autorisointipääte (Suositeltu)
Valtuutuksen otsake (Vaaditaan)
Authorization: Bearer YOUR_API_KEY
Vaihtoehto 2: Kyselyparametri
Anna API-avaimesi kyselyparametrina:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Turvallisuusmuistio: API-avaimet URL-osoitteissa voidaan kirjata palvelimen käyttölokitiedostoihin ja ne voivat vuotaa HTTP-lähettäjäotsikoiden kautta. Tuotantokäyttöön suosittelemme Authorization-otsikkomenetelmää. Kyselyparametri on tarjolla helppokäyttöisyyden vuoksi nopeaan testaukseen ja yksinkertaisiin integraatioihin.
Nopeusrajoitus: Tarkista vastausotsikoista nykyinen käyttötasosi.
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API-päätepisteet
/v1/currencies
Hae luettelo kaikista tuetuista valuuttakoodeista.
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|
Esimerkki
GET https://api.finexly.com/v1/currencies
// Vastaus
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Hae valuuttakurssi tietylle valuuttaparille.
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| from | string | Kyllä | Perusvaluuttakoodi (isot kirjaimet) |
| to | string | Kyllä | Noteerausvaluuttakoodi (isot kirjaimet) |
Esimerkki
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Vastaus
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Hae valuuttakurssit useille valuuttapareille yhdellä pyynnöllä.
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| q | string | Kyllä | Pilkulla erotetut parit muodossa PERUSTA_NOTEERAUS |
Esimerkki
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Vastaus
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Muunna tietty summa yhdestä valuutasta toiseen.
Parametrit
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| from | string | Kyllä | Lähdevaluuttakoodi (isot kirjaimet) |
| to | string | Kyllä | Kohdevaluuttakoodi (isot kirjaimet) |
| amount | number | Kyllä | Muunnettava summa |
Esimerkki
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Vastaus
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Koodiesimerkit
# Using Authorization header (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/rate?from=USD&to=EUR"
# Using query parameter
curl "https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY"
# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP"
# Convert amount
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100"
<?php
$apiKey = 'YOUR_API_KEY';
// Using cURL
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.finexly.com/v1/rate?from=USD&to=EUR',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo "USD/EUR Rate: " . $data['rate'];
const apiKey = 'YOUR_API_KEY';
// Get single rate
const response = await fetch('https://api.finexly.com/v1/rate?from=USD&to=EUR', {
headers: {
'Authorization': `Bearer ${apiKey}`
}
});
const data = await response.json();
console.log(`USD/EUR Rate: ${data.rate}`);
// Convert amount
const convertResponse = await fetch(
'https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100',
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const result = await convertResponse.json();
console.log(`100 USD = ${result.result} EUR`);
import requests
api_key = 'YOUR_API_KEY'
headers = {'Authorization': f'Bearer {api_key}'}
# Get single rate
response = requests.get(
'https://api.finexly.com/v1/rate',
params={'from': 'USD', 'to': 'EUR'},
headers=headers
)
data = response.json()
print(f"USD/EUR Rate: {data['rate']}")
# Convert amount
response = requests.get(
'https://api.finexly.com/v1/convert-amount',
params={'from': 'USD', 'to': 'EUR', 'amount': 100},
headers=headers
)
result = response.json()
print(f"100 USD = {result['result']} EUR")
Virhekoodit
| Koodi | Tyyppi | Kuvaus |
|---|---|---|
| 400 | BAD_REQUEST | Virheelliset pyyntöparametrit tai puuttuvat pakolliset kentät. |
| 401 | UNAUTHORIZED | API-token puuttuu tai on virheellinen. |
| 403 | FORBIDDEN | Pääsy estetty. Tilisi voi olla passiivinen. |
| 413 | PAYLOAD_TOO_LARGE | Pyynnön koko ylittää suurimman sallitun koon. |
| 429 | RATE_LIMIT_EXCEEDED | Olet ylittänyt nopeusrajasi. Tarkista X-RateLimit-otsikot. |
| 500 | INTERNAL_ERROR | Tapahtui sisäinen palvelinvirhe. Yritä uudelleen. |
Tutorials & Guides
Learn how to integrate Finexly with your favorite programming languages and frameworks.
JavaScript Integration Tutorial
Step-by-step guide to integrating Finexly API with JavaScript and Node.js.
Python Integration Tutorial
Complete guide to using Finexly API with Python and popular libraries.
Developer Guide
Comprehensive guide to free currency API features and best practices.
Historical Rates Guide
Learn how to retrieve and work with historical exchange rate data.