Overview

EZYS REST API 명세입니다.

---

Base URL

https://api.ezys.io/v1

---

Authentication

모든 API 요청에는 API Key가 필요합니다.

X-API-Key: ezys_live_sk_xxxxxxxxxxxxx

→ 상세: Authentication

---

Endpoints

Rate

Method	Endpoint	Description
GET	/v1/rates/{pair}	실시간 환율 조회
GET	/v1/pairs	지원 통화쌍 목록

Intent

Method	Endpoint	Description
POST	/v1/intents	Intent 제출
GET	/v1/intents/{intentId}	Intent 상태/결과 조회
GET	/v1/intents	Intent 목록 조회
DELETE	/v1/intents/{intentId}	Intent 취소 (executing 이전)

---

Request Format

Headers

Content-Type: application/json
X-API-Key: ezys_live_sk_xxxxx

Body

JSON 형식으로 전송합니다.

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

---

Response Format

Success

{
  "success": true,
  "data": {
    // Response data
  }
}

Error

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message"
  }
}

---

HTTP Status Codes

Code	Description
200	성공
201	생성 성공
400	잘못된 요청 (파라미터 오류)
401	인증 실패 (API Key 없음/잘못됨)
403	권한 없음
404	리소스 없음
429	Rate Limit 초과
500	서버 오류

---

Error Codes

Code	Description
INVALID_API_KEY	잘못된 API Key
INVALID_PAIR	지원하지 않는 통화쌍
INVALID_PARAMETER	잘못된 파라미터
INVALID_STRATEGY	잘못된 실행 전략
AMOUNT_OUT_OF_RANGE	금액 범위 초과
CONSTRAINTS_NOT_MET	조건 충족 불가
INSUFFICIENT_LIQUIDITY	유동성 부족
INTENT_NOT_FOUND	Intent 없음
INTENT_EXPIRED	Intent 만료
INTENT_ALREADY_EXECUTING	이미 실행 중 (취소 불가)
RATE_LIMIT_EXCEEDED	요청 한도 초과

---

Rate Limits

Tier	Limit
Standard	100 requests/minute
Enterprise	Custom

Rate limit 초과 시:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please retry after 60 seconds."
  }
}

---

Pagination

목록 조회 API는 페이지네이션을 지원합니다.

Request

GET /v1/intents?page=1&limit=20

Response

{
  "success": true,
  "data": {
    "items": [...],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "totalPages": 8
    }
  }
}

---

SDKs

SDK는 준비 중입니다. 현재는 REST API를 직접 사용해주세요.

---

API 상세

• Authentication

• Quote API

• Intent API