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. |
AI-tilkoblinger (MCP)
Finexly bruker Model Context Protocol, slik at en AI-assistent kan lese valutakurser direkte i stedet for å få dem servert. Dette er en egen kanal fra REST API-en nedenfor: den autentiserer med OAuth i stedet for en API-nøkkel, og den er skrivebeskyttet.
Server-URL
https://mcp.finexly.com
Verktøy det eksponerer
| Navn | Beskrivelse |
|---|---|
| get_exchange_rate | Den nåværende kursen mellom to valutaer. |
| convert_amount | Konverter et beløp, kryssvurdert gjennom den amerikanske dollaren der det er nødvendig. |
| list_currencies | Hver valuta vi dekker. |
| get_historical_rates | Dagskurser over en periode, for par samlet direkte. |
Autorisasjon
Koblingen kjører en OAuth 2.1 autorisasjonskodeflyt med PKCE. Oppdagelse skjer på URL-ene nedenfor; den eneste omfanget er fx:read, og det finnes ingen omfang som gir kontoaksess.
- https://finexly.com/.well-known/oauth-authorization-server
- https://finexly.com/oauth/authorize
- https://finexly.com/oauth/token
- https://finexly.com/oauth/jwks
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.