Kom godt i gang

Finexly API'en leverer realtids- og historiske valutakurser for 170+ valutaer. Det er nemt at komme i gang:

  1. Tilmeld dig en gratis konto
  2. Hent din API-adgangsnøgle fra instrumentbrættet
  3. Foretag din første API-anmodning

Basis-URL

https://api.finexly.com/v1/

Godkendelse

Alle API-anmodninger kræver autentificering via Bearer-token. Inkluder din API-nøgle i Authorization-headeren:

Mulighed 1: Autorisationshoved (Anbefalet)

Autorisationsheader (Påkrævet)

Authorization: Bearer YOUR_API_KEY

Mulighed 2: Forespørgselsparameter

Angiv din API-nøgle som en forespørgselsparameter:

GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY

⚠ Sikkerhedsnote: API-nøgler i URL'er kan blive logget i serveradgangslogfiler og kan lække via HTTP Referrer-headere. Til produktionsbrug anbefaler vi metoden med Authorization-header. Forespørgselsparameteren er tilgængelig som en bekvemmelighed for hurtig test og enkle integrationer.

Begrænsning af rater: Tjek svaroverskrifter for dit nuværende forbrug: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-endepunkter

GET /v1/currencies

Hent en liste over alle understøttede valutakoder.

Parametre

Navn Type Påkrævet Beskrivelse

Eksempel

GET https://api.finexly.com/v1/currencies

// Svar
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Hent valutakursen for et specifikt valutapar.

Parametre

Navn Type Påkrævet Beskrivelse
from string Ja Basisvalutakode (store bogstaver)
to string Ja Kursvalutakode (store bogstaver)

Eksempel

GET https://api.finexly.com/v1/rate?from=USD&to=EUR

// Svar
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Hent valutakurser for flere valutapar i en enkelt anmodning.

Parametre

Navn Type Påkrævet Beskrivelse
q string Ja Kommaseparerede par i BASIS_KURS format

Eksempel

GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP

// Svar
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Konverter et specifikt beløb fra én valuta til en anden.

Parametre

Navn Type Påkrævet Beskrivelse
from string Ja Kildevalutakode (store bogstaver)
to string Ja Målvalutakode (store bogstaver)
amount number Ja Beløb der skal konverteres

Eksempel

GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100

// Svar
{
    "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")

Fejlkoder

Kode Type Beskrivelse
400 BAD_REQUEST Ugyldige forespørgselsparametre eller manglende påkrævede felter.
401 UNAUTHORIZED API-token mangler eller er ugyldig.
403 FORBIDDEN Adgang nægtet. Din konto er muligvis inaktiv.
413 PAYLOAD_TOO_LARGE Forespørgslens størrelse overstiger maksimal tilladt størrelse.
429 RATE_LIMIT_EXCEEDED Du har overskredet din hastighedsgrænse. Tjek X-RateLimit headers.
500 INTERNAL_ERROR Der opstod en intern serverfejl. Prøv venligst igen.

AI-tilslutninger (MCP)

Finexly taler Model Context Protocol, så en AI-assistent kan læse kurser direkte i stedet for at få dem overleveret. Dette er en separat kanal fra REST API'en nedenfor: den autentificerer med OAuth i stedet for en API-nøgle, og den er skrivebeskyttet.

Server-URL

https://mcp.finexly.com

Værktøjer, det eksponerer

Navn Beskrivelse
get_exchange_rate Den nuværende kurs mellem to valutaer.
convert_amount Konverter et beløb, krydsvaluta gennem den amerikanske dollar hvor det er nødvendigt.
list_currencies Hver valuta vi dækker.
get_historical_rates Daglige kurser over en periode, for par indsamlet direkte.

Autorisation

Connectoren kører en OAuth 2.1 autorisationskodeflow med PKCE. Opdagelse findes på nedenstående URL'er; den eneste omfang er fx:read, og der er ikke noget omfang, der giver adgang til kontoen.

  • https://finexly.com/.well-known/oauth-authorization-server
  • https://finexly.com/oauth/authorize
  • https://finexly.com/oauth/token
  • https://finexly.com/oauth/jwks
Opsætningsguide og planlægning af tilladelser →

Tutorials & Guides

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