SwapSpace API vs. Changelly API: 개발자를 위한 완전한 비교

지갑이나 Web3 제품에 스왑 기능을 추가하면 사용자 경험 이상의 훨씬 더 많은 부분에 영향을 줍니다. 선택한 API는 백엔드가 견적을 요청하는 방식, 만료된 환율을 처리하는 방식, 트랜잭션을 추적하는 방식, 그리고 경로(route)를 사용할 수 없을 때 대응하는 방식을 결정합니다. 또한 거래소가 지연되거나, 환불되거나, 검증을 위해 일시 중지될 때 지원 업무량에도 영향을 줍니다.

이 Changelly API vs SwapSpace API 비교는 지갑, 거래소 및 기타 Web3 제품을 구축하는 개발자에게 중요한 기술적 차이점을 살펴봅니다.

이 비교는 각 제공업체의 공개 문서와 현재 B2B 페이지를 사용합니다. 자산 가용성, 요청 제한, 상업 조건, 규정 준수 규칙은 변경될 수 있습니다. 출시 전에 실시간 API와 파트너 계약을 통해 확인하세요.

Changelly API란?

Changelly API v2는 하나의 Changelly 견적 및 거래 서비스만 제공하는 화이트라벨 암호화폐 거래소 API입니다.

• 프로토콜: 서명된 POST 요청을 통한 JSON-RPC 2.0.
• 인증: X-Api-Key와 RSA-SHA256 서명, 파트너 계정 및 공개 키 등록 포함.
• 환율 모델: 고정 환율과 변동 환율 방법을 별도로 제공.
• 자산 범위: 공개 B2B 페이지에서 1,000개 이상의 자산 제공, 실시간 활성 자산 목록은 API가 반환.
• 관련 제품: 별도의 법정화폐 API, 위젯, 체크아웃 서비스.

이 API는 제공업체 선택을 애플리케이션 밖으로 분리합니다. 고정 및 변동 견적은 서로 다른 메서드를 사용하며, 고정 견적은 짧은 유효 기간을 가집니다. 이러한 차이점은 거래 생성 단계까지 이어집니다. 주요 구현 차이는 경로 순위 매기기보다 요청 서명 방식입니다.

SwapSpace API란?

SwapSpace API v2는 하나의 통합으로 여러 거래소 파트너의 오퍼를 제공하는 REST API입니다.

• 프로토콜: 통화, 파트너, 금액, 거래 생성, 상태를 위한 리소스별 REST 엔드포인트.
• 인증: Authorization 헤더의 API 키, 제휴사별로 구성되는 요청 제한.
• 환율 모델: 고정 및 변동 오퍼, 파트너 필터, Best Amount 옵션.
• 자산 범위: 공개 B2B 페이지에서 675개 네트워크에 걸친 3,600개 이상의 자산과 40개 이상의 유동성 소스 제공, 실시간 경로 검증 필요.
• 관련 제품: 거래소 위젯 및 프라이빗 전송, 프라이빗 전송 접근 권한은 별도로 확인.

각 오퍼에는 파트너 및 경로 데이터가 포함됩니다. 애플리케이션은 여러 오퍼를 보여주거나, 필터링하거나, 더 단순한 선택 방식을 사용할 수 있습니다. 오퍼 ID는 단기간만 유효할 수 있으며, 제공업체 메타데이터는 환불 주소 요구사항을 변경할 수 있습니다. 이러한 경로 수준 데이터가 Changelly의 단일 서비스 계약과의 핵심 아키텍처 차이입니다.

한눈에 보는 Changelly API vs SwapSpace API 비교

이 거래소 API 비교는 개발자가 공개 문서에서 검증할 수 있는 통합 표면에 초점을 맞춥니다.

유동성 아키텍처: 단일 제공업체 API vs 집계기

견적 선택과 투명성

Changelly는 자체 인프라 전반에서 유동성을 소싱할 수 있지만, 파트너 API에서는 Changelly가 서비스 경계로 노출됩니다. 애플리케이션은 견적을 요청하고 요청한 방식과 페어에 대한 하나의 결과를 받습니다. 이렇게 하면 견적 모델이 간결하게 유지됩니다. 제품은 제공업체 순위를 매길 필요도 없고, 왜 두 제공업체가 서로 다른 한도를 반환했는지 설명할 필요도 없습니다.

