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.
Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.Ver versão em inglês →
Raydium Perps é uma implementação com marca branca na Orderly Network. O livro de ordens, o mecanismo de correspondência e o estado da conta residem na Orderly. O Raydium SDK v2 (
@raydium-io/raydium-sdk-v2) não cobre perps — para acesso programático, use a API REST + WebSocket da Orderly diretamente. Os trechos abaixo mostram os fluxos mais comuns; a referência canônica está em orderly.network/docs.Banner de versão.
- Backend: API REST + WebSocket da Orderly Network
- Schema de trecho verificado contra a API da Orderly a partir de 2026-04
- Cluster Solana para depósitos on-chain:
mainnet-beta - Assinatura: Solana ed25519 sobre o payload estilo EIP-712 da Orderly (Orderly usa um schema EIP-712 até para cadeias não-EVM; veja a documentação da Orderly para a lista de campos mais recente)
O que há nesta página
Os fluxos abaixo cobrem o ciclo de vida relevante para o integrador:- Configuração de conta — depositar USDC e registrar a conta com a Orderly.
- Chamadas REST autenticadas — solicitar assinatura para colocação de ordens, cancelamento e consultas de conta.
- Negociação — colocação de ordens de mercado / limite, cancelamento, busca de posições e preenchimentos.
- Dados de mercado — inscrição no livro de ordens e WebSocket de negociações.
- Saque — iniciar um saque de volta para a carteira.
@solana/web3.js e tweetnacl para assinatura Ed25519. Eles são pontos de partida — a superfície da API da Orderly é ampla e muda mais rápido do que esta página; sempre verifique a documentação ao vivo da Orderly antes de colocar código de produção em funcionamento.
Configuração
Registro de conta
Antes de colocar qualquer ordem, registre a carteira com a Orderly:(broker_id, wallet_address) — o registro é idempotente. Se uma carteira já se registrou com o broker Raydium, a chamada retorna o mesmo ID de conta sem criar um novo.
Depositar USDC
Os depósitos movem USDC do ATA da carteira para o cofre de liquidação da Orderly. Eles são transações Solana on-chain:/v1/client/holding para confirmar:
orderlyAuthGet é definido abaixo — toda chamada autenticada passa por ela.)
Auxiliar de assinatura de solicitação
Toda chamada REST autenticada para Orderly carrega uma assinatura Ed25519 sobre(timestamp + method + path + body):
timestamp mais de 5 segundos fora do relógio do servidor são rejeitadas. Sincronize seu relógio (NTP) e evite assinar solicitações com antecedência.
Colocar uma ordem de mercado
order_id resultante mais um status. Os preenchimentos chegam sobre o WebSocket (veja abaixo); a própria resposta REST não bloqueia até estar totalmente preenchida.
Colocar uma ordem limitada com Post-Only
IOC / FOK, defina time_in_force: "IOC" ou "FOK". Veja products/perps/order-types para a semântica de cada flag.
Cancelar uma ordem
/v1/orders ou observando o WebSocket — assumir que um cancelamento foi bem-sucedido sem confirmação pode levar a posições duplicadas ou não intencionais.
Buscar posições abertas
position_qty negativa é uma posição curta, positiva é uma posição longa. position_qty == 0 significa que a posição está fechada, mas a linha pode ainda aparecer até a próxima limpeza.
Buscar histórico de preenchimentos
page e size para paginar.
WebSocket: dados de mercado
subscribe assinado da mesma forma que as solicitações REST, com escopo para seu ID de conta. A documentação da Orderly tem o shape do payload exato; ela muda ocasionalmente, então não faça hardcode de um schema particular aqui.
Sacar USDC
products/perps/fees). A transferência on-chain acontece em 1–2 minutos em condições normais; espere mais tempo durante congestionamento.
Armadilhas
- Não reutilize a chave de negociação entre ambientes. Uma única chave de negociação Orderly registrada em sua carteira é associada a uma conta mainnet Solana. Se você também precisa de devnet ou staging, gere uma chave separada para cada.
- Sincronização de tempo. A tolerância de desvio de relógio da Orderly é apertada (±5s). Em serviços de longa duração, a deriva de NTP eventualmente quebrará a assinatura. Ressincronize periodicamente.
- Reconexões do WebSocket. O WS público ocasionalmente cai durante atualizações da Orderly. Implemente backoff exponencial e reinscreva-se na reabertura.
- Limites de taxa. Chamadas REST são limitadas por taxa por conta. Use
cancel_allpara cancelamento em massa em vez de fazer loop comcancel-por-id quando você tem >5 ordens para cancelar. - Direção de posição é implícita. Uma ordem
BUYemPERP_SOL_USDCabre ou estende uma posição longa; uma ordemSELLabre ou estende uma posição curta — mas se você já está comprado, umaSELLreduz (e pode inverter) a posição porque Raydium Perps está em modo unidirecional. Sempre verifique a posição atual antes de colocar uma ordem se a direção importa. - Financiamento e liquidações são separados do fluxo de ordens. Pagamentos de financiamento e liquidações aparecem como streams de eventos separados; eles não são “ordens”. Inscreva-se nos tópicos privados relevantes do WS se precisar observá-los.
Próximos passos
products/perps/trading-basics— o guia conceitual sobre mecânicas de perpetuais.products/perps/order-types— a semântica de cada tipo de ordem e flag.products/perps/collateral— ativos de colateral suportados e limites por cadeia.products/perps/fees— tabelas maker/taker e taxa de saque.
- Documentação do desenvolvedor Orderly Network — referência canônica para a superfície da API usada acima. Raydium Perps consome isto diretamente.
- SDK TypeScript Orderly — envolve a mesma camada REST/WebSocket com auxiliares tipados; útil se você quiser pular escrever a camada de assinatura você mesmo.


