Komma igång

Finexly API tillhandahåller realtids- och historiska växelkurser för 170+ valutor. Att komma igång är enkelt:

  1. Registrera dig för ett gratis konto
  2. Hämta din API-åtkomstnyckel från instrumentpanelen
  3. Gör din första API-förfrågan

Bas-URL

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

Autentisering

Alla API-förfrågningar kräver autentisering via Bearer-token. Inkludera din API-nyckel i Authorization-headern:

Alternativ 1: Auktoriseringshuvud (Rekommenderas)

Auktoriseringshuvud (Obligatoriskt)

Authorization: Bearer YOUR_API_KEY

Alternativ 2: Frågeparameter

Skicka din API-nyckel som en frågeparameter:

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

⚠ Säkerhetsnotering: API-nycklar i URL:er kan loggas i serverns åtkomstloggar och kan läcka via HTTP Referrer-headers. För produktionsanvändning rekommenderar vi metoden med Authorization-header. Frågeparametern tillhandahålls som en bekvämlighet för snabb testning och enkla integrationer.

Begränsning av hastighet: Kontrollera svarshuvuden för din nuvarande användning: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-slutpunkter

GET /v1/currencies

Hämta en lista över alla valutakoder som stöds.

Parametrar

Namn Typ Obligatorisk Beskrivning

Exempel

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

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

Hämta växelkursen för ett specifikt valutapar.

Parametrar

Namn Typ Obligatorisk Beskrivning
from string Ja Basvalutakod (versaler)
to string Ja Kursvalutakod (versaler)

Exempel

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

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

Hämta växelkurser för flera valutapar i en enda förfrågan.

Parametrar

Namn Typ Obligatorisk Beskrivning
q string Ja Kommaseparerade par i formatet BAS_KURS

Exempel

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

Konvertera ett specifikt belopp från en valuta till en annan.

Parametrar

Namn Typ Obligatorisk Beskrivning
from string Ja Källvalutakod (versaler)
to string Ja Målvalutakod (versaler)
amount number Ja Belopp att konvertera

Exempel

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
}

Kodexempel

# 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")

Felkoder

Kod Typ Beskrivning
400 BAD_REQUEST Ogiltiga förfrågningsparametrar eller saknade obligatoriska fält.
401 UNAUTHORIZED API-token saknas eller är ogiltig.
403 FORBIDDEN Åtkomst nekad. Ditt konto kan vara inaktivt.
413 PAYLOAD_TOO_LARGE Förfrågans storlek överskrider maximal tillåten storlek.
429 RATE_LIMIT_EXCEEDED Du har överskridit din hastighetsgräns. Kontrollera X-RateLimit-headers.
500 INTERNAL_ERROR Ett internt serverfel inträffade. Försök igen.

AI-anslutningar (MCP)

Finexly talar Model Context Protocol, så en AI-assistent kan läsa kurser direkt istället för att få dem överlämnade. Detta är en separat kanal från REST API:et nedan: den autentiserar med OAuth istället för en API-nyckel, och den är skrivskyddad.

Server-URL

https://mcp.finexly.com

Verktyg den exponerar

Namn Beskrivning
get_exchange_rate Den aktuella växelkursen mellan två valutor.
convert_amount Konvertera ett belopp, korsräknat genom den amerikanska dollarn där det behövs.
list_currencies Varje valuta vi täcker.
get_historical_rates Dagliga kurser över en period, för par som samlats in direkt.

Auktorisering

Anslutningen kör en OAuth 2.1 auktoriseringskodflöde med PKCE. Upptäckten finns på följande URL:er; den enda omfattningen är fx:read, och det finns ingen omfattning som ger kontotillgång.

  • https://finexly.com/.well-known/oauth-authorization-server
  • https://finexly.com/oauth/authorize
  • https://finexly.com/oauth/token
  • https://finexly.com/oauth/jwks
Installationsguide och planera tillstånd →

Tutorials & Guides

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