시작하기
0x API 모음은 앱에서 더 빠른 거래, 더 나은 가격, 최고의 UX를 제공하는 가장 간단한 방법입니다. 시작하려면 0x 대시보드에 액세스할 계정을 설정해야 합니다. 이를 통해 새 프로젝트용 API 키 생성, 통합 모니터링/관리, 새 API 접근 및 개발자 리소스 활용이 가능합니다.
단계를 따라 5분 이내로 시작하세요!
1. 0x 계정 생성
0x 대시보드에서 Sign Up 클릭 → 이름/이메일/비밀번호 입력 → Continue 클릭
2. 팀 생성
인증 후 0x 팀 생성 요청. 팀 이름 결정 및 프로젝트 유형 선택. 팀원과 계정 공유 가능.
3. 대시보드 둘러보기
3.1 테스트 API 키
팀 생성 후 0x 대시보드로 이동 → 라이브 API 키 생성/관리, 빌드 리소스 검색, 지원 요청 가능.
지원 네트워크 목록은 0x 치트시트 참조.
대시보드에 포함된 테스트 API 키로 샘플 요청 가능. 예시:
# Replace the API key in the header with your sample key
curl --location --request GET 'https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber' --header '0x-api-key: [api-key]'3.2 앱 생성
Create an app 클릭 → 라이브 API 키로 0x 제품 접근 가능.
팝업에서 앱 이름 입력 및 활성화할 0x 제품(Swap API, Orderbook API) 선택 → Continue 클릭.
참고: 앱 생성 후에도 이 키가 잠금 해제할 0x 제품 업데이트 가능.
3.3 0x Explorer 태그 추가
0x Explorer에서 앱의 트랜잭션 데이터 식별용 고유 태그 추가 가능. 모든 앱에 동일 태그 사용 또는 각각 별도 태그 생성.
0x Explorer는 0x API를 경유하는 ERC-20 트랜잭션 데이터 제공. 개발자/사용자가 트랜잭션 검증 및 온체인 활동 분석을 지원하는 투명한 도구.
0x Explorer 태그에 대해 자세히 알아보기.
나중에 추가 가능.
3.4 API 키 노출
최종 화면에서 API 키 복사. 이 키는 앱에 고유하며 공유 불가. 추가 키 생성 가능.
이 키로 0x에서 요청 인증. 요청 시 0x-api-key 헤더 매개변수로 키 지정 필수:
# Replace the API key in the header with your sample key
curl --location --request GET 'https://api.0x.org/swap/v1/quote?buyToken=DAI&sellToken=ETH&sellAmount=100000&excludedSources=Kyber' --header '0x-api-key: [api-key]'4. 앱 관리
메인 대시보드에서 생성된 모든 앱 확인 가능.
앱 클릭 시 세부 정보 표시:
1. 활성화된 0x 제품 (Swap API, Orderbook API) 확인
2. API 키 탭에서 해당 앱의 모든 키 확인/생성/삭제. Settings에서 제품 활성화 변경, 0x Explorer 태그 설정, 앱 이름 변경.
3. 0x Explorer 태그 설정 시 해당 앱 관련 온체인 데이터/트랜잭션 조회 가능.
4. 빌드 리소스 조회.
5. 계정 관리
오른쪽 상단 계정 아바타에서 추가 설정 가능.
- Settings: 전체 이름, 팀 이름, 계정 이메일 확인 및 비밀번호 변경
- Contact Support: 문의 가능
- Docs: 개발자 문서로 이동
- Help: 자주 묻는 질문 및 지원 센터 확인
- 0x Explorer: 0x Explorer 태그 설정 시 앱의 온체인 활동/트랜잭션 분석 가능. 자세히 알아보기.
6. 질문?
0x 대시보드 로그인 상태에서 대시보드 우측 하단 Intercom 메신저로 개발자 지원팀 직접 문의 가능.
7. 빌드 시작
라이브 API 키 확보 → 빌드 리소스 탐색 및 구축 시작!
0x 소개
팁
영상 시청 선호 시 0x 개념 영상으로 이동.
0x란?
0x는 크립토 기반 금융 제품 구축을 위한 원스톱 샵. 0x는 수백 명의 개발자에게 필수 웹3 도구 제공 → 더 빠른 거래, 더 나은 가격, 최고의 UX 실현.
5200만 건 이상의 트랜잭션, 600만 명 이상의 사용자가 거래한 1250억 달러 이상의 거래량 처리 (Coinbase Wallet, Robinhood Wallet, Metamask, Zerion, Zapper 등 앱에서).
팁
ELI5 0x (5살에게 설명하듯 이해하기)
0x는 사람들이 장난감, 사탕, 스티커 대신 암호화폐와 같은 디지털 자산을 거래하는 큰 놀이터. 이 놀이터에는 두 종류의 사람이 있음: 거래할 자산을 가져오는 사람(메이커)과 그 자산을 거래하고자 하는 사람(테이커). 0x는 이들이 안전하고 공정하게 거래할 수 있도록 서로를 찾아줌. 어른이 놀이터를 지켜보며 모두가 잘 놀도록 하는 것과 비슷.
0x 생태계
0x 기술 스택
0x의 프로페셔널급 API는 보안 감사된 스마트 컨트랙트 모음인 0x 프로토콜 기반 구축. 이 도구로 구축하는 애플리케이션은 0x 생태계의 일부.
아래 다이어그램은 0x 생태계 개요 표시: 유동성을 공급하는 애플리케이션(메이커), 유동성을 요구하는 애플리케이션(테이커).
메이커와 테이커
0x 생태계 내 메이커/테이커 양면 존재:
공급 (메이커)
0x 주문 생성 후 수요 측(테이커)이 사용할 수 있도록 시스템에 유동성 제공하는 주체. 0x는 다음 소스에서 유동성 집계:
- 온체인 유동성: DEX, AMM (예: Uniswap, Curve, Bancor)
- 오프체인 유동성: 프로페셔널 마켓 메이커, 0x 오픈 오더북 네트워크
- 관련 문서:
- 마켓 메이커 - 리밋 오더 기반 전문 마켓 메이킹
- 오더북 API - 리밋 오더 공유
- 리밋 오더 (고급 트레이더) - 리밋 오더 체결/관리
수요 (테이커)
메이커 자산을 원하는 주체. 테이커는 자신의 자산을 메이커 자산으로 교환하는 데 동의 → 0x 유동성 소비. 예시: MetaMask, Coinbase, dydx 프로젝트.
- 관련 문서:
- 스왑 API - ERC20 토큰의 가장 효율적인 유동성 집계기 (단일 API 접근)
0x 작동 방식?
0x 주문 실행 과정:
- 메이커가 0x 주문 생성 → 표준 주문 메시지 형식의 JSON 객체 (0x 주문 유형 전체 목록 참조). 교환할 자산 유형 표시 (ERC20 fungible 토큰, ERC721 non-fungible 토큰, ERC1155 자산 번들 가능).
- 주문 해시 생성 → 메이커가 주문에 전자 서명하여 암호학적으로 약속.
- 주문을 상대방과 공유:
- 메이커가 원하는 상대방을 이미 알 경우 직접 전송 (이메일, 채팅, OTC 플랫폼)
- 알지 못하는 경우 오더북에 주문 제출
- 0x API가 모든 공급 소스에서 유동성 집계 → 테이커에게 최적가 제공.
0x는 오프체인 릴레이 & 온체인 정산 패러다임으로 0x 주문 생성/검색/체결 지원.
→ 0x는 블록체인에 주문 저장 안 함; 오프체인 저장 후 정산만 온체인에서 수행 → 개발자에게 유연하고 가스 효율적인 DEX 프로토콜. - 테이커가 0x 주문 체결 → 블록체인에 주문 및 체결 금액 제출.
- 0x 프로토콜 정산 로직이 메이커의 전자 서명 검증 및 거래 조건 충족 여부 확인.
충족 시 메이커↔테이커 간 자산 원자적 스왑 수행. 불충족 시 거래 취소.
0x 위에 뭘 구축할 수 있을까?
0x 위에 구축된 비독점적 프로젝트 목록. 교환이 핵심 목적이 아닌 기존 앱에도 통합 가능. 추가 예시는 블로그 포스트 참조.
수요 (테이커)
- 거래소: Y 마켓에서 X 자산의 탈중앙화 거래소, 디지털 상품의 eBay형 마켓플레이스, OTC 트레이딩 데스크
- 지갑: 토큰 교환을 원하는 사용자의 디지털 지갑
- 옵션/파생상품 플랫폼: 유동성/교환을 필요로 하는 DeFi 프로토콜 (파생상품, 대출, 옵션 등)
- 포트폴리오 매니저
- 예측 시장
- NFT 거래소: NFT 마켓플레이스, 인게임 통화/아이템 게임
- 투자 전략 (예: DeFi 인덱스 펀드, DCA 앱)
- 데이터: 0x 멀티체인 분석 포털, GraphQL 래퍼 포함 실시간 거래 패널
공급 (메이커)
- 오더북 모델
- AMM 모델
- 마켓 메이커: 마켓 메이킹/차익거래 트레이딩 봇
가이드
이 페이지는 사용 사례에 따라 0x 구축을 시작하는 인기 가이드 나열
스왑 API
단일 API로 앱에 유동성 집계 추가. 100개 이상 거래소 및 수천 개 토큰 접근.
코드 예시
- (Next.js) 0x 데모 앱 - 0x Swap API, Next.js, ConnectKit로 만든 ERC20 스왑 앱 예시
- (HTML, CSS, Javascript) 0x 데모 앱
- 0x 스타터 프로젝트 - 실행 가능한 예시 모음으로 0x v4 프로토콜 시연
튜토리얼
- 스왑 API 사용법 - ERC20 토큰 거래 프로그래밍 실행법 안내
- Next.js, 0x, ConnectKit로 토큰 스왑 dApp 구축 - 토큰 스왑 dApp 구축 시 핵심 개발 개념 영상
- 0x API로 토큰 스왑 dApp 구축 - Swap API 사용한 Matcha.xyz 유사 dApp 구축 방법 (글 및 영상)
- 스마트 컨트랙트에서 0x API 유동성 사용 - 스마트 컨트랙트 내 0x API 스왑 견적 사용법 안내
- 테스트넷 작업 - Goerli 테스트넷 사용 또는 Ethereum 메인넷을 자체 테스트넷으로 포크하여 ERC20 토큰 스왑 테스트하는 두 가지 방법 (실행 가능한 예시 포함)