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

# Mercados

> Entendendo mercados em mercados de previsão

## 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

```json theme={null}
{
      "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)

```json theme={null}
{
  "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.