Algos

Best Offer

Posta uma ordem passiva que sempre fica na frente do livro do seu lado, recotando automaticamente quando aparece um preço melhor.

Quando usar

Você quer estar na frente da fila sem perseguir manualmente o melhor bid/ask.
Prefere execução passiva a pagar o spread, e aceita ser recotado.
Está trabalhando uma ordem pequena num ativo líquido onde a posição na fila importa.

Início rápido

from investflex import AsyncInvestflexClient
from investflex.models.algos import BestOffer
from investflex.models.common import Side

bo = BestOffer(
    name="petr4-boffer",
    init_time="09:00:00",
    end_time="17:00:00",
    price_limit=30.05,
    symbol="PETR4",
    side=Side.SELL,
    quantity=100,
    account="YOUR_ACCOUNT",
    max_clip_size=100,
)

async with AsyncInvestflexClient.from_env() as client:
    handle = await client.algos.create(bo)
    print(handle.clord_id, handle.status.name)

import { InvestflexClient, BestOffer, Side } from "@investflex/sdk";

const bo = new BestOffer({
  name: "petr4-boffer",
  initTime: "09:00:00",
  endTime: "17:00:00",
  priceLimit: 30.05,
  symbol: "PETR4",
  side: Side.SELL,
  quantity: 100,
  account: "YOUR_ACCOUNT",
  maxClipSize: 100,
});

const client = InvestflexClient.fromEnv();
const handle = await client.algos.create(bo);
console.log(handle.clOrdId, handle.status);

await client.close();

Parâmetros

Estratégia

Campo	Tipo	Obrigatório	Editável	Padrão	Observações
`name`	str	sim	não	—	Rótulo.
`init_time`	`HH:MM:SS`	sim	não	—	Início da janela.
`end_time`	`HH:MM:SS`	sim	não	—	Fim da janela.
`expire_date`	`YYYYMMDD`	não	não	`20380101`	Validade da ordem-dia.
`text`	str	não	não	—	Comentário livre.
`basket_id`	str	não	não	—	Chave opcional de agrupamento.
`price_limit`	número	sim	sim	—	Pior preço para o qual o algo vai recotar.

Perna

Perna única, passada de forma plana na estratégia.

Campo	Tipo	Obrigatório	Editável	Observações
`symbol`	str	sim	não	Código do instrumento.
`side`	`Side.BUY` / `Side.SELL`	sim	não
`quantity`	int	sim	sim	Quantidade total (> 0).
`account`	str	sim	não	Conta da corretora.
`max_clip_size`	int	sim	sim	Maior pedaço visível por ordem filha.
`security_exchange`	str	não	não	Padrão `XBSP`.

Editando um Best Offer em execução

await client.algos.edit(handle.clord_id, PriceLimit=30.20)

await client.algos.edit(
  handle.clOrdId,
  {
    PriceLimit: 30.2,
  },
  { strategyCode: "boffer" },
);

Editável: PriceLimit.

Comandos de ciclo de vida

await client.algos.commands.cancel(handle.clord_id)
await client.algos.commands.suspend(handle.clord_id)
await client.algos.commands.resume(handle.clord_id)

await client.commands.cancel(handle.clOrdId);
await client.commands.suspend(handle.clOrdId);
await client.commands.resume(handle.clOrdId);

Notas de comportamento

A ordem é recotada sempre que aparece um preço melhor no toque do seu lado. Cada recotação perde prioridade na fila.
Se o toque cruzar price_limit, o algo para de recotar e espera até o toque voltar para dentro do limite.
Best Offer não atravessa o spread; use Sniper se precisar de execução agressiva.