Ordens Retail Price Improvement (RPI) da Bitget
[Tempo estimado de leitura: 5 minutos]
A ordem Retail Price Improvement (RPI) é um tipo de ordem especial disponível no modelo de conta de trading unificada. Ela foi projetada para aumentar a liquidez, combinando apenas ordens não algorítmicas (ou seja, ordens não enviadas via OpenAPI). Este tipo de ordem oferece às ordens de varejo qualificadas melhores preços de execução, alcançando melhoria de preço e reduzindo a derrapagem.
Mecanismos centrais das ordens RPI
1. Lógica de correspondência: as ordens RPI correspondem exclusivamente a ordens não algorítmicas. Eles não operam contra ordens enviadas via OpenAPI.
2. Tipo de ordem: todas as ordens RPI são ordens passivas e se enquadram na categoria de ordens de maker. Elas só executam contra ordens de takers, adicionando assim liquidez ao livro de ordens.
3. Prioridade de execução: no mesmo nível de preço, as ordens RPI têm uma prioridade de execução inferior em comparação com as ordens que não são RPI (neste artigo chamaremos estas ordens de “ordens não RPI”), independentemente da data em que foram enviadas. As ordens RPI a um determinado nível de preço só serão executadas após todas as ordens não RPI nesse mesmo preço serem completamente executadas.
Como enviar uma ordem RPI
1. As ordens RPI podem ser enviadas por meio da API REST ou da API WebSocket. A ordem deve ser definida para limitar com timeInForce = rpi.
2. Apenas os parceiros market makers designados podem enviar ordens RPI. Se um market maker não autorizado tentar enviar uma ordem, receberá a seguinte mensagem de erro: “Sua conta não está autorizada a enviar ordens RPI para este instrumento.”
Regras de trading de ordens RPI
1. As ordens RPI são suportadas nos modos de margem isolada e margem cruzada na conta de trading unificada. Elas estão disponíveis para trading nos mercados de futuros, spot e de margem.
2. As ordens RPI não são suportadas no trading pré-mercado. Elas só podem ser enviadas após o término do leilão por chamamento; caso contrário, a ordem será rejeitada.
3. A lógica de validação para ordens RPI é a mesma que para ordens limitadas comuns. Os requisitos relativos à margem, aos tamanhos mínimo e máximo das ordens e aos limites de posições abertas (OI) são idênticos aos aplicáveis às ordens limitadas padrão.
4. Limites de preço para ordens RPI
a. Para futuros:
• Ordem de compra: preço de referência × 110% ≥ Preço da ordem RPI ≥ Preço de referência × 50%
• Ordem de venda: preço de referência × 150% ≥ Preço da ordem RPI ≥ Preço de referência × 90%
b. Para spot e margem:
• Ordem de compra: último preço operado × 110% ≥ Preço da ordem RPI ≥ último preço operado × 70%
• Ordem de venda: último preço operado × 130% ≥ Preço da ordem RPI ≥ último preço operado × 90%
Observação: os limites (50%, 90%, 110%, 150%) fornecidos acima são apenas para referência. Esses parâmetros são configuráveis por par de trading, e a plataforma reserva-se o direito de ajustá-los com base nas condições do mercado.
5. As ordens RPI suportam a envio em lote, a modificação de ordens (incluindo preço e quantidade) e o cancelamento.
6. As ordens RPI não podem ser utilizadas em conjunto com ordens de estratégia (tais como ordens de stop loss, take profit ou ordens limitadas de stop loss).
7. As ordens RPI não podem ser executadas contra ordens que não são RPI do lado oposto. Quando o lado oposto for composto exclusivamente por ordens RPI, as operações ainda poderão ser executadas; no entanto, ordens RPI não serão combinadas entre si.
8. As oscilações do mercado podem fazer com que as ordens de compra RPI tenham preços mais elevados do que a melhor oferta não RPI, ou que as ordens de venda RPI tenham preços mais baixos do que a melhor oferta não RPI. Essas ordens RPI são consideradas inválidas e não serão correspondidas, embora permaneçam no livro de ordens. Elas voltarão a se tornar válidas quando surgirem ordens não RPI com preços mais competitivos.
Exibição da ordem RPI
1. Livro de ordens de API: as ordens RPI são exibidas no livro de ordens de API.
2. Livro de ordens da página de trading: as ordens RPI são exibidas na interface de trading sem quaisquer tags especiais.
Para manter um livro de ordens, as ordens RPI cruzadas (em que o preço de compra é superior ao preço de venda) são ocultadas. Para obter mais detalhes sobre ordens RPI cruzadas, consulte os exemplos abaixo:
Exemplo 1
O livro de ordens é o seguinte:
|
|
Preço |
Quantidade |
|
Oferta de venda 2 |
1.002 |
200 |
|
Oferta de venda 1 |
1.000 (RPI) |
100 |
|
Oferta de compra 1 |
999 (RPI) |
90 |
|
Oferta de compra 2 |
998 |
120 |
• Uma nova ordem RPI de compra a 1.000 é aceita.
• Uma nova ordem RPI de compra a 1.001 é aceita.
• Uma nova ordem RPI de compra a 1.002 é rejeitada, pois existe uma ordem não RPI no nível de oferta de venda 2.
Livro de ordens na página de trading:
Quando há um cruzamento:
• As ordens RPI cruzadas ficam ocultas do livro de ordens na página de trading. No entanto, eles ainda estão ativos no mecanismo do jogo e prontos para serem executados de acordo com as regras.
• As ordens RPI não cruzadas são visíveis sem nenhuma tag especial.
Exemplo 2
O livro de ordens é o seguinte. As ordens RPI cruzadas ficam ocultas e não são executadas entre si.
|
|
Preço |
Quantidade |
É visível? |
|
Oferta de venda 4 |
1.004 |
200 |
Sim |
|
Oferta de venda 3 |
1.003 (RPI) |
150 |
Sim |
|
Oferta de venda 2 |
1.001 (RPI) |
100 |
Não |
|
Oferta de venda 1 |
999 (RPI) |
50 |
Não |
|
Oferta de compra 1 |
1.002 (RPI) |
100 |
Não |
|
Oferta de compra 2 |
1.000 (RPI) |
200 |
Não |
|
Oferta de compra 3 |
999 |
200 |
Sim |
|
Oferta de compra 4 |
996 (RPI) |
300 |
Sim |
Nos dados/fluxo do livro de ordens na API, todas as ordens RPI são excluídas.
OpenAPI e profundidade de dados
1. Profundidade de RPI
1.1 REST
• GET /api/v3/market/rpi-orderbook
• Limite de taxa: 10 solicitações/s
|
Nome do parâmetro |
Tipo de parâmetro |
Resposta à solicitação |
É obrigatório? |
Descrição |
|
categoria
|
Sequência
|
Parâmetro de solicitação
|
Sim
|
Linha de produtos spot Spot usdt-futures Futuros USDT-M coin-futures Futuros Coin-M usdc-futures Futuros USDC-M |
|
símbolo |
Sequência |
Parâmetro de solicitação |
Sim |
Nome do par de trading |
|
limite |
Sequência |
Parâmetro de solicitação |
Não
|
Nível de profundidade spot máximo: 200, padrão: 5 usdt-futures, coin-futures, usdc-futures máximo: 200, padrão: 5 |
|
a |
Matriz
|
Parâmetro de resposta |
/ |
Profundidade de venda • Classificados por preço em ordem crescente |
|
> Index 0 |
Sequência |
Parâmetro de resposta |
/ |
Preço de venda |
|
> Index 1 |
Sequência |
Parâmetro de resposta |
/ |
Quantidade de venda não RPI |
|
> Index 2 |
Sequência |
Parâmetro de resposta |
/ |
Quantidade vendida de RPI |
|
b |
Matriz |
Parâmetro de resposta |
/ |
Profundidade de compra • Classificados por preço em ordem decrescente |
|
> Index 0 |
Sequência |
Parâmetro de resposta |
/ |
Preço de compra |
|
> Index 1 |
Sequência |
Parâmetro de resposta |
/ |
Quantidade de compra não RPI |
|
> Index 2 |
Sequência |
Parâmetro de resposta |
/ |
Quantidade de compra RPI |
|
ts |
Sequência |
Parâmetro de resposta |
/ |
Data e hora do sistema para geração de dados • Marca de data e hora Unix em milissegundos |
1.2 WebSocket
1.2.1 Parâmetros da solicitação
|
Nome do parâmetro |
Tipo |
É obrigatório? |
Descrição |
|
op |
Sequência |
Sim |
Ação subscribe Assinar unsubscribe Cancelar assinatura |
|
args |
List<Object> |
Sim |
Lista de canais para solicitar assinatura |
|
> instType |
Sequência
|
Sim |
Tipo de produto spot Spot usdt-futures Futuros USDT-M coin-futures Futuros Coin-M usdc-futures Futuros USDC-M |
|
> topic |
Sequência
|
Sim
|
Nome do canal rpi-books Canais de todos os níveis rpi-books1 Canais de nível 1 rpi-books5 Canais de nível 5 rpi-books50 Canais de nível 50 |
|
> symbol |
Sequência
|
Sim |
Nome do par de trading Por exemplo: BTCUSDT |
1.2.2 Parâmetros de retorno
|
Parâmetro |
Tipo |
Descrição |
|
event |
Sequência |
Event subscribe Assinar unsubscribe Cancelar assinatura error Erro no parâmetro |
|
arg |
Objeto |
Canais assinados |
|
> instType |
Sequência |
Tipo de produto spot Spot usdt-futures Futuros USDT-M coin-futures Futuros Coin-M usdc-futures Futuros USDC-M |
|
> topic |
Sequência |
Nome do canal rpi-books Canais de todos os níveis rpi-books1 Canais de nível 1 rpi-books5 Canais de nível 5 rpi-books50 Canais de nível 50 |
|
code |
Sequência |
Código de erro |
|
msg |
Sequência |
Mensagem de erro |
1.2.3 Parâmetros de envio
|
Parâmetro |
Tipo |
Descrição |
|
arg |
Objeto |
Canais assinados |
|
> instType |
Sequência
|
Tipo de produto spot Spot usdt-futures Futuros USDT-M coin-futures Futuros Coin-M usdc-futures Futuros USDC-M |
|
> symbol |
Sequência |
Nome do par de trading |
|
> topic |
Sequência |
Nome do canal |
|
action |
Sequência |
Ação de envio de dados snapshot Completo update Incremento |
|
data |
List<Object> |
Dados de aplicação |
|
> a |
Sequência |
Profundidade de venda |
|
>> a[0] |
Sequência |
Preço de venda |
|
>> a[1] |
Sequência |
Quantidade de venda não RPI |
|
>> a[2] |
Sequência |
Quantidade vendida de RPI |
|
> b |
Sequência |
Profundidade de compra |
|
>> b[0] |
Sequência |
Preço de compra |
|
>> b[1] |
Sequência |
Quantidade de compra não RPI |
|
>> b[2] |
Sequência |
Quantidade de compra RPI |
|
> ts |
Sequência |
Correspondência de data e hora |
|
> seq |
Sequência |
Número de sequência |
|
> previousSeq |
Sequência |
Número de sequência do envio anterior |
2. Informações de trade
Um identificador do tipo RPI foi adicionado aos pontos de extremidade e canais de trade da plataforma.
• Trades recentes: /api/v3/market/fills
• Detalhes da operação: /api/v3/trade/fills
• Canal de trade público: topic=publicTrade
• Canal de trade privado: topic=fill
|
Nome do parâmetro |
Tipo de parâmetro |
Resposta à solicitação |
É obrigatório? |
Descrição |
|
isRPI
|
Sequência
|
Parâmetro de resposta |
/
|
Operação do tipo RPI? yes Sim no Não |
3. Envio de ordem e envio de ordens em lote
O tipo RPI foi adicionado à estratégia de execução de ordens para pontos de extremidade de envio de ordens individuais e em lote.
• Envio de ordem: POST /api/v3/trade/place-order
• Envio de ordem em lote: POST /api/v3/trade/place-batch
• Canal de envio de ordens: topic=place-order
• Canal de envio de ordens em lote: topic=batch-place
|
Nome do parâmetro |
Tipo de parâmetro |
Resposta à solicitação |
É obrigatório? |
Descrição |
|
timeInForce
|
Sequência
|
Parâmetro de solicitação
|
Sim
|
Estratégia de execução de ordens ioc (imediato ou cancelar) fok (executar ou cancelar) gtc (Até Cancelar) post_only Post Only rpi Ordens Retail Price Improvement Obrigatório se o tipo de ordem for ordem limitada (limit), padrão para gtc se deixado em branco. |
4. Informações de ordens, ordens em aberto e histórico de ordens
• Informações de ordem: GET /api/v3/trade/order-info
• Ordens em aberto: GET /api/v3/trade/unfilled-orders
• Histórico de ordens: GET /api/v3/trade/history-orders
• Canal de ordens: topic=order
|
Nome do parâmetro |
Tipo de parâmetro |
Resposta à solicitação |
É obrigatório? |
Descrição |
|
timeInForce
|
Sequência
|
Parâmetro de resposta
|
Sim
|
Estratégia de execução de ordens ioc (imediato ou cancelar) fok (executar ou cancelar) gtc (Até Cancelar) post_only Post Only rpi Ordens Retail Price Improvement |
Perguntas frequentes
1. O que é uma ordem Retail Price Improvement (RPI)?
Uma ordem RPI é um tipo de ordem especial no modelo de conta de trading unificada. Ela só combina com ordens não algorítmicas (ou seja, ordens que não são OpenAPI) para aumentar a liquidez. Ele oferece às ordens de varejo qualificadas melhores preços de execução para melhorar os preços e reduzir a derrapagem.
2. As ordens RPI são ordens de maker ou de taker?
Tipo de ordem: todas as ordens RPI são ordens passivas e se enquadram na categoria de ordens de maker. Elas só executam contra ordens de takers, adicionando assim liquidez ao livro de ordens.
3. Qual é a prioridade de execução para ordens RPI com o mesmo nível de preço?
Prioridade de execução: no mesmo nível de preço, as ordens RPI têm uma prioridade de execução inferior em comparação com as ordens não RPI, independentemente da data em que foram enviadas. As ordens RPI a um determinado nível de preço só serão executadas após todas as ordens não RPI nesse mesmo preço serem completamente executadas.
4. Quais linhas de produtos e modos de margem suportam ordens RPI?
As ordens RPI são suportadas nos modos de margem isolada e margem cruzada na conta de trading unificada. Elas estão disponíveis para trading nos mercados de futuros, spot e de margem. As ordens RPI não são suportadas no trading pré-mercado. Elas só podem ser enviadas após o término do leilão por chamamento; caso contrário, a ordem será rejeitada.
5. A lógica de validação para ordens RPI é a mesma para ordens limitadas comuns?
A lógica de validação para ordens RPI é a mesma que para ordens limitadas comuns. Os requisitos relativos à margem, aos tamanhos mínimo e máximo das ordens e aos limites de posições abertas (OI) são idênticos aos aplicáveis às ordens limitadas padrão.