Quote API

환율 조회 API 명세입니다.

---

Get Exchange Rate

특정 통화쌍의 현재 환율을 조회합니다.

Endpoint

GET /v1/rates/{pair}

Path Parameters

Parameter	Type	Description
pair	string	통화쌍 (예: USDC/KRW, USD/KRW)

Example Request

curl -X GET "https://api.ezys.io/v1/rates/USDC/KRW" \
  -H "X-API-Key: ezys_live_sk_xxxxx"

Response

{
  "success": true,
  "data": {
    "base": "USDC",
    "target": "KRW",
    "rate": "1424.50",
    "appliedRate": "1424.50",
    "spreadBps": 50,
    "timestamp": "2025-01-29T12:00:00Z",
   "ttlMs": 30000
  }
}

Response Fields

Field	Type	Description
base	string	기준 통화
target	string	대상 통화
rate	string	시장 환율
appliedRate	string	적용 환율 (스프레드 포함)
spreadBps	number	스프레드 (basis points)
timestamp	string	환율 조회 시각 (ISO 8601)
ttlMs	number	30000

Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_PAIR",
    "message": "Unsupported pair: ABC/XYZ"
  }
}

---

List Supported Pairs

지원하는 통화쌍 목록을 조회합니다.

Endpoint

GET /v1/pairs

Example Request

curl -X GET "https://api.ezys.io/v1/pairs" \
  -H "X-API-Key: ezys_live_sk_xxxxx"

Response

{
  "success": true,
  "data": {
    "pairs": [
      {
        "pair": "USDC/KRW",
        "base": "USDC",
        "target": "KRW",
        "minAmount": "10",
        "maxAmount": "1000000",
        "amountPrecision": 2,
        "pricePrecision": 2
      },
      {
        "pair": "USD/KRW",
        "base": "USD",
        "target": "KRW",
        "minAmount": "10",
        "maxAmount": "1000000",
        "amountPrecision": 2,
        "pricePrecision": 2
      },
      {
        "pair": "KRW/USD",
        "base": "KRW",
        "target": "USD",
        "minAmount": "10000",
        "maxAmount": "1000000000",
        "amountPrecision": 0,
        "pricePrecision": 6
      }
    ]
  }
}

Pair Object Fields

Field	Type	Description
pair	string	통화쌍
base	string	기준 통화
target	string	대상 통화
minAmount	string	최소 거래 금액 (base 기준)
maxAmount	string	최대 거래 금액 (base 기준)
amountPrecision	number	금액 소수점 자릿수
pricePrecision	number	가격 소수점 자릿수

---

지원 통화쌍

Pair	Description
USDC/KRW	USDC → 한국 원화
KRW/USDC	한국 원화 → USDC
USD/KRW	미국 달러 → 한국 원화
KRW/USD	한국 원화 → 미국 달러

지원 통화쌍은 계속 추가됩니다. /v1/pairs API로 최신 목록을 확인하세요.