Livro de Ordens - VoxFi Documentation

O que é um Orderbook?

O Orderbook (livro de ordens) mostra as ordens de compra e venda atuais para um mercado. Cada mercado possui orderbooks separados para os resultados YES e NO, permitindo visualizar a profundidade do mercado e a liquidez disponível em diferentes níveis de preço.

Fonte Principal de Dados de Preço

Além de fornecer o livro de ordens completo, o endpoint de orderbook é a melhor e mais confiável fonte para obter dados de preço das opções de mercado. Ele oferece:

Preços de mercado atualizados: market_price_yes e market_price_no representam os preços de mercado mais recentes;
Último preço negociado: last_price em cada orderbook mostra o último preço em que uma transação foi executada;
Probabilidade implícita: O campo chance indica a probabilidade percentual implícita pelo mercado;
Spread: A diferença entre o melhor preço de compra (bid) e venda (ask);
Profundidade de mercado: Visualização completa das ordens pendentes em diferentes níveis de preço;

Esses dados são essenciais para tomar decisões de negociação informadas e entender o sentimento atual do mercado.

Estrutura do Orderbook

Cada orderbook contém:

Bids (ofertas de compra): Ordens de compradores dispostos a comprar a um determinado preço, ordenadas do maior para o menor preço;
Asks (ofertas de venda): Ordens de vendedores dispostos a vender a um determinado preço, ordenadas do menor para o maior preço;
Spread: Diferença entre o melhor preço de venda (ask) e o melhor preço de compra (bid);
Last Price: Último preço em que uma transação foi executada.

Dados de Preço do Mercado

Além dos orderbooks individuais para YES e NO, a resposta inclui dados agregados de preço:

market_price_yes: Preço de mercado atual para a opção YES (em ticks);
market_price_no: Preço de mercado atual para a opção NO (em ticks);
chance: Probabilidade percentual implícita pelo mercado (baseada nos preços de mercado);
volume: Volume total negociado no mercado (em ticks);
liquidity: Liquidez total disponível no mercado (em ticks).

Obter Orderbook

Recupera o snapshot do orderbook para todos os mercados em um evento. Esta é a fonte recomendada para obter dados de preço atualizados e precisos das opções de mercado.

{
  "95f88394-4f4d-4489-99dc-8cef9f7682ee": {
    "yes_orderbook": {
      "outcome": "YES",
      "bids": [
        {
          "price_ticks": 39,
          "quantity": 93,
          "order_count": 1
        },
        {
          "price_ticks": 37,
          "quantity": 109,
          "order_count": 1
        },
        {
          "price_ticks": 28,
          "quantity": 18,
          "order_count": 1
        },
        {
          "price_ticks": 26,
          "quantity": 31,
          "order_count": 1
        },
        {
          "price_ticks": 24,
          "quantity": 31,
          "order_count": 1
        },
        {
          "price_ticks": 22,
          "quantity": 154,
          "order_count": 1
        },
        {
          "price_ticks": 20,
          "quantity": 23,
          "order_count": 1
        }
      ],
      "asks": [
        {
          "price_ticks": 57,
          "quantity": 58,
          "order_count": 1
        },
        {
          "price_ticks": 55,
          "quantity": 10,
          "order_count": 1
        },
        {
          "price_ticks": 53,
          "quantity": 95,
          "order_count": 1
        },
        {
          "price_ticks": 51,
          "quantity": 52,
          "order_count": 1
        },
        {
          "price_ticks": 49,
          "quantity": 112,
          "order_count": 1
        },
        {
          "price_ticks": 40,
          "quantity": 47,
          "order_count": 1
        }
      ],
      "spread": 1,
      "last_price": 40
    },
    "no_orderbook": {
      "outcome": "NO",
      "bids": [
        {
          "price_ticks": 60,
          "quantity": 47,
          "order_count": 1
        },
        {
          "price_ticks": 51,
          "quantity": 112,
          "order_count": 1
        },
        {
          "price_ticks": 49,
          "quantity": 52,
          "order_count": 1
        },
        {
          "price_ticks": 47,
          "quantity": 95,
          "order_count": 1
        },
        {
          "price_ticks": 45,
          "quantity": 10,
          "order_count": 1
        },
        {
          "price_ticks": 43,
          "quantity": 58,
          "order_count": 1
        }
      ],
      "asks": [
        {
          "price_ticks": 80,
          "quantity": 23,
          "order_count": 1
        },
        {
          "price_ticks": 78,
          "quantity": 154,
          "order_count": 1
        },
        {
          "price_ticks": 76,
          "quantity": 31,
          "order_count": 1
        },
        {
          "price_ticks": 74,
          "quantity": 31,
          "order_count": 1
        },
        {
          "price_ticks": 72,
          "quantity": 18,
          "order_count": 1
        },
        {
          "price_ticks": 63,
          "quantity": 109,
          "order_count": 1
        },
        {
          "price_ticks": 61,
          "quantity": 93,
          "order_count": 1
        }
      ],
      "spread": 1,
      "last_price": 60
    },
    "market_price_yes": 40,
    "market_price_no": 61,
    "chance": 39,
    "volume": 29500,
    "liquidity": 32051
  }
}

Endpoints da API

Obter Orderbook de um Evento

Recupera o snapshot do orderbook para todos os mercados de um evento específico. Retorna um objeto onde cada chave é o ID de um mercado e o valor contém os orderbooks completos para YES e NO, além de dados agregados de preço. Use este endpoint quando desejar obter orderbooks de todos os mercados de um evento. Documentação detalhada + playground

Obter Orderbook de um Mercado

Recupera o snapshot do orderbook para um mercado específico. Retorna os orderbooks completos para YES e NO, além de dados agregados de preço do mercado. Use este endpoint quando precisar obter o orderbook de um mercado específico e já tiver o ID do mercado. Documentação detalhada + playground

Casos de Uso

Obter Preços de Mercado: Usar market_price_yes e market_price_no para obter os preços mais atualizados das opções de mercado;
Descoberta de Preços: Analisar o livro de ordens completo para entender a distribuição de preços e identificar oportunidades;
Análise de Liquidez: Verificar a profundidade do mercado (quantidade disponível em cada nível de preço) antes de executar ordens grandes;
Monitoramento de Spread: Acompanhar o spread entre bids e asks para avaliar o custo de transação;
Market Making: Fornecer liquidez fazendo ordens limitadas em ambos os lados do orderbook;
Arbitragem: Encontrar diferenças de preço entre os resultados YES e NO que não somam 100 ticks;
Análise de Sentimento: Usar o campo chance e a distribuição de ordens para entender a probabilidade implícita pelo mercado;
Execução de Ordens: Usar os dados do orderbook para determinar o melhor preço e estratégia ao executar uma ordem.

​O que é um Orderbook?

​Fonte Principal de Dados de Preço

​Estrutura do Orderbook

​Dados de Preço do Mercado

​Obter Orderbook

​Endpoints da API

​Obter Orderbook de um Evento

​Obter Orderbook de um Mercado

​Casos de Uso