> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Livro de ordens

> Como o livro está organizado, o que significa a prioridade preço-tempo quando o tempo é uma posição no bloco, e como ler a profundidade antes de submeter.

Cada mercado tem um livro de ordens central (CLOB): de um lado todas as ordens de compra em livro, do outro todas as ordens de venda, ordenadas por preço. Há uma transação quando uma ordem que chega atravessa o intervalo entre os dois lados.

O livro é on-chain. O seu estado faz parte do estado confirmado da cadeia, o que significa que é o mesmo livro para toda a gente e que qualquer nó consegue reconstruir exatamente o seu aspeto em qualquer bloco.

<h2 id="structure">
  Estrutura
</h2>

<div className="dg" data-dg="order-book-ladder">
  <div className="dg-c" style={{aspectRatio:"720 / 318"}}>
    <svg className="dg-w" viewBox="0 0 720 318" aria-hidden="true" />

    <div className="dg-band" style={{left:"0.0000%",top:"40.2516%",width:"55.0000%",height:"15.0943%"}}><span className="dg-cap">spread</span></div>
    <div className="dg-b dg-plain" style={{left:"55.8333%",top:"27.9874%",width:"10.8333%",height:"10.0629%"}}><span className="dg-s dg-ink--orange">melhor</span></div>
    <div className="dg-b dg-plain" style={{left:"1.9444%",top:"43.3962%",width:"51.1111%",height:"10.0629%"}}><span className="dg-t">50 000 − 49 950 = 50</span><span className="dg-s">mid 49 975</span></div>
    <div className="dg-b dg-plain" style={{left:"55.8333%",top:"66.3522%",width:"10.8333%",height:"10.0629%"}}><span className="dg-s dg-ink--green">melhor</span></div>
    <div className="dg-b dg--orange dg-left" style={{left:"68.0556%",top:"25.7862%",width:"31.9444%",height:"44.0252%"}}><span className="dg-t">Compra a mercado de 1,0</span><span className="dg-s">0,2 executa a 50 000<br />0,3 executa a 50 100<br />0,5 executa a 50 200</span><span className="dg-n">Média ≈ 50 130 — não os 50 000<br />cotados no topo do livro. Essa diferença<br />é o que uma ordem de mercado esconde.</span></div>
    <div className="dg-free" style={{left:"0.0000%",top:"0.0000%",width:"33.3333%"}}><div className="dg-n dg-ink--orange">Vendas — vendedores</div></div>
    <div className="dg-free" style={{left:"0.0000%",top:"59.7484%",width:"33.3333%"}}><div className="dg-n dg-ink--green">Compras — compradores</div></div>
    <div className="dg-bar" style={{left:"0.0000%",top:"7.5472%",width:"55.0000%",height:"8.1761%"}}><span className="dg-bar-lead" style={{width:"15.6566%"}}>50,200</span><span className="dg-bar-track"><span className="dg-bar-fill dg--orange" style={{left:"0%",width:"41.667%"}} /></span><span className="dg-bar-trail">0.5</span></div>
    <div className="dg-bar" style={{left:"0.0000%",top:"18.2390%",width:"55.0000%",height:"8.1761%"}}><span className="dg-bar-lead" style={{width:"15.6566%"}}>50,100</span><span className="dg-bar-track"><span className="dg-bar-fill dg--orange" style={{left:"0%",width:"25.000%"}} /></span><span className="dg-bar-trail">0.3</span></div>
    <div className="dg-bar" style={{left:"0.0000%",top:"28.9308%",width:"55.0000%",height:"8.1761%"}}><span className="dg-bar-lead" style={{width:"15.6566%"}}>50,000</span><span className="dg-bar-track"><span className="dg-bar-fill dg--orange" style={{left:"0%",width:"16.667%"}} /></span><span className="dg-bar-trail">0.2</span></div>
    <div className="dg-bar" style={{left:"0.0000%",top:"67.2956%",width:"55.0000%",height:"8.1761%"}}><span className="dg-bar-lead" style={{width:"15.6566%"}}>49,950</span><span className="dg-bar-track"><span className="dg-bar-fill dg--green" style={{left:"0%",width:"33.333%"}} /></span><span className="dg-bar-trail">0.4</span></div>
    <div className="dg-bar" style={{left:"0.0000%",top:"77.9874%",width:"55.0000%",height:"8.1761%"}}><span className="dg-bar-lead" style={{width:"15.6566%"}}>49,900</span><span className="dg-bar-track"><span className="dg-bar-fill dg--green" style={{left:"0%",width:"50.000%"}} /></span><span className="dg-bar-trail">0.6</span></div>
    <div className="dg-bar" style={{left:"0.0000%",top:"88.6792%",width:"55.0000%",height:"8.1761%"}}><span className="dg-bar-lead" style={{width:"15.6566%"}}>49,800</span><span className="dg-bar-track"><span className="dg-bar-fill dg--green" style={{left:"0%",width:"100.000%"}} /></span><span className="dg-bar-trail">1.2</span></div>
  </div>
</div>

O **melhor preço de compra** é o mais alto que um comprador está disposto a pagar. O **melhor preço de venda** é o mais baixo que um vendedor aceita. O intervalo entre ambos é o **spread**, e o ponto médio entre eles é o **mid** — usado como referência em vários sítios, incluindo o prémio do [funding](/pt/trading/funding).

A **profundidade** é a quantidade que está em cada nível de preço. É o que determina se uma ordem executa perto do topo do livro (os melhores preços de compra e venda) ou percorre preços cada vez piores.

<h2 id="priority">
  Prioridade
</h2>

As ordens executam por **preço primeiro, tempo depois**.

O preço é óbvio: um comprador que oferece mais é servido antes de um que oferece menos. É no tempo que esta plataforma difere da maioria.

**O «tempo» é a posição da ordem na sequência confirmada do bloco — não o momento em que chegou a um nó.**

Duas ordens no mesmo bloco têm uma precedência que todos os validadores calculam de forma idêntica, a partir de dados confirmados pelo consenso. Nenhuma proximidade de rede a altera. Entre blocos, a chegada continua a contar; dentro de um bloco, a corrida ao microssegundo não existe.

As [regras de sequenciação](/pt/trading/tx-sequencing) reforçam isto: os cancelamentos executam antes das ordens agressoras do mesmo bloco, pelo que uma cotação desatualizada pode ser retirada sem ser apanhada por uma ordem que chegou a par do cancelamento.

<h2 id="reading-depth-before-you-submit">
  Ler a profundidade antes de submeter
</h2>

Os melhores preços de compra e venda são os que aparecem cotados. **Não** são os que obtém se a sua ordem for maior do que a quantidade aí disponível.

Percorrendo o lado da venda do livro acima:

| Nível |  Preço | Tamanho | Acumulado |
| ----- | -----: | ------: | --------: |
| 1     | 50 000 |     0,2 |       0,2 |
| 2     | 50 100 |     0,3 |       0,5 |
| 3     | 50 200 |     0,5 |       1,0 |

Uma compra a mercado de 0,2 executa integralmente a 50 000. Uma compra a mercado de 1,0 executa pelos três níveis — preço médio à volta de 50 130, e não os 50 000 apresentados no topo do livro.

É por isto que as [ordens de mercado](/pt/trading/market-to-limit) têm um limite derivado da profundidade que o tamanho consumiria de facto, e por isto que dividir uma ordem grande no [tempo](/pt/trading/twap) ou no [preço](/pt/trading/scale-orders) costuma custar menos do que executá-la toda de uma vez.

<Note>
  Um hábito útil antes de qualquer ordem grande face ao livro: calcule o pior preço que o seu tamanho alcançaria, e não apenas o topo do livro. A diferença entre esses dois números é o custo que uma ordem de mercado esconde.
</Note>

<h2 id="prices-are-integers">
  Os preços são inteiros
</h2>

Os preços do livro são múltiplos inteiros do **tick size** (incremento mínimo de preço) do mercado, e os tamanhos são múltiplos do seu **lot size** (incremento mínimo de quantidade). Não há vírgula flutuante no caminho de execução — uma diferença de arredondamento entre dois nós seria um fork. Ver [Precisão](/pt/trading/precision).

<h2 id="what-the-book-does-not-show">
  O que o livro não mostra
</h2>

**As ordens condicionais não estão no livro.** Os stops, os take-profits e outras [ordens condicionais](/pt/trading/conditional-orders) ficam num registo separado, a vigiar um preço. Não ocupam posição na fila nem contribuem para a profundidade até serem ativadas.

A consequência prática: num mercado que se move depressa, a profundidade pode ser menor do que o livro sugere, porque um movimento que atravessa um conjunto de ativações converte de uma só vez várias ordens invisíveis em ordens reais — todas do mesmo lado.

<h2 id="where-to-go-next">
  Para onde ir a seguir
</h2>

<CardGroup cols={2}>
  <Card title="Tipos de ordem" href="/pt/trading/order-types">
    O que se pode colocar no livro, e o que fica em livro em vez de consumir liquidez.
  </Card>

  <Card title="Ordens de mercado" href="/pt/trading/market-to-limit">
    Como o limite derivado da profundidade protege uma ordem de mercado.
  </Card>

  <Card title="Sequenciação de transações" href="/pt/trading/tx-sequencing">
    Porque os cancelamentos vencem as ordens agressoras do mesmo bloco.
  </Card>

  <Card title="Matching" href="/pt/protocol/architecture/matching">
    Como o livro está estruturado e é percorrido dentro do kernel.
  </Card>
</CardGroup>
