거래소 테스트넷

테스트넷 거래소에서 거래하기: 인증하고, 키를 발급하고, 합성 USDX를 받고, 주문을 제출합니다.

Nexus Exchange는 nexus.xyz/trade에서 테스트넷으로 가동 중입니다.

API를 통해 인증하고, 주문을 제출하고, 가동 중인 무기한 선물 시장에서 거래할 수 있습니다.

프런트엔드는 실시간 거래소 상태를 읽기 전용으로 보여 줍니다. 모든 거래는 REST 및 WebSocket API를 통해 이루어집니다.

전체 API 문서는 이 문서의 API 레퍼런스 섹션에 있습니다.

시작하기

1. 인증

Ethereum 지갑으로 EIP-191 개인 서명을 해서 로그인합니다.

POST /auth/login

"Sign in to Nexus Exchange" 메시지에 서명하면 세션 토큰(TTL 24시간)을 받습니다. 처음 로그인하면 계정이 생성됩니다.

2. API 키 생성

POST /keys

이 호출은 HMAC 키 쌍(key_id + secret)을 반환합니다. 시크릿은 한 번만 표시되므로 즉시 저장하십시오.

키는 GET /keys(목록 조회)와 DELETE /keys/{key_id}(폐기)로 관리합니다.

3. 계정에 자금 넣기

포셋에서 합성 USDX를 받아 테스트넷 계정에 충전합니다.

POST /account/credit

주문을 제출하려면 USDX 잔액이 있어야 합니다. 잔액은 언제든지 GET /account로 확인할 수 있습니다.

각 API 키는 하루에 최대 500 테스트 USDX를 받을 수 있습니다.

4. 주문 제출

모든 거래 요청은 X-API-Key, X-Timestamp, X-Signature 세 개의 헤더로 인증합니다.

POST /orders

{
  "market_id": "BTC-USDX-PERP",
  "side": "Buy",
  "order_type": "Limit",
  "price": "67000",
  "quantity": "0.01",
  "time_in_force": "GTC"
}

전체 인증 예시와 사용 가능한 모든 엔드포인트는 API 레퍼런스 섹션을 참조하십시오.

시장

USDX로 표시되는 세 개의 암호화폐 무기한 선물이 가동 중입니다.

시장	기초 자산
BTC-USDX-PERP	Bitcoin
ETH-USDX-PERP	Ether
SOL-USDX-PERP	Solana

시장은 상장과 상장폐지에 따라 달라집니다. 현재 가동 중인 시장은 GET /markets로, 통계를 포함한 목록은 GET /markets/summary로 조회하십시오. 이후 추가될 자산군은 자산 목록을 참조하십시오.

거래소 텔레메트리

거래소 전체의 집계 텔레메트리는 API로 제공됩니다. 이 엔드포인트는 공개되어 있으며 API 키가 필요하지 않습니다.

엔드포인트	반환 내용
GET /stats	롤링 고유 트레이더 수를 포함한 거래소 스냅샷
GET /stats/history	시간에 따른 처리량 샘플
GET /stats/volume	누적 거래 명목 가치(거래소 전체 및 시장별)
GET /stats/open-interest	롱과 숏을 따로 보고하는 미결제약정
GET /stats/balance-distribution	잔액 구간별 계정 수

이 엔드포인트들은 모두 구조상 계정별 데이터를 포함하지 않는다고 문서화되어 있으며, 그래서 공개되어 있습니다. 응답 형태와 부호 및 단위 관련 주의 사항은 거래소 통계를 참조하십시오. 특히 미결제약정은 양쪽을 따로 보고하며, gross_oi_two_sided_quote는 한쪽 수치의 두 배입니다.

현재 프로덕션 프런트엔드에는 공개 분석 대시보드가 없습니다. 위의 엔드포인트를 사용하십시오.