Kom i gang
Finexly API gir sanntids- og historiske valutakurser for 170+ valutaer. Det er enkelt å komme i gang:
- Registrer deg for en gratis konto
- Hent API-tilgangsnøkkelen fra dashbordet
- Utfør din første API-forespørsel
Grunnleggende URL
https://api.finexly.com/v1/
Autentisering
Alle API-forespørsler krever autentisering via Bearer-token. Inkluder API-nøkkelen din i Authorization-headeren:
Alternativ 1: Autorisasjonsoverskrift (Anbefalt)
Autorisasjonsoverskrift (Påkrevd)
Authorization: Bearer YOUR_API_KEY
Alternativ 2: Forespørselsparameter
Send API-nøkkelen din som en spørringsparameter:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Sikkerhetsmerknad: API-nøkler i URL-er kan bli logget i servertilgangslogger og kan lekke via HTTP Referrer-headere. For produksjonsbruk anbefaler vi å bruke Authorization-header-metoden. Forespørselsparameteren er gitt som en bekvemmelighet for rask testing og enkle integrasjoner.
Begrensning av hastighet: Sjekk responsoverskriftene for din nåværende bruk:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API-endepunkter
/v1/currencies
Hent en liste over alle støttede valutakoder.
Parametere
| Navn | Type | Påkrevd | Beskrivelse |
|---|
Eksempel
GET https://api.finexly.com/v1/currencies
// Respons
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Hent valutakursen for et spesifikt valutapar.
Parametere
| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| from | string | Ja | Basisvalutakode (store bokstaver) |
| to | string | Ja | Kursvalutakode (store bokstaver) |
Eksempel
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Respons
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Hent valutakurser for flere valutapar i én enkelt forespørsel.
Parametere
| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| q | string | Ja | Kommaseparerte par i BASIS_KURS format |
Eksempel
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Respons
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Konverter et spesifikt beløp fra én valuta til en annen.
Parametere
| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| from | string | Ja | Kildevalutakode (store bokstaver) |
| to | string | Ja | Målvalutakode (store bokstaver) |
| amount | number | Ja | Beløp som skal konverteres |
Eksempel
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Respons
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Kodeeksempler
# 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")
Feilkoder
| Kode | Type | Beskrivelse |
|---|---|---|
| 400 | BAD_REQUEST | Ugyldige forespørselsparametere eller manglende obligatoriske felt. |
| 401 | UNAUTHORIZED | API-token mangler eller er ugyldig. |
| 403 | FORBIDDEN | Tilgang nektet. Kontoen din kan være inaktiv. |
| 413 | PAYLOAD_TOO_LARGE | Forespørselsstørrelsen overskrider maksimal tillatt størrelse. |
| 429 | RATE_LIMIT_EXCEEDED | Du har overskredet hastighetsgrensen din. Sjekk X-RateLimit-hodene. |
| 500 | INTERNAL_ERROR | Det oppstod en intern serverfeil. Vennligst prøv igjen. |
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.