SwapSpace는 유동성 집계를 직접 노출합니다. 금액 엔드포인트는 사용 가능한 모든 파트너의 오퍼 또는 선택한 파트너 목록의 오퍼를 반환할 수 있습니다. 응답에는 동일한 페어에 대한 고정 및 변동 경로가 포함될 수 있습니다. 이는 지갑이나 거래소가 정렬을 더 세밀하게 제어할 수 있게 합니다. 제품은 최종 수령 금액, 예상 소요 시간, 제공업체 정책 또는 자체 비즈니스 규칙에 따라 순위를 매길 수 있습니다.

청중이 제공업체 선택 또는 경로 투명성을 중시한다면, SwapSpace 통합을 통해 여러 오퍼를 표시하고 제품별 선택 규칙을 적용할 수 있습니다. 더 단순한 제품은 하나의 선택된 경로만 노출할 수 있습니다. 인터페이스가 필요로 할 때는 제공업체 식별 정보, 환율 유형, 한도, 예상 소요 시간을 계속 사용할 수 있습니다.

가용성과 대체 동작

Changelly에서는 통화가 비활성화되었거나 견적이 실패하면, 같은 계약 안에서 다른 명명된 제공업체를 노출하지 않습니다. 애플리케이션이 다른 경로를 선택하려면 별도의 통합이 필요합니다.

거래 생성 전에 SwapSpace는 다른 사용 가능한 파트너의 오퍼를 반환할 수 있습니다. 거래가 생성되면 선택된 제공업체는 해당 트랜잭션에 연결된 상태로 유지됩니다. 따라서 Changelly는 경로 의존성을 하나의 서비스에 집중시키고, SwapSpace는 같은 API 안에서 거래 전 대체 경로를 제공합니다.

규정 준수와 지원 경계

두 API 모두 검증 관련 상태를 노출할 수 있지만, 책임 분담 방식은 다릅니다. 

Changelly는 hold 상태를 문서화하고 파트너가 사용자를 보안 팀으로 안내하도록 지시합니다. 

SwapSpace는 Verifying 상태를 노출하며, 선택된 거래소 제공업체가 검사를 제어할 수 있습니다. 따라서 집계 모델에서는 제공업체 식별 정보와 지원 안내가 더 중요합니다.

개발자 경험

접근 및 인증

인증은 가장 명확한 구현 차이이자 크립토 스왑 통합의 첫 단계를 형성합니다.

Changelly:

• 파트너 계정과 공개 키 등록.
• 모든 JSON-RPC 요청 본문에 대한 RSA-SHA256 서명.
• 개인 키 보호를 위한 서버 측 통합.

SwapSpace:

• 제휴 계정과 Authorization 헤더의 API 키.
• 온보딩 중 제휴사별로 구성되는 요청 제한.
• API 키의 서버 측 저장.

Changelly는 더 많은 설정과 서명 코드를 요구합니다. SwapSpace는 더 가벼운 자격 증명 모델을 사용하며, 실제 운영 용량은 제휴사 구성에 따라 달라집니다.

문서화와 오류 처리

Changelly 문서:

• 메서드 수준의 요청 스키마와 오류 예시.
• 여러 프로그래밍 언어의 인증 샘플.
• 마이그레이션 노트와 상세한 상태 참고 자료.

SwapSpace 문서:

• 통화와 파트너에서 거래 상태까지 이어지는 짧은 REST 흐름.
• 금액, rate ID, extra ID, 사용자 IP, 조건부 환불 주소에 대한 검증 규칙.

Changelly는 더 깊은 인증 및 오류 자료를 제공합니다. SwapSpace는 더 많은 경로 선택 데이터를 담은 더 짧은 흐름을 문서화합니다.

Changelly의 JSON-RPC 응답은 메서드별 코드와 메시지를 노출합니다. SwapSpace의 REST 흐름은 네트워크 ID, rate ID, extra ID, 사용자 IP, 조건부 환불 주소와 같은 검증 필드를 문서화합니다. 이러한 상위 오류를 인터페이스에 도달하기 전에 안정적인 내부 범주로 매핑하세요. 지원팀이 경로를 추적할 수 있도록 원본 오류 코드와 거래 ID를 로그에 유지하고, 원시 제공업체 메시지는 사용자에게 직접 보여주지 마세요.

