YesFi API 점검 보고서
2026-10-18 · 제공 문서 기준 · 테스트 환경 · 지정한 테스트 회원 기준
우선 확인할 사항
- 옵션 포지션 7종: 실제 API가 요구하는 전체 query 규격과 성공 예제 필요. 현재 모두 HTTP 400.
- 서명 보험 목록: 공개 계정은 조회되지만 보험 목록에서는 account_not_found 반환.
- 서명 유효 보험: 문서에 적힌 경로가 HTTP 404와 비 JSON 반환.
- YesFi 프런트엔드 로그인: authToken 쿠키 발급은 정상. 새 창의 브라우저 세션으로 넘기는 공식 절차·예제 필요. URL이 없다는 것은 API 오류가 아님.
- Beats WebSocket 주소·구독 메시지, 체인별 테스트 USDC 계약과 테스트 자금 제공 필요.
- 출금·복구의 멱등 키와 재시도 규격 필요. 동일 변경 요청은 결과 확인 없이 재전송하지 않도록 차단함.
전체 결과 JSON 내려받기 · 미검증은 실패 또는 정상으로 간주하지 않습니다. 현재 회원의 개별 실행 결과는 기능 확인 화면에서 별도 내려받을 수 있습니다.
API별 결과
| 기능·경로 | 결과 | HTTP·코드 | 문제점·필요한 확인 |
|---|---|---|---|
연결 상태GET /healthz | 정상 | 200 | 정상 응답 확인 |
계정·증거금POST /v1/public/exchange/account | 정상 | 200 | 정상 응답 확인 |
미결제 포지션GET /v1/public/exchange/positions | 정상 | 200 | 정상 응답 확인 |
포지션 내역GET /v1/public/exchange/positions/history | 정상 | 200 | 정상 응답 확인 |
주문 내역GET /v1/public/exchange/orders/list | 정상 | 200 | 정상 응답 확인 |
거래 종목GET /v1/public/exchange/symbols | 정상 | 200 | 정상 응답 확인 |
현재 시세GET /v1/public/marketdata/ticker | 정상 | 200 | 정상 응답 확인 |
기준 가격GET /v1/public/exchange/mark-price | 정상 | 200 | 정상 응답 확인 |
펀딩 비율GET /v1/public/exchange/funding-rate | 정상 | 200 | 정상 응답 확인 |
캔들GET /v1/public/marketdata/kline | 정상 | 200 | 정상 응답 확인 |
펀딩 정산 내역GET /v1/public/insurance/funding-fees/history | 정상 | 200 | 정상 응답 확인 |
beats 종목GET /v1/public/beats/symbols | 정상 | 200 | 정상 응답 확인 |
beats 포지션GET /v1/public/beats/positions | 오류 | 400 BEATS_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
trend 종목GET /v1/public/trend/symbols | 정상 | 200 | 정상 응답 확인 |
trend 포지션GET /v1/public/trend/positions | 오류 | 400 TREND_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
range 종목GET /v1/public/range/symbols | 정상 | 200 | 정상 응답 확인 |
range 포지션GET /v1/public/range/positions | 오류 | 400 RANGE_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
steps 종목GET /v1/public/steps/symbols | 정상 | 200 | 정상 응답 확인 |
steps 포지션GET /v1/public/steps/positions | 오류 | 400 STEPS_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
combo 종목GET /v1/public/combo/symbols | 정상 | 200 | 정상 응답 확인 |
combo 포지션GET /v1/public/combo/positions | 오류 | 400 COMBO_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
pair 종목GET /v1/public/pair/symbols | 정상 | 200 | 정상 응답 확인 |
pair 포지션GET /v1/public/pair/positions | 오류 | 400 PAIR_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
moves 종목GET /v1/public/moves/symbols | 정상 | 200 | 정상 응답 확인 |
moves 포지션GET /v1/public/moves/positions | 오류 | 400 MOVES_BAD_REQUEST | 문서에는 주소·페이지 입력 규격이 누락되어 있음. addresses로 호출 시 wallet_address 누락 오류, wallet_address로 변경 후에도 bad request가 발생함. Beats·Trend는 페이지 인자를 제거해도 동일. 필수 query·허용 상태·페이지 규격의 정확한 예제 필요. |
입금 내역GET /v1/public/exchange/wallet/deposits | 정상 | 200 | 정상 응답 확인 |
출금 내역GET /v1/public/exchange/wallet/withdrawals | 정상 | 200 | 정상 응답 확인 |
입금 주소 발급POST /v1/private/exchange/wallet/deposit-address | 미검증 | — | 최초 eoa 귀속이 확정되는 변경 작업으로 개별 실행 필요. |
출금 요청POST /v1/private/exchange/wallet/withdrawals | 미검증 | — | 테스트 USDC 계약 주소·테스트 자금·수신 주소 필요. 문서는 write idempotency를 요구하지만 출금 본문의 멱등 키 필드는 누락되어 있어 제공사 확인 필요. 동일 요청의 성공·결과 불명 상태는 자체 기록으로 재전송 차단. |
계정 간 이체POST /v1/private/exchange/wallet/transfer | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
오입금 복구POST /v1/private/exchange/wallet/recovery | 미검증 | — | 테스트 체인·토큰·오입금 사례·복구 대상 필요. 문서에 멱등 키 필드가 없으므로 재시도 규격 확인 필요. |
주문POST /v1/private/exchange/orders | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
주문 취소POST /v1/private/exchange/orders/{orderId}/cancel | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
포지션 청산POST /v1/private/exchange/positions/close | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
증거금 조정POST /v1/private/exchange/positions/adjust-margin | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
익절·손절 설정POST /v1/private/exchange/positions/protections/set | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
익절·손절 취소POST /v1/private/exchange/positions/protection/cancel | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
beats 주문POST /v1/private/beats/batch-open | 미검증 | — | 테스트 자금과 WebSocket의 원문 시간·가격 셀 값이 필요. WebSocket 주소·구독 규격이 미제공됨. |
trend 주문POST /v1/private/trend/open | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
range 주문POST /v1/private/range/open | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
steps 주문POST /v1/private/steps/open | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
combo 주문POST /v1/private/combo/open | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
pair 주문POST /v1/private/pair/open | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
moves 주문POST /v1/private/moves/open | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
보험 규칙GET /v1/public/insurance/rules | 정상 | 200 | 정상 응답 확인 |
보험 지원 종목GET /v1/public/insurance/supported-tokens | 정상 | 200 | 정상 응답 확인 |
공개 유효 보험GET /v1/public/insurance/policies/active | 정상 | 200 | 정상 응답 확인 |
공개 보험 내역GET /v1/public/insurance/policies/history | 정상 | 200 | 정상 응답 확인 |
보험료 견적POST /v1/public/insurance/quote | 정상 | 200 | 정상 응답 확인 |
서명 보험 목록GET /v1/private/insurance/policies | 오류 | 200 account_not_found | 공개 계정 조회는 HTTP 200이지만 서명 보험 목록은 HTTP 200 / success=false / account_not_found. 보험 서비스 계정 초기화·계정 매핑·입금 선행 조건 확인 필요. |
서명 유효 보험GET /v1/private/insurance/policies/active | 오류 | 404 NON_JSON_RESPONSE | 문서 경로가 HTTP 404와 비 JSON을 반환함. 실제 지원 경로·배포 버전 확인 필요. |
보험 가입POST /v1/private/insurance/buy | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
보험 갱신 견적POST /v1/private/insurance/renew/preview | 미검증 | — | 기존 유효 policyId가 필요함. |
보험 갱신·교체POST /v1/private/insurance/renew | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
보험 취소POST /v1/private/insurance/cancel | 미검증 | — | 테스트 자금·주문/포지션/보험 식별자·대상 주소를 확인한 뒤 개별 실행 필요. |
채널 가입POST /v1/private/operation/wallet-connect | 정상 | — | 기존 accepted 가입 기록과 회원 DB 저장을 앞선 점검에서 확인함. 재가입하지 않음. |
로그인 nonce 확인POST /api/v1/auth/login | 정상 | 200 | 앞선 실제 로그인 검증에서 nonce·message 발급과 서명을 확인함. |
YesFi 로그인POST /api/v1/auth/login | 정상 | 200 | 문서의 2단계 personal_sign 로그인·authToken 쿠키 발급은 정상. 문서에는 접속 URL을 반환한다고 쓰여 있지 않음. Open the frontend with authToken의 브라우저 세션 전달 절차·예제가 미명시됨. |
YesFi 로그아웃POST /api/v1/auth/logout | 미검증 | — | 서버에 새로 만든 로그인 세션이 없으므로 실행하지 않음. |
와와빗 로그인LOCAL /member/login/ | 정보 부족 | — | 별도 YesFi API가 아닌 와와빗 자체 인증 영역. 현재는 기존 회원 쿠키를 사용하며, 문서의 CoinRF JWT와 와와빗 인증 수단의 대응 관계를 확인해야 함. |
Beats WebSocketWS 미제공 | 정보 부족 | — | 문서에 WebSocket 주소와 구독 메시지 규격이 없어 제공사 확인이 필요합니다. |