Memulakan

API Finexly menyediakan kadar pertukaran masa nyata dan sejarah untuk lebih 170 mata wang. Memulakan adalah mudah:

  1. Daftar untuk akaun percuma
  2. Dapatkan kunci akses API anda dari papan pemuka
  3. Buat permintaan API pertama anda

URL Asas

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

Pengesahan

Semua permintaan API memerlukan pengesahan melalui token Bearer. Sertakan kunci API anda dalam header Authorization:

Pengepala Kebenaran (Diperlukan)

Authorization: Bearer YOUR_API_KEY

Pengehadan Kadar: Semak pengepala respons untuk penggunaan semasa anda: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Titik Akhir API

GET /v1/currencies

Dapatkan senarai semua kod mata wang yang disokong.

Parameter

Nama Jenis Diperlukan Penerangan

Contoh

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

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

Dapatkan kadar pertukaran untuk pasangan mata wang tertentu.

Parameter

Nama Jenis Diperlukan Penerangan
from string Ya Kod mata wang asas (huruf besar)
to string Ya Kod mata wang sebut harga (huruf besar)

Contoh

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

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

Dapatkan kadar pertukaran untuk berbilang pasangan mata wang dalam satu permintaan.

Parameter

Nama Jenis Diperlukan Penerangan
q string Ya Pasangan dipisahkan koma dalam format BASE_QUOTE

Contoh

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

Tukar jumlah tertentu dari satu mata wang ke mata wang lain.

Parameter

Nama Jenis Diperlukan Penerangan
from string Ya Kod mata wang sumber (huruf besar)
to string Ya Kod mata wang sasaran (huruf besar)
amount number Ya Jumlah untuk ditukar

Contoh

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
}

Contoh Kod

# Get single rate
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=USD&to=EUR"

# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP,BTC_USD"

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

Kod Ralat

Kod Jenis Penerangan
400 BAD_REQUEST Parameter permintaan tidak sah atau medan wajib tiada.
401 UNAUTHORIZED Token API tiada atau tidak sah.
403 FORBIDDEN Akses dinafikan. Akaun anda mungkin tidak aktif.
413 PAYLOAD_TOO_LARGE Saiz permintaan melebihi saiz maksimum yang dibenarkan.
429 RATE_LIMIT_EXCEEDED Anda telah melebihi had kadar anda. Semak pengepala X-RateLimit.
500 INTERNAL_ERROR Ralat pelayan dalaman berlaku. Sila cuba lagi.