เริ่มต้นใช้งาน

API ของ Finexly ให้บริการอัตราแลกเปลี่ยนแบบเรียลไทม์และประวัติสำหรับสกุลเงินกว่า 170 สกุล การเริ่มต้นใช้งานเป็นเรื่องง่าย:

  1. สมัครบัญชีฟรี
  2. รับคีย์การเข้าถึง API ของคุณจากแดชบอร์ด
  3. ทำการร้องขอ API ครั้งแรกของคุณ

URL พื้นฐาน

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

การยืนยันตัวตน

การร้องขอ API ทั้งหมดต้องมีการยืนยันตัวตนผ่าน Bearer token รวมคีย์ API ของคุณในส่วนหัว Authorization:

ส่วนหัวการอนุญาต (จำเป็น)

Authorization: Bearer YOUR_API_KEY

การจำกัดอัตรา: ตรวจสอบส่วนหัวของการตอบสนองสำหรับการใช้งานปัจจุบันของคุณ: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

จุดเชื่อมต่อ API

GET /v1/currencies

รับรายการรหัสสกุลเงินทั้งหมดที่รองรับ

พารามิเตอร์

ชื่อ ประเภท จำเป็น คำอธิบาย

ตัวอย่าง

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

// การตอบกลับ
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

รับอัตราแลกเปลี่ยนสำหรับคู่สกุลเงินที่ระบุ

พารามิเตอร์

ชื่อ ประเภท จำเป็น คำอธิบาย
from string ใช่ รหัสสกุลเงินฐาน (ตัวพิมพ์ใหญ่)
to string ใช่ รหัสสกุลเงินอ้างอิง (ตัวพิมพ์ใหญ่)

ตัวอย่าง

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

// การตอบกลับ
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

รับอัตราแลกเปลี่ยนสำหรับคู่สกุลเงินหลายคู่ในคำขอเดียว

พารามิเตอร์

ชื่อ ประเภท จำเป็น คำอธิบาย
q string ใช่ คู่สกุลเงินคั่นด้วยเครื่องหมายจุลภาคในรูปแบบ BASE_QUOTE

ตัวอย่าง

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

// การตอบกลับ
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

แปลงจำนวนเงินที่ระบุจากสกุลเงินหนึ่งไปเป็นอีกสกุลเงินหนึ่ง

พารามิเตอร์

ชื่อ ประเภท จำเป็น คำอธิบาย
from string ใช่ รหัสสกุลเงินต้นทาง (ตัวพิมพ์ใหญ่)
to string ใช่ รหัสสกุลเงินปลายทาง (ตัวพิมพ์ใหญ่)
amount number ใช่ จำนวนเงินที่จะแปลง

ตัวอย่าง

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

// การตอบกลับ
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

ตัวอย่างโค้ด

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

รหัสข้อผิดพลาด

รหัส ประเภท คำอธิบาย
400 BAD_REQUEST พารามิเตอร์คำขอไม่ถูกต้องหรือขาดฟิลด์ที่จำเป็น
401 UNAUTHORIZED Token API หายไปหรือไม่ถูกต้อง
403 FORBIDDEN การเข้าถึงถูกปฏิเสธ บัญชีของคุณอาจไม่ได้ใช้งาน
413 PAYLOAD_TOO_LARGE ขนาดคำขอเกินขนาดสูงสุดที่อนุญาต
429 RATE_LIMIT_EXCEEDED คุณเกินขีดจำกัดอัตรา ตรวจสอบ headers X-RateLimit
500 INTERNAL_ERROR เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์ กรุณาลองอีกครั้ง