시작하기

Finexly API는 170개 이상의 통화에 대한 실시간 및 과거 환율을 제공합니다. 시작하기는 간단합니다:

  1. 무료 계정 등록
  2. 대시보드에서 API 액세스 키 받기
  3. 첫 번째 API 요청 만들기

기본 URL

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

인증

모든 API 요청은 Bearer 토큰을 통한 인증이 필요합니다. Authorization 헤더에 API 키를 포함하세요:

인증 헤더 (필수)

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 API 토큰이 없거나 유효하지 않습니다.
403 FORBIDDEN 접근이 거부되었습니다. 계정이 비활성화되었을 수 있습니다.
413 PAYLOAD_TOO_LARGE 요청 페이로드가 최대 허용 크기를 초과했습니다.
429 RATE_LIMIT_EXCEEDED 속도 제한을 초과했습니다. X-RateLimit 헤더를 확인하세요.
500 INTERNAL_ERROR 내부 서버 오류가 발생했습니다. 다시 시도해 주세요.