Pular para o conteúdo principal

​
O que é um Mercado?

Um Mercado no VoxFi é um contrato negociável dentro de um evento. Um evento pode conter um ou vários mercados, cada um representando um resultado ou pergunta específica. Importante: Os mercados sempre são obtidos a partir dos seus respectivos eventos. Não existe um endpoint direto para buscar mercados isoladamente - você deve primeiro obter o evento e então acessar seus mercados através da propriedade markets na resposta do evento.

​
Características Principais

  • Resultados Binários: Cada mercado tem dois resultados possíveis: YES ou NO;
  • Negociação: Usuários podem comprar ou vender contratos para qualquer resultado;
  • Preço: Os preços do mercado variam de 0 a 100 ticks, representando probabilidade;
  • Liquidez: A quantidade de capital disponível para negociação (em ticks, cached);
  • Volume: Volume total de negociação no mercado (em ticks, cached).

​
Relação com Eventos

  • Evento de Mercado Único: Um evento com is_single_market: true tem apenas um mercado;
  • Evento Multi-Mercado: Um evento pode ter vários mercados, cada um representando diferentes aspectos ou perguntas relacionadas ao evento principal.

​
Exemplo de Mercado

{
      "id": "95f88394-4f4d-4489-99dc-8cef9f7682ee",
      "description": "",
      "metadata": {},
      "thumbnail_url": null,
      "options": [
        {
          "id": "13f89ed4-8cc0-4d72-bc64-88faf17ef386",
          "option_type": 1,
          "description": "Yes",
          "metadata": {}
        },
        {
          "id": "230d9631-b35a-4fbc-970d-39a60df7a7c6",
          "option_type": 2,
          "description": "No",
          "metadata": {}
        }
      ],
      "volume": 29500,
      "closed_at": null,
      "resolved_at": null,
      "settled_at": null,
      "liquidity": 32051,
      "winner_option_type": null
    }

​
Opções do Mercado

Cada mercado possui exatamente duas opções, com um mapeamento fixo e imutável entre o tipo da opção e o seu significado.

​
Mapeamento oficial

  • 1 → YES
  • 2 → NO
Esse mapeamento nunca muda em nenhum mercado.

​
Estrutura da opção (JSON)

{
  "id": "string",
  "option_type": 1,
  "description": "YES",
  "metadata": {}
}

​
Estados do Mercado

Mercados podem estar em diferentes estados:
  • Ativo: Mercado está aguardando abertura;
  • Ativo: Negociação ativa é permitida;
  • Fechado: Negociação está fechada, aguardando resolução;
  • Resolvido: Resultado foi determinado;
  • Liquidado: Contratos foram liquidados e pagamentos distribuídos.

​
Casos de Uso

  • Obter Mercados de um Evento: Buscar um evento específico para acessar todos os seus mercados através da propriedade markets;
  • Listar Mercados Disponíveis: Navegar eventos para descobrir mercados disponíveis para negociação;
  • Analisar Mercados de um Evento: Examinar todos os mercados relacionados a um evento para entender as diferentes perguntas ou resultados possíveis;
  • Negociar em Mercados: Identificar mercados específicos dentro de eventos para realizar compras ou vendas de contratos;
  • Monitorar Volume e Liquidez: Acompanhar métricas de mercado (volume, liquidez) através dos dados retornados junto com o evento;
  • Verificar Estados de Mercados: Checar o estado atual de mercados (ativo, fechado, resolvido, liquidado) para determinar se estão disponíveis para negociação.