성능 및 확장성 고려사항

Changelly는 관련 메서드에 대해 기본 초당 10 요청 제한을 공개합니다. 더 높은 처리량 조건은 공개 참고 자료에 명시되어 있지 않습니다.

SwapSpace는 요청 제한이 각 제휴사별로 구성되므로 표준 수치 상한을 공개하지 않습니다. 따라서 용량 계획은 공개 기본값이 아니라 합의된 파트너 구성에 따라 달라집니다.

두 공개 흐름 모두 폴링 기반 상태 엔드포인트를 제공합니다. 이 비교를 위해 검토한 공개 참고 자료에는 일반적인 webhook 계약이 정의되어 있지 않으므로, webhook 제공 여부는 파트너 온보딩의 일부로 남아 있습니다.

폴링 동작은 용량 계획에도 영향을 줍니다. 정의된 기간 동안 통화 및 파트너 메타데이터를 캐시하고, 사용자가 조치할 수 없는 견적은 새로 고침하지 말며, 트랜잭션이 시간 민감 단계에서 벗어나면 상태 확인 빈도를 줄이세요. 부하 테스트는 견적 급증, 만료된 ID, 비활성화된 페어, 제공업체 측 실패까지 포함해야 합니다. 단일 지연 수치가 아니라 전체 실패 경로를 벤치마크하세요. 경로가 사라지거나 상위 응답이 느려져도 제품은 반응성을 유지해야 합니다.

지원과 에스컬레이션

개발자를 위한 암호화폐 거래소 API에서는 트랜잭션이 멈추거나 검증 단계에 들어갈 때 지원 범위가 가장 중요합니다. 

Changelly는 기술 문의를 파트너 이메일 또는 전담 계정 매니저로 안내합니다. 문서에서는 파트너가 1차 지원을 제공하고, 미해결 사례는 전용 Slack 채널을 통해 Changelly의 2차 팀으로 전달하는 에스컬레이션 모델을 설명합니다.

SwapSpace는 24/7 사용자 지원과 함께 파트너 이메일 및 B2B 문의 양식을 제공합니다. 에스컬레이션 경로와 응답 약속은 파트너 계약에 따라 달라집니다.

어느 API든 통합하기 전에 지원 시간, 장애 알림, 상태 페이지 접근 권한, 그리고 멈춘 거래를 조사하는 데 필요한 데이터를 확인하세요.

상업 조건 및 수익 모델

어느 암호화폐 거래소 API도 공개 통합 비용을 청구하지 않습니다. 둘 다 추가 수수료 또는 수익 공유 모델을 통한 파트너 수익화를 지원합니다.

Changelly는 API 파트너가 거래 환율에 수수료를 추가할 수 있게 합니다. 비즈니스 FAQ에서는 일반적인 범위를 0.1%에서 5%로 설명하며, 현재 API 문서는 수수료가 파트너 팀을 통해 구성된다고 밝힙니다.

SwapSpace의 거래 생성 엔드포인트에는 선택적 affiliateFee 매개변수가 포함됩니다. 제휴 수수료율은 선택된 유동성 제공업체와 파트너 계약에 따라 달라집니다.

통합 워크플로

아래 단계는 두 크립토 스왑 API 워크플로와 각 크립토 API 통합에 필요한 엔지니어링 작업을 비교합니다.

일반적인 Changelly 통합

1. 1. Changelly 파트너 계정을 만들고 공개 키와 개인 키를 생성합니다.
2. 2. 공개 키를 Changelly에 등록하고 개인 키는 서버 측 비밀 저장소에 보관합니다.
3. 3. JSON-RPC 2.0 요청 직렬화와 RSA-SHA256 서명을 구현합니다.
4. 4. 활성화된 통화 데이터를 가져와 티커, 네트워크, 메모 필드, 검증 규칙을 매핑합니다.
5. 5. 변동 또는 고정 견적을 요청한 뒤 반환된 금액과 한도를 검증합니다.
6. 6. 견적 또는 결제 창이 만료되기 전에 올바른 거래 유형을 생성합니다.
7. 7. 거래 ID를 저장하고 지수적 백오프를 사용해 getStatus 또는 getTransactions를 폴링합니다.
8. 8. 모든 종료, 환불, 만료, 검증 상태를 사용자 메시지와 지원 절차에 매핑합니다.

Changelly는 두 가지 프로토콜 제약을 둡니다. 서명은 정확히 직렬화된 본문과 일치해야 하며, v2 견적은 v2 거래 메서드와 짝을 유지해야 합니다.

💡 중요! 고정 및 변동 흐름은 서로 다른 메서드를 사용하므로 별도로 테스트해야 합니다.

일반적인 SwapSpace 통합

1. 1. 제휴 계정을 만들고 API 키를 받은 뒤 대상 환경의 요청 허용량을 확인합니다.
2. 2. 통화 목록을 가져오고 자산 및 네트워크 식별자를 분리해 보관합니다.
3. 3. 파트너 목록을 가져오고 환불 주소 규칙 같은 경로 요구사항을 저장합니다.
4. 4. 페어, 금액, 네트워크, 필요한 환율 유형에 대한 사용 가능 금액을 요청합니다.
5. 5. 반환된 오퍼의 순위를 매기거나, 제품의 선택 정책에 따라 Best Amount 엔드포인트를 요청합니다.
6. 6. 최소 및 최대 값을 검증한 뒤, 반환된 rate ID가 만료되기 전에 거래를 생성합니다.
7. 7. SwapSpace 거래 ID, 선택된 제공업체, 사용자에게 표시될 거래 데이터를 저장합니다.
8. 8. 백오프를 사용해 상태 엔드포인트를 폴링하고 완료, 실패, 환불, 검증 중, 만료 상태를 처리합니다.

SwapSpace는 선택된 오퍼를 생성된 거래에 연결합니다. 새 견적이나 새 제공업체가 있으면 새로운 거래 요청이 생성됩니다.

💡 중요! 견적이 거래 생성 전에 만료되면 사용자가 업데이트된 오퍼를 승인해야 합니다.

어떤 API가 어떤 제품에 적합한가?

제품을 위한 지갑용 크립토 API를 평가하는 팀은 먼저 사용자가 하나의 거래 관계를 원하는지, 아니면 제공업체 선택이 보여야 하는지를 결정해야 합니다.

이 표는 제품 적합성을 시작 가설로 다룹니다. 상업 조건, 지역, 자산 수요, 트래픽, 내부 엔지니어링 역량에 따라 결과는 달라질 수 있습니다.

Changelly API가 적합한 경우

Changelly API는 하나의 거래 서비스와 간결한 견적 응답을 선호하는 제품에 적합합니다.

상세한 서명 예시와 메서드 수준 오류 문서는 명확하게 정의된 인증 계층을 중시하는 팀에 도움이 됩니다. 또한 동일한 B2B 관계 아래에서 Changelly의 별도 법정화폐 또는 체크아웃 제품을 검토하려는 회사에도 적합할 수 있습니다.

트레이드오프는 경로 가시성입니다. 이 API는 명명된 거래소 제공업체 목록이 아니라 Changelly 견적을 반환합니다. 또한 통합 시 온보딩 단계에서 공개 키 등록이 필요합니다.

SwapSpace API가 적합한 경우

SwapSpace 는 제품의 일부로 제공업체 비교가 포함될 때 더 적합합니다. 하나의 REST API를 통해 여러 오퍼, 고정 및 변동 옵션, 파트너 필터, 경로 메타데이터를 노출합니다. B2B 페이지에는 675개 네트워크에 걸친 40개 이상의 유동성 소스와 3,600개 이상의 자산이 나와 있습니다. 하나의 계약으로 더 넓은 롱테일 및 크로스체인 경로 범위를 제공하는 것이 가치입니다.

제품이 여러 오퍼를 가져와 자체적으로 경로를 선택하는 경우, 통합에는 명시적인 선택 기준, 견적 만료 처리, 제공업체별 거래 데이터가 필요할 수 있습니다. Best Amount 또는 더 단순한 흐름을 사용하는 제품은 이러한 라우팅 로직의 더 많은 부분을 사용자 인터페이스 밖에 둘 수 있습니다.

최종 결론

보편적인 최고의 스왑 API는 없습니다. 

Changelly는 JSON-RPC 2.0, RSA-SHA256 요청 서명, 단일 제공업체 견적 모델을 사용합니다. 상세한 메서드 및 오류 문서를 제공하지만, 같은 API를 통해 경쟁 제공업체 경로를 노출하지는 않습니다. 

SwapSpace는 API 키 인증을 사용하는 REST를 기반으로 하며 여러 거래소 파트너의 오퍼를 반환하여, 제품이 경로 선택을 더 세밀하게 제어하고 더 넓은 자산 범위를 활용할 수 있게 합니다.

하나의 제공업체 관계, 간결한 견적 흐름, 상세한 메서드 수준 문서를 선호하는 제품에는 Changelly를 선택하세요. 제공업체 비교, 유동성 집계, 더 넓은 롱테일 경로 범위가 필요한 지갑, 거래소, Web3 제품에는 SwapSpace를 선택하세요.

SwapSpace API 통합 시작하기

SwapSpace B2B 페이지의 양식을 제출하여 제품 및 비즈니스 개발 팀과 접근 권한, 요청 제한, 통합 요구사항을 논의하세요. 

자주 묻는 질문

SwapSpace API와 Changelly API의 차이점은 무엇인가요?

Changelly는 JSON-RPC 2.0을 통해 화이트라벨 거래 서비스를 제공합니다. 애플리케이션은 Changelly 견적을 받고 Changelly 거래를 생성합니다. SwapSpace는 REST API를 통해 여러 파트너 오퍼를 노출하여, 거래를 생성하기 전에 애플리케이션이 경로를 비교하거나 필터링할 수 있게 합니다.

SwapSpace API는 여러 유동성 제공업체를 집계하나요?

예. 금액 엔드포인트는 사용 가능한 모든 파트너의 오퍼를 반환하거나 선택한 파트너로 필터링할 수 있습니다. 공개 B2B 페이지에는 40개 이상의 유동성 소스가 나와 있습니다. 가용성은 자산, 네트워크, 금액, 환율 유형, 현재 제공업체 조건에 따라 달라집니다.

어떤 API가 크립토 지갑에 더 적합한가요?

지갑의 제품 설계에 따라 다릅니다. Changelly는 하나의 견적과 제공업체 관계를 원하는 지갑에 적합합니다. SwapSpace는 제공업체 비교, 더 넓은 경로 범위, 또는 자체 오퍼 순위 로직을 원하는 지갑에 적합합니다. 적합성은 지갑이 자주 사용하는 페어와 롱테일 페어의 범위에 따라 달라지기도 합니다.

직접 거래소를 만들지 않고도 크립토 스왑을 통합할 수 있나요?

예. 두 API 모두 제품이 거래 실행을 외부에 맡기면서 인터페이스와 백엔드 오케스트레이션은 직접 제어할 수 있게 합니다. 주소 검증, 상태 처리, 지원은 여전히 제품 통합의 일부입니다.

SwapSpace API는 고정 및 변동 환율을 지원하나요?

예. 금액 엔드포인트는 고정 및 변동 필터를 받아 한 번의 요청으로 두 유형을 모두 반환할 수 있습니다. 지원 여부는 파트너와 페어에 따라 다릅니다. 일부 오퍼에는 거래 생성 시 사용해야 하는 단기 유효 rate ID가 포함됩니다.

일반적인 API 통합에는 얼마나 걸리나요?

공개 마케팅 추정치는 신뢰할 수 있는 프로젝트 계획이 아닙니다. 기본 개념 증명은 며칠이 걸릴 수 있지만, 실제 배포 일정은 키 승인, 보안 검토, 인터페이스 작업, 규정 준수 상태, 분석, 지원 도구에 따라 달라집니다.

_______

이 비교는 정보 제공 목적입니다. API 기능, 자산 범위, 제한, 수수료, 규정 준수 요구사항은 변경될 수 있습니다. 프로덕션 암호화폐 거래소 API를 배포하기 전에 최신 문서와 계약 조건을 검토하세요.