Overview

EZYS를 통해 핀테크 서비스에 FX 기능을 연동하는 방법을 안내합니다.

---

Why EZYS?

기존 방식에서 FSP는 환전 서비스를 제공하기 위해 개별 금융기관과 직접 계약하고 연동해야 했습니다.

┌─────────┐     ┌─────────┐
│   FSP   │────▶│  Bank A │
│         │────▶│  Bank B │
│         │────▶│  OTC C  │
└─────────┘     └─────────┘
   개별 연동 필요 (계약, 기술, 운영)

EZYS는 이 복잡성을 단일 Intent로 해결합니다.

┌─────────┐     ┌─────────┐     ┌─────────┐
│   FSP   │────▶│  EZYS   │────▶│  LPs    │
└─────────┘     └─────────┘     └─────────┘
   Intent 제출    자동 매칭/실행   복수 LP

---

핵심 개념: Intent-Based Execution

FSP는 "무엇을 원하는지"만 선언합니다. "어떻게"는 EZYS가 결정합니다.

기존 RFQ 방식	EZYS Intent 방식
Quote 요청 → 비교 → 선택 → 주문	Intent 제출 → 자동 실행
FSP가 최적 가격 탐색	Solver Network가 탐색
여러 단계 API 호출	단일 API 호출

FSP가 해야 할 일:

  POST /v1/intents
  {
    "pair": { "source": "USDC", "target": "KRW" },
    "side": "sell",
    "amount": "1000",
    "strategy": "instant",
    "constraints": { "maxSlippageBps": 50, "maxFeeBps": 30 }
  }

  → 끝. 나머지는 EZYS가 처리.

---

주요 이점

이점	설명
단일 연동	하나의 API로 복수 LP에 접근
Intent 제출만	Quote 비교, 주문 생성 불필요
최적 실행 보장	Solver Network가 최적 경로 탐색
투명한 기록	모든 거래가 On-chain에 기록
유연한 정산	Crypto/Fiat 모두 지원

---

연동 플로우

FSP                          EZYS                        Solver Network
 │                             │                              │
 │  1. Submit Intent           │                              │
 │  (strategy + constraints)   │                              │
 │────────────────────────────▶│                              │
 │                             │  2. Broadcast to Solvers     │
 │                             │─────────────────────────────▶│
 │                             │                              │
 │                             │  3. Solvers compete          │
 │                             │  (최적 경로 탐색)             │
 │                             │◀─────────────────────────────│
 │                             │                              │
 │  4. Execution Confirmed     │                              │
 │◀────────────────────────────│                              │
 │                             │                              │
 │  5. Settlement Completed    │                              │
 │◀────────────────────────────│                              │
 │                             │                              │

FSP는 1단계(Intent 제출)만 수행합니다. 나머지는 자동으로 처리됩니다.

---

Quick Start

1. API Key 발급

EZYS 팀에 연락하여 API Key를 발급받으세요.

X-API-Key: ezys_live_sk_xxxxxxxxxxxxx

2. Intent 제출

curl -X POST "https://api.ezys.io/v1/intents" \
  -H "X-API-Key: ezys_live_sk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pair": {
      "source": "USDC",
      "target": "KRW"
    },
    "side": "sell",
    "amount": "1000",
    "strategy": "instant",
    "constraints": {
      "maxSlippageBps": 50,
      "maxFeeBps": 30
    },
    "clientRef": "your-reference-id"
  }'

3. 상태 확인

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

# Response:
# {
#   "intentId": "int_2f8a3b1c",
#   "status": "settled",
#   "execution": { ... },
#   "settlement": { ... }
# }

---

다음 단계

• Integration Guide - Intent 구조 상세

• Execution Strategy - 실행 전략 선택

• Settlement - 정산 상태 추적

• API Reference - 전체 API 명세

---

지원

연동 관련 문의: [email protected]