Kom i gang

Finexly API gir sanntids- og historiske valutakurser for 170+ valutaer. Det er enkelt å komme i gang:

  1. Registrer deg for en gratis konto
  2. Hent API-tilgangsnøkkelen fra dashbordet
  3. 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

GET /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"
]
GET /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
}
GET /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
    }
}
GET /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
Oppsettveiledning og planlegge tillatelser →

Tutorials & Guides

Learn how to integrate Finexly with your favorite programming languages and frameworks.