이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
Raydium Perps는 Orderly Network의 화이트라벨 배포입니다. 오더북, 매칭 엔진, 계정 상태 모두 Orderly에 존재합니다. Raydium SDK v2 (
@raydium-io/raydium-sdk-v2)는 perps를 다루지 않습니다. 프로그래매틱 접근을 위해서는 Orderly의 REST + WebSocket API를 직접 사용하세요. 아래 스니펫은 가장 흔한 흐름들을 보여주며, 정확한 참고자료는 orderly.network/docs에 있습니다.버전 배너.
- 백엔드: Orderly Network REST + WebSocket API
- 스니펫 스키마는 2026-04 기준 Orderly API에 대해 검증됨
- 온체인 입금용 Solana 클러스터:
mainnet-beta - 서명: Orderly EIP-712 스타일 페이로드에 대한 Solana ed25519 (Orderly는 비-EVM 체인에도 EIP-712 스키마 사용; 최신 필드 목록은 Orderly 문서 참조)
이 페이지의 내용
아래 흐름은 통합자 관련 라이프사이클을 다룹니다:- 계정 설정 — USDC 입금 및 Orderly에 계정 등록.
- 인증된 REST 호출 — 주문 배치, 취소 및 계정 조회를 위한 서명 요청.
- 트레이딩 — 마켓/리밋 주문 배치, 취소, 포지션 및 체결 조회.
- 마켓 데이터 — 오더북 및 트레이드 WebSocket 구독.
- 출금 — 지갑으로의 출금 시작.
@solana/web3.js 및 Ed25519 서명을 위한 tweetnacl이 포함된 Node.js + TypeScript를 대상으로 합니다. 이들은 출발점입니다 — Orderly의 API 표면은 넓고 이 페이지보다 빠르게 변합니다. 프로덕션 코드를 배포하기 전에 항상 Orderly의 최신 문서를 확인하세요.
설정
계정 등록
주문을 배치하기 전에 지갑을 Orderly에 등록하세요:(broker_id, wallet_address) 쌍당 결정론적입니다. 등록은 멱등입니다. 지갑이 이미 Raydium의 브로커에 등록되어 있으면 호출은 새로 생성하지 않고 같은 계정 ID를 반환합니다.
USDC 입금
입금은 지갑 ATA에서 Orderly의 정산 볼트로 USDC를 이동시킵니다. 이들은 온체인 Solana 트랜잭션입니다:/v1/client/holding을 조회하여 확인하세요:
orderlyAuthGet는 아래에서 정의됩니다. 모든 인증된 호출은 이를 통합니다.)
요청 서명 헬퍼
Orderly에 대한 모든 인증된 REST 호출은(timestamp + method + path + body)에 대한 Ed25519 서명을 전달합니다:
timestamp를 가진 요청은 거부됩니다. 시계를 동기화하세요 (NTP) 그리고 요청을 미리 서명하지 마세요.
마켓 주문 배치
order_id와 상태를 반환합니다. 체결은 WebSocket을 통해 옵니다 (아래 참조); REST 응답 자체는 완전히 체결될 때까지 차단하지 않습니다.
Post-Only를 사용한 리밋 주문 배치
IOC / FOK의 경우 time_in_force: "IOC" 또는 "FOK"를 설정하세요. 각 플래그의 의미는 products/perps/order-types를 참조하세요.
주문 취소
/v1/orders를 폴링하거나 WebSocket을 감시하여 조정하세요. 확인 없이 취소 성공을 가정하면 중복 또는 의도하지 않은 포지션이 발생할 수 있습니다.
오픈 포지션 조회
position_qty는 숏, 양수는 롱입니다. position_qty == 0은 포지션이 닫혔지만 다음 정리까지 행이 여전히 표시될 수 있음을 의미합니다.
체결 이력 조회
page 및 size 쿼리 매개변수를 사용하여 페이지 매김하세요.
WebSocket: 마켓 데이터
subscribe 페이로드를 보내세요. Orderly의 문서에 정확한 페이로드 형태가 있습니다; 이는 가끔 변하므로 여기에서 특정 스키마를 하드코딩하지 마세요.
USDC 출금
products/perps/fees 참조). 온체인 전송은 정상 상황에서 1-2분 이내에 발생합니다; 혼잡 중에는 더 오래 걸릴 것으로 예상하세요.
함정
- 환경 간에 트레이딩 키를 재사용하지 마세요. 지갑에 대해 등록된 단일 Orderly 트레이딩 키는 하나의 Solana 메인넷 계정과 연결됩니다. devnet이나 스테이징도 필요하면 각각을 위해 별도의 키를 생성하세요.
- 시간 동기화. Orderly의 클럭 스큐 허용 오차는 타이트합니다 (±5초). 오래 실행되는 서비스에서는 NTP 드리프트가 결국 서명을 깨뜨릴 것입니다. 주기적으로 재동기화하세요.
- WebSocket 재연결. 공개 WS는 Orderly 업그레이드 중에 가끔 연결을 끊습니다. 지수 백오프를 구현하고 재개시 재구독하세요.
- 속도 제한. REST 호출은 계정당 티어 속도 제한됩니다. >5개 주문을 취소할 때
cancel-by-id 루핑보다cancel_all을 통해 대량 취소하세요. - 포지션 방향은 암묵적입니다.
PERP_SOL_USDC에 대한BUY주문은 롱을 열거나 연장합니다;SELL은 숏을 열거나 연장합니다 — 하지만 이미 롱이면SELL은 감소합니다 (그리고 뒤집을 수 있습니다) 왜냐하면 Raydium Perps는 편방향 모드이기 때문입니다. 방향이 중요하면 주문을 배치하기 전에 항상 현재 포지션을 확인하세요. - 펀딩 및 청산은 주문 흐름과 분리되어 있습니다. 펀딩 지불 및 청산은 별도의 이벤트 스트림으로 표시됩니다; 이들은 “주문”이 아닙니다. 이를 관찰해야 하면 관련 private WS 토픽을 구독하세요.
다음으로
products/perps/trading-basics— 영구 선물 메커니즘의 개념적 입문서.products/perps/order-types— 각 주문 타입 및 플래그의 의미.products/perps/collateral— 지원되는 담보 자산 및 체인당 제한.products/perps/fees— 메이커/테이커 일정 및 출금 수수료.
- Orderly Network 개발자 문서 — 위에서 사용된 API 표면의 정확한 참고자료. Raydium Perps는 이를 직접 사용합니다.
- Orderly TypeScript SDK — 같은 REST/WebSocket 계층을 타입된 헬퍼로 래핑합니다; 서명 계층을 직접 작성하기를 건너뛰고 싶으면 유용합니다.

