Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.Xem bản tiếng Anh →
Raydium Perps là một triển khai có nhãn hiệu trên Orderly Network. Sổ lệnh, công cụ khớp lệnh và trạng thái tài khoản đều nằm trên Orderly. SDK Raydium v2 (
@raydium-io/raydium-sdk-v2) không hỗ trợ perps — để truy cập lập trình, hãy dùng REST + WebSocket API của Orderly trực tiếp. Các đoạn mã dưới đây thể hiện những luồng phổ biến nhất; tài liệu chính thức nằm tại orderly.network/docs.Banner phiên bản.
- Backend: Orderly Network REST + WebSocket API
- Schema đoạn mã được xác minh với API của Orderly tính đến tháng 04/2026
- Cụm Solana để gửi trên chuỗi:
mainnet-beta - Ký: Ed25519 của Solana trên payload theo kiểu EIP-712 của Orderly (Orderly sử dụng schema EIP-712 ngay cả với các chuỗi không phải EVM; xem tài liệu Orderly để có danh sách trường mới nhất)
Nội dung của trang này
Các luồng dưới đây bao gồm vòng đời liên quan đến nhà tích hợp:- Thiết lập tài khoản — gửi USDC và đăng ký tài khoản với Orderly.
- Các lệnh REST được xác thực — yêu cầu ký để đặt lệnh, hủy lệnh và truy vấn tài khoản.
- Giao dịch — đặt lệnh thị trường/giới hạn, hủy lệnh, lấy vị thế và lịch sử lệnh.
- Dữ liệu thị trường — đăng ký kênh WebSocket của sổ lệnh và giao dịch.
- Rút tiền — bắt đầu rút tiền về ví.
@solana/web3.js và tweetnacl để ký Ed25519. Chúng là điểm khởi đầu — API của Orderly rất rộng và thay đổi nhanh hơn trang này; luôn kiểm tra tài liệu trực tiếp của Orderly trước khi triển khai mã sản xuất.
Thiết lập
Đăng ký tài khoản
Trước khi đặt lệnh nào, hãy đăng ký ví với Orderly:(broker_id, wallet_address) — đăng ký là idempotent. Nếu ví đã đăng ký với broker của Raydium, lệnh gọi sẽ trả về cùng một ID tài khoản mà không tạo ID mới.
Gửi USDC
Các lần gửi di chuyển USDC từ ATA ví đến kho bảo quản kế toán của Orderly. Chúng là các giao dịch Solana trên chuỗi:/v1/client/holding để xác nhận:
orderlyAuthGet được định nghĩa dưới đây — mọi lệnh gọi được xác thực đều đi qua nó.)
Trợ giúp ký yêu cầu
Mọi lệnh gọi REST được xác thực tới Orderly đều mang chữ ký Ed25519 trên(timestamp + method + path + body):
timestamp chênh lệch từ đồng hồ máy chủ hơn 5 giây sẽ bị từ chối. Đồng bộ đồng hồ của bạn (NTP) và tránh ký yêu cầu trước.
Đặt lệnh thị trường
order_id kết quả cùng với trạng thái. Các lệnh thực hiện đến qua WebSocket (xem bên dưới); phản hồi REST chính nó không chặn cho đến khi hoàn toàn lấp đầy.
Đặt lệnh giới hạn với Post-Only
IOC / FOK, đặt time_in_force: "IOC" hoặc "FOK". Xem products/perps/order-types để hiểu ngữ nghĩa của mỗi cờ.
Hủy lệnh
/v1/orders hoặc xem WebSocket — giả định lệnh hủy thành công mà không xác nhận có thể dẫn đến vị thế trùng lặp hoặc không mong muốn.
Lấy vị thế mở
position_qty âm là short, dương là long. position_qty == 0 có nghĩa vị thế bị đóng nhưng hàng vẫn có thể xuất hiện cho đến lần dọn dẹp tiếp theo.
Lấy lịch sử lệnh thực hiện
page và size để phân trang.
WebSocket: dữ liệu thị trường
subscribe được ký theo cách tương tự như yêu cầu REST, có phạm vi cho ID tài khoản của bạn. Tài liệu của Orderly có hình dạng payload chính xác; nó thay đổi thỉnh thoảng, vì vậy đừng hard-code một schema cụ thể ở đây.
Rút USDC
products/perps/fees). Chuyển tiền trên chuỗi xảy ra trong vòng 1–2 phút trong điều kiện bình thường; dự kiến sẽ lâu hơn trong thời gian tắc nghẽn.
Những cạm bẫy
- Đừng tái sử dụng khóa giao dịch trên các môi trường. Một khóa giao dịch Orderly duy nhất được đăng ký với ví của bạn được liên kết với một tài khoản mainnet Solana. Nếu bạn cũng cần devnet hoặc staging, hãy tạo khóa riêng cho mỗi khóa.
- Đồng bộ thời gian. Dung sai chênh lệch đồng hồ của Orderly rất chặt (±5 giây). Trên các dịch vụ chạy lâu dài, độ trôi NTP cuối cùng sẽ phá vỡ việc ký. Đồng bộ định kỳ.
- Kết nối lại WebSocket. WebSocket công khai thỉnh thoảng đóng kết nối khi nâng cấp Orderly. Triển khai thoái lui theo cấp số nhân và tái đăng ký khi mở lại.
- Giới hạn tỷ lệ. Các lệnh gọi REST bị giới hạn tỷ lệ phân tầng theo tài khoản. Hủy hàng loạt qua
cancel_allthay vì vòngcancel-by-id khi bạn có >5 lệnh để hủy. - Hướng vị thế là ngầm. Lệnh
BUYtrênPERP_SOL_USDCmở hoặc mở rộng một long; lệnhSELLmở hoặc mở rộng một short — nhưng nếu bạn đã ở long, lệnhSELLsẽ giảm (và có thể lật) vị thế vì Raydium Perps ở chế độ một chiều. Luôn kiểm tra vị thế hiện tại trước khi đặt lệnh nếu hướng quan trọng. - Tài trợ và thanh lý tách biệt với luồng lệnh. Các khoản thanh toán tài trợ và thanh lý xuất hiện dưới dạng các luồng sự kiện riêng biệt; chúng không phải “lệnh”. Đăng ký các chủ đề WS riêng tư liên quan nếu bạn cần quan sát chúng.
Tiếp theo đi đâu
products/perps/trading-basics— bước khởi đầu về khái niệm cơ chế perpetual.products/perps/order-types— ngữ nghĩa của mỗi loại lệnh và cờ.products/perps/collateral— tài sản thế chấp được hỗ trợ và giới hạn cho mỗi chuỗi.products/perps/fees— lịch maker/taker và phí rút tiền.
- Tài liệu nhà phát triển Orderly Network — tài liệu tham khảo chính thức cho API được sử dụng ở trên. Raydium Perps sử dụng trực tiếp.
- SDK TypeScript Orderly — bao bọc cùng một lớp REST/WebSocket với các trợ giúp được nhập; hữu ích nếu bạn muốn bỏ qua việc viết lớp ký cho riêng mình.


