# Modo Kiosque

> Dashboard financeiro para exibição em TVs, painéis e monitores.

O **Modo Kiosque** da HG Finance é uma página de dashboard pública para exibição contínua em TVs, monitores corporativos e painéis. Ela exibe cotações em tempo quase real de ações, índices, moedas e criptoativos em um layout visual otimizado para leitura à distância, com atualização automática e relógio ao vivo.

<callout color="neutral" icon="tabler:device-tv">

O Modo Kiosque é uma página do site, não um endpoint de API. Configure-a diretamente pela URL.

</callout>

## Acesso

```text
https://hgbrasil.com/finance/kiosk
```

## Parâmetros

<field-group>
<field name="key" type="string" :required="true">

Chave de API HG Brasil. Informada diretamente na URL — utilize uma chave com permissões de leitura.

</field>

<field name="tickers" type="string">

Lista de tickers separados por vírgula no formato `{fonte}:{símbolo}`. Padrão: `INDEXB3:IBOV,FOREX:USDBRL,FOREX:EURBRL,B3:PETR4`.

</field>

<field name="refresh" type="integer">

Intervalo de atualização automática em segundos. Padrão: `300` (5 minutos).

</field>
</field-group>

## Exemplo

```text
https://hgbrasil.com/finance/kiosk?key=API_KEY&tickers=INDEXB3:IBOV,FOREX:USDBRL,FOREX:EURBRL,B3:PETR4&refresh=300
```

## Formato dos tickers

Utilize o formato `{fonte}:{símbolo}` para identificar cada ativo. Exemplos:

<table>
<thead>
  <tr>
    <th>
      Ativo
    </th>
    
    <th>
      Ticker
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Ibovespa
    </td>
    
    <td>
      <code>
        INDEXB3:IBOV
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Dólar Americano
    </td>
    
    <td>
      <code>
        FOREX:USDBRL
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Euro
    </td>
    
    <td>
      <code>
        FOREX:EURBRL
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Petrobras PN
    </td>
    
    <td>
      <code>
        B3:PETR4
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      Vale ON
    </td>
    
    <td>
      <code>
        B3:VALE3
      </code>
    </td>
  </tr>
</tbody>
</table>

Consulte a lista completa nas seções [Moedas](/docs/finance/currencies), [Ações e Fundos](/docs/finance/stocks), [Índices](/docs/finance/indices) e [Criptomoedas](/docs/finance/crypto).

## Atualização automática

A página atualiza os dados automaticamente conforme o intervalo definido em `refresh`. O padrão é de **5 minutos** (`300` segundos).

<note icon="tabler:clock">

As cotações da HG Finance são atualizadas em intervalos de 15 a 45 minutos durante o pregão. Definir um `refresh` inferior a esse intervalo não traz dados mais recentes — apenas consome requisições desnecessariamente.

</note>

## Recomendações para TVs

<tip>

Abra a URL no modo tela cheia do navegador (`F11` no Chrome/Edge) para eliminar a barra de endereços e as abas.

</tip>

<tip>

Configure o navegador ou o sistema operacional para recarregar a aba periodicamente (a cada 12 a 24 horas) como prevenção a eventuais travamentos de longa duração.

</tip>

<warning>

Utilize uma chave com permissões mínimas necessárias. Evite compartilhar a mesma chave de projetos em produção, pois a `key` fica visível na barra de endereços.

</warning>