API 및 요청 한도

REST 및 WebSocket 게이트웨이: 기본 URL, 인증, 요청 한도 모델.

Nexus Exchange는 API 우선으로 설계되었습니다. 트레이더가 할 수 있는 모든 작업(계정 자금 입금, 주문 제출 및 취소, 포지션 조회, 오더북 스트리밍)을 REST와 WebSocket으로 이용할 수 있습니다. 웹 프런트엔드는 읽기 전용 화면이며, 프로그래밍 방식의 접근이 주된 인터페이스입니다.

기본 URL

https://api.testnet.nexus.xyz/v1

이것은 퍼블릭 테스트넷의 기본 URL입니다. 2026-09-28 확인 당시 API 경로에서 HTTP 500을 반환한 https://exchange.nexus.xyz/api/exchange를 대체합니다. 메인넷은 https://api.nexus.xyz/v1로 계획되어 있으며, 이 호스트는 아직 DNS에서 해석(resolve)되지 않습니다. 기계 판독 가능한 OpenAPI 사양은 /openapi.json에서 제공되고 nexus-xyz/nexus-exchange-api에서 버전 관리되며, 릴리스는 GitHub Releases에서 추적됩니다.

인증 모델

자격 증명에는 두 가지 유형이 있습니다.

세션 토큰(Bearer). Ethereum 지갑으로 고정된 메시지에 서명(EIP-191)하여 생성합니다. API 키를 생성하고 관리하는 데만 사용되며, 거래에는 절대 사용되지 않습니다. 24시간 후 만료됩니다.
API 키(HMAC). key_id + secret 쌍입니다. 모든 거래 및 계정 요청은 정규 요청 문자열에 대한 HMAC-SHA256으로 서명됩니다. 시크릿은 생성 시 한 번만 표시되며 이후에는 다시 조회할 수 없습니다.

1. POST /auth/login   (wallet signature)        → session Bearer token
2. POST /keys         (Bearer)                   → API key_id + secret
3. sign each request  (HMAC over canonical str)  → trade

실행 가능한 cURL을 포함한 전체 흐름은 빠른 시작을 참조하십시오.

CCXT

CCXT 및 CCXT-Pro 호환은 거래소 API가 명시한 목표이며, 아직 구축 및 테스트 중입니다. OpenAPI 사양에서 CCXT 통합 메서드에 대응하는 각 작업(주문 제출 포함)에는 x-ccxt-method 주석이 붙어 있습니다.

레퍼런스

빠른 시작: 첫 거래
REST API 레퍼런스
WebSocket API 레퍼런스
요청 및 연결 한도
API 버전 관리

상태: 테스트넷 프리뷰. 자격 증명, 세션, 요청 한도 상태가 아직 게이트웨이 재시작 시 유지되지 않으므로, API 키는 다시 생성할 수 있는 것으로 취급하십시오. 프로덕션 강화 작업이 진행 중입니다.

이전파라미터 변경

다음거래소 REST

마지막 업데이트 10일 전