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)

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)

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)

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.