# DaazMarkets — Shortcode Reference

> **Versão:** 1.0.0 · **Data:** 2026-03-20
> Referência completa de todos os shortcodes implementados no plugin FREE e PRO.
> Os shortcodes PRO requerem o plugin `daazmarkets-pro` activo com licença válida.

---

## Índice

### FREE
| Shortcode | Descrição |
|---|---|
| [`[daaz_gmp_crypto]`](#daaz_gmp_crypto) | Preços de criptomoedas (CoinGecko) |
| [`[daaz_gmp_markets]`](#daaz_gmp_markets) | Acções e índices de mercado |
| [`[daaz_gmp_commodities]`](#daaz_gmp_commodities) | Commodities (futuros e spot) |
| [`[daaz_gmp_etfs]`](#daaz_gmp_etfs) | Preços de ETFs |
| [`[daaz_gmp_etf_volumes]`](#daaz_gmp_etf_volumes) | Volumes históricos de ETFs |
| [`[daaz_gmp_forex]`](#daaz_gmp_forex) | Taxas de câmbio forex |
| [`[daaz_gmp_miners]`](#daaz_gmp_miners) | Empresas de mineração |
| [`[daaz_gmp_treasuries]`](#daaz_gmp_treasuries) | BTC Treasuries corporativos |
| [`[daaz_gmp_charts]`](#daaz_gmp_charts) | Gráficos históricos (Chart.js) |
| [`[daaz_gmp_sparkline]`](#daaz_gmp_sparkline) | Sparklines compactos |

### PRO
| Shortcode | Descrição |
|---|---|
| [`[daaz_gmp_ticker]`](#daaz_gmp_ticker) ⭐ | Ticker tape scrolling multi-activo |
| [`[daaz_gmp_converter]`](#daaz_gmp_converter) ⭐ | Conversor de moedas fiat + cripto |
| [`[daaz_gmp_fear_greed]`](#daaz_gmp_fear_greed) ⭐ | Índice Fear & Greed |
| [`[daaz_gmp_market_cap]`](#daaz_gmp_market_cap) ⭐ | Market cap total cripto |
| [`[daaz_gmp_market_volume]`](#daaz_gmp_market_volume) ⭐ | Volume 24h total cripto |
| [`[daaz_gmp_btc_dominance]`](#daaz_gmp_btc_dominance) ⭐ | Dominância do Bitcoin |
| [`[daaz_gmp_market_pulse]`](#daaz_gmp_market_pulse) ⭐ | Market Pulse — 4 asset cards |
| [`[daaz_gmp_chart_advanced]`](#daaz_gmp_chart_advanced) ⭐ | Gráficos interactivos avançados |
| [`[daaz_gmp_btc_correlation]`](#daaz_gmp_btc_correlation) ⭐ | Correlação BTC vs macro assets |
| [`[daaz_gmp_market_bar]`](#daaz_gmp_market_bar) ⭐ | Market bar estilo Reuters/Bloomberg |
| [`[daaz_gmp_market_tabs]`](#daaz_gmp_market_tabs) ⭐ | Market bar em tabs por categoria |

---

## FREE Features

---

### `[daaz_gmp_crypto]`

**Alias:** `[daaz_gmp_cripto]`
**Descrição:** Mostra preços de criptomoedas em tempo real via CoinGecko. Usar CoinGecko IDs (ex: `bitcoin`, não `BTC`).
**API:** CoinGecko free tier — sem chave necessária.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `coins` | `bitcoin,ethereum,solana` | IDs CoinGecko separados por vírgula |
| `display` | `cards \| table` | Modo de renderização (default: cards) |

**Exemplos:**
```
[daaz_gmp_crypto]
[daaz_gmp_crypto coins="bitcoin,ethereum" display="cards"]
[daaz_gmp_crypto coins="bitcoin,solana" display="table"]
[daaz_gmp_cripto coins="bitcoin" display="cards"]
```

---

### `[daaz_gmp_markets]`

**Descrição:** Mostra preços de acções e mercados. Os símbolos requerem sufixo de bolsa (ex: `AAPL.US`). Por omissão usa a watchlist configurada em Settings → Markets.
**API:** Configurada em Settings → Providers (EODHD, TwelveData, Finnhub, Polygon…).

| Atributo | Exemplo | Descrição |
|---|---|---|
| `symbols` | `AAPL.US,MSFT.US` | Símbolos com sufixo de bolsa. Substitui a watchlist completamente |
| `display` | `cards \| table` | Modo de renderização |

**Exemplos:**
```
[daaz_gmp_markets]
[daaz_gmp_markets symbols="AAPL.US,MSFT.US,NVDA.US,TSLA.US" display="cards"]
[daaz_gmp_markets symbols="GOOG.US" display="table"]
```

> **Nota:** O atributo `symbols=` não tem limite máximo — pode passar qualquer número de tickers.

---

### `[daaz_gmp_commodities]`

**Descrição:** Preços de commodities — futuros ou spot. Símbolos comuns: `GC.US` (Ouro), `SI.US` (Prata), `CL.US` (Petróleo), `HG.US` (Cobre), `NG.US` (Gás Natural).

| Atributo | Exemplo | Descrição |
|---|---|---|
| `symbols` | `GC.US,SI.US,CL.US` | Símbolos separados por vírgula. Omitir = usar defaults |
| `display` | `cards \| table` | Modo de renderização |
| `type` | `futures \| spot` | `futures` (default) = futuros de bolsa; `spot` = preços spot (ex: XAU/USD) |

**Exemplos:**
```
[daaz_gmp_commodities]
[daaz_gmp_commodities symbols="GC.US,SI.US" display="cards" type="futures"]
[daaz_gmp_commodities symbols="XAU/USD" display="table" type="spot"]
```

---

### `[daaz_gmp_etfs]`

**Descrição:** Preços actuais de ETFs com suporte a volume e variação.
**API:** Configurada em Settings → Providers.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `symbols` | `IBIT.US,ETHA.US` | Símbolos ETF com sufixo de bolsa |
| `display` | `cards \| table \| combined` | Modo de renderização |
| `show_volume` | `1` | Mostrar volume mais recente |
| `show_change` | `1` | Mostrar variação percentual |
| `provider` | `eodhd,finnhub` | Lista de providers por prioridade |
| `ttl` | `10` | TTL de cache em minutos para esta instância |
| `columns` | `3` | Número de colunas (modo cards) |
| `currency` | `USD` | Moeda de apresentação |

**Exemplos:**
```
[daaz_gmp_etfs symbols="IBIT.US,ETHA.US" display="cards" show_volume="1" show_change="1"]
```

---

### `[daaz_gmp_etf_volumes]`

**Descrição:** Volumes históricos diários de ETFs com tabs separados por activo subjacente (BTC, ETH, SOL).

| Atributo | Exemplo | Descrição |
|---|---|---|
| `btc_symbols` | `ALL \| IBIT.US,FBTC.US` | ETFs BTC ou `ALL`. Activa o tab BITCOIN |
| `eth_symbols` | `ALL \| ETHA.US,FETH.US` | ETFs ETH ou `ALL`. Activa o tab ETHEREUM |
| `sol_symbols` | `ALL \| BSOL.US` | ETFs SOL ou `ALL`. Activa o tab SOLANA |
| `days` | `30` | Dias de histórico a mostrar (default: 30) |
| `display` | `combined` | Suporta actualmente `combined` (vista em tabs) |
| `provider` | `eodhd,finnhub` | Lista de providers para dados históricos |

**Exemplos:**
```
[daaz_gmp_etf_volumes btc_symbols="ALL" eth_symbols="ALL" sol_symbols="ALL" days="30" display="combined"]
[daaz_gmp_etf_volumes btc_symbols="IBIT.US,FBTC.US" days="30" display="combined"]
```

> ⚠️ Não usar `symbols=` sozinho para tabs ETH/SOL — usar `btc_symbols` / `eth_symbols` / `sol_symbols` separadamente.

---

### `[daaz_gmp_forex]`

**Descrição:** Taxas de câmbio. Se `pairs=` for omitido, o plugin detecta automaticamente os pares suportados pelo provider configurado.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `pairs` | `EUR/USD,GBP/USD,USD/JPY` | Pares FROM/TO separados por vírgula |
| `display` | `cards \| table` | `cards` (default) ou `table` compacto |

**Exemplos:**
```
[daaz_gmp_forex]
[daaz_gmp_forex pairs="EUR/USD,GBP/USD" display="cards"]
[daaz_gmp_forex pairs="USD/JPY" display="table"]
```

---

### `[daaz_gmp_miners]`

**Descrição:** Preços de acções de empresas de mineração. Por omissão usa a lista pré-definida do plugin.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `symbols` | `MARA,RIOT,BITF` | Tickers separados por vírgula |
| `display` | `cards \| table` | Modo de renderização |
| `show_volume` | `1` | Mostrar volume |
| `show_change` | `1` | Mostrar variação |
| `provider` | `twelvedata,eodhd` | Lista de providers por prioridade |
| `ttl` | `30` | TTL de cache em minutos |
| `class` | `my-miners` | Classe CSS extra no container |

**Exemplos:**
```
[daaz_gmp_miners]
[daaz_gmp_miners symbols="MARA,RIOT,BITF,CLSK" display="cards" show_volume="1" show_change="1"]
[daaz_gmp_miners symbols="MARA" provider="twelvedata,eodhd" ttl="30"]
```

---

### `[daaz_gmp_treasuries]`

**Alias:** `[daaz_gmp_btc_treasuries]`
**Descrição:** Mostra as empresas públicas com mais Bitcoin em reserva. Fonte: CoinGecko (sem chave necessária).

| Atributo | Exemplo | Descrição |
|---|---|---|
| `limit` | `10` | Número máximo de empresas (default: 10) |
| `display` | `cards \| table` | Modo de renderização (default: cards) |
| `vs_currency` | `eur` | Moeda fiat para conversão BTC (default: usd) |

**Exemplos:**
```
[daaz_gmp_treasuries]
[daaz_gmp_treasuries limit="5" display="cards"]
[daaz_gmp_treasuries limit="8" display="table" vs_currency="eur"]
[daaz_gmp_btc_treasuries limit="8" source="coingecko" show_links="1"]
```

---

### `[daaz_gmp_charts]`

**Descrição:** Gráficos históricos de linha e candlestick via Chart.js. Funciona para cripto, acções e commodities.
**Dica:** Usar Settings → Charts → Chart Builder para gerar shortcodes automaticamente.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `coin` | `bitcoin` | CoinGecko ID (para cripto) |
| `symbol` | `AAPL.US` | Símbolo de mercado com sufixo (para acções/commodities) |
| `days` | `30` | Dias de histórico (default: 30) |
| `width` | `100% \| 600` | Largura em px ou %. Usar `100%` para responsivo |
| `height` | `300` | Altura em px |
| `type` | `line \| candlestick` | Tipo de gráfico (default: line) |
| `color` | `#2ecc71` | Cor da linha |
| `legend` | `1 \| 0` | Mostrar/ocultar legenda |
| `provider` | `coingecko,eodhd` | Override de provider para dados históricos |

**Exemplos:**
```
[daaz_gmp_charts coin="bitcoin" days="30" width="100%" height="300"]
[daaz_gmp_charts symbol="AAPL.US" days="90" width="800" height="320" provider="eodhd"]
```

---

### `[daaz_gmp_sparkline]`

**Descrição:** Sparkline compacto para usar inline em tabelas, sidebars ou dentro de texto.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `coin` | `bitcoin` | CoinGecko ID |
| `days` | `7` | Dias de histórico (default: 7) |
| `width` | `100 \| 100%` | Largura em px ou % |
| `height` | `30` | Altura em px |
| `color` | `#10b981` | Cor da linha |
| `label` | `BTC` | Texto de label ao lado do sparkline |
| `show_value` | `1` | Mostrar último preço junto ao label |
| `label_pos` | `left \| right \| top` | Posição do label |
| `tooltip` | `true \| false` | Mostrar tooltip no hover |

**Exemplos:**
```
[daaz_gmp_sparkline coin="bitcoin" days="7" width="100" height="30" label="BTC" show_value="1"]
[daaz_gmp_sparkline coin="ethereum" days="30" width="100%" height="48" label_pos="top"]
```

---

## PRO Features ⭐

> Todos os shortcodes PRO requerem o plugin `daazmarkets-pro` activo.

---

### `[daaz_gmp_ticker]`

**Descrição:** Ticker tape scrolling multi-activo. Suporta cripto (tickers como `BTC` ou IDs CoinGecko), forex (`EUR/USD`) e símbolos de mercado (`AAPL.US`, `GC.US`) — misturáveis livremente num único shortcode.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `symbols` | `BTC,ETH,EUR/USD,AAPL.US` | Símbolos mistos separados por vírgula |
| `speed` | `60` | Duração em segundos de um loop completo (default: 60). Menor = mais rápido |
| `theme` | `auto \| dark \| light \| glass` | Tema de cores (default: auto) |
| `direction` | `left \| right` | Direcção do scroll (default: left) |
| `show_change` | `1 \| 0` | Mostrar variação 24h |
| `show_icon` | `1 \| 0` | Mostrar ícone do activo |
| `show_name` | `1 \| 0` | Mostrar nome do activo (oculto em mobile ≤768px) |
| `pause_on_hover` | `1 \| 0` | Pausar ao passar o rato (default: 1) |
| `separator` | `·` | Separador entre itens |
| `height` | `46px` | Altura do ticker (valor CSS) |
| `label` | `LIVE` | Texto do badge esquerdo. Vazio = oculto |
| `currency` | `usd` | Moeda fiat para apresentação de preços |

**Cripto disponível:** BTC, ETH, SOL, BNB, XRP, ADA, DOGE, AVAX, DOT, LINK, LTC, MATIC, UNI, ATOM, NEAR, APT, ARB, OP, SUI, TON, TRX, BCH, XMR, PEPE, WIF, TAO e mais.

**Exemplos:**
```
[daaz_gmp_ticker]
[daaz_gmp_ticker symbols="BTC,ETH,SOL,EUR/USD,GBP/USD,AAPL.US,GC.US"]
[daaz_gmp_ticker symbols="BTC,ETH,SOL,BNB,XRP" theme="dark" speed="40"]
[daaz_gmp_ticker symbols="EUR/USD,GBP/USD,USD/JPY" theme="glass" label="FX"]
[daaz_gmp_ticker theme="light" direction="right" pause_on_hover="0"]
```

---

### `[daaz_gmp_converter]`

**Descrição:** Conversor de moedas ao vivo com suporte a fiat e cripto. Suporta conversões mistas (1 BTC → EUR, 1 ETH → GBP) via AJAX sem recarregar a página. Taxas em cache 5 minutos.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `from` | `USD` | Moeda/cripto de origem (default: USD) |
| `to` | `EUR` | Moeda/cripto de destino (default: EUR) |
| `amount` | `1` | Valor pré-preenchido (default: 1) |
| `theme` | `auto \| dark \| light \| glass` | Tema de cores |
| `currencies` | `USD,EUR,GBP,JPY,…` | Moedas fiat nos dropdowns (default: 20 principais) |
| `cryptos` | `BTC,ETH,SOL,BNB,XRP` | Tickers cripto a incluir |
| `show_rate` | `1 \| 0` | Mostrar linha de taxa de câmbio (default: 1) |
| `show_inverse` | `1 \| 0` | Mostrar taxa inversa (default: 1) |
| `title` | `Live Rates` | Título do widget. Vazio = oculto |
| `compact` | `0 \| 1` | Layout compacto de uma linha para sidebars |

**Lógica de conversão:** Fiat↔Fiat usa o provider Forex configurado. Cripto→Fiat usa CoinGecko. Cripto→Cripto converte via pivô USD.

**Exemplos:**
```
[daaz_gmp_converter]
[daaz_gmp_converter from="BTC" to="EUR" theme="dark"]
[daaz_gmp_converter from="EUR" to="BRL" title="Câmbio ao vivo" theme="glass"]
[daaz_gmp_converter compact="1" from="USD" to="EUR"]
[daaz_gmp_converter from="ETH" to="GBP" cryptos="BTC,ETH,SOL,ADA,DOGE"]
```

---

### `[daaz_gmp_fear_greed]`

**Descrição:** Gauge do Crypto Fear & Greed Index com gráfico histórico opcional. Dados de alternative.me — API gratuita, sem chave. O TTL de cache é determinado pelo próprio valor `time_until_update` da API. Gauge renderizado em SVG puro (sem JavaScript).

| Atributo | Exemplo | Descrição |
|---|---|---|
| `theme` | `auto \| dark \| light \| glass` | Tema de cores (default: auto) |
| `show_history` | `1 \| 0` | Mostrar gráfico de barras histórico (default: 1) |
| `history_days` | `7` | Dias de histórico no gráfico (2-30, default: 7) |
| `show_label` | `1 \| 0` | Mostrar classificação textual (Extreme Fear / Greed…) |
| `show_update` | `1 \| 0` | Mostrar rodapé com fonte e tempo até próxima actualização |
| `title` | `Market Sentiment` | Título do widget. Vazio = oculto |
| `compact` | `0 \| 1` | Padding compacto para sidebars |

**Zonas do gauge:** 0-24 Extreme Fear (vermelho) · 25-44 Fear (laranja) · 45-55 Neutral (âmbar) · 56-74 Greed (lima) · 75-100 Extreme Greed (verde).

**Exemplos:**
```
[daaz_gmp_fear_greed]
[daaz_gmp_fear_greed theme="dark" title="Market Sentiment"]
[daaz_gmp_fear_greed show_history="0" compact="1"]
[daaz_gmp_fear_greed history_days="14" theme="glass"]
```

---

### `[daaz_gmp_market_cap]`

**Descrição:** Capitalização de mercado total de criptomoedas (ex: $2.54T) com indicador de variação 24h. Fonte: CoinGecko /global — gratuito, sem chave. Cache: 5 minutos.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `style` | `badge \| card \| inline` | Estilo de apresentação (`badge` = pill, default) |
| `label` | `Market Cap` | Texto do label (default: "Market Cap") |
| `theme` | `auto \| light \| dark` | Tema de cores (default: auto) |

**Exemplos:**
```
[daaz_gmp_market_cap]
[daaz_gmp_market_cap style="card" theme="dark"]
[daaz_gmp_market_cap style="inline"]
[daaz_gmp_market_cap label="Crypto Market" style="badge"]
```

> **Dica:** Usar `style="inline"` para embeber o valor numa frase — ex: `"O mercado vale [daaz_gmp_market_cap style='inline'] hoje."`

---

### `[daaz_gmp_market_volume]`

**Descrição:** Volume total de negociação em 24h em todas as criptomoedas (ex: $98.5B). Mesma fonte e cache que o Market Cap.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `style` | `badge \| card \| inline` | Estilo de apresentação (default: badge) |
| `label` | `Volume 24h` | Texto do label |
| `theme` | `auto \| light \| dark` | Tema de cores (default: auto) |

**Exemplos:**
```
[daaz_gmp_market_volume]
[daaz_gmp_market_volume style="card"]
[daaz_gmp_market_volume style="inline" label=""]
```

---

### `[daaz_gmp_btc_dominance]`

**Descrição:** Quota do Bitcoin no market cap total cripto em percentagem (ex: 54.2%). Mesma fonte e cache que Market Cap e Market Volume.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `style` | `badge \| card \| inline` | Estilo de apresentação (default: badge) |
| `label` | `BTC Dominance` | Texto do label |
| `theme` | `auto \| light \| dark` | Tema de cores (default: auto) |

**Exemplos:**
```
[daaz_gmp_btc_dominance]
[daaz_gmp_btc_dominance style="card" theme="dark"]
[daaz_gmp_btc_dominance style="inline"]
```

> **Nota:** Os três shortcodes de stats globais (`market_cap`, `market_volume`, `btc_dominance`) partilham a mesma chamada API em cache — colocar os três na mesma página custa apenas um pedido.

---

### `[daaz_gmp_market_pulse]`

**Descrição:** Renderiza até 4 cards (Cripto, Acções, Forex, Commodities) em grelha. Dados obtidos ao vivo — sem configuração manual. Cards sem dados disponíveis são omitidos silenciosamente. Defaults configuráveis em Settings → PRO → Market Pulse.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `stocks` | `SPY` | Símbolo de acção/índice. Substitui o default das Settings |
| `forex` | `EUR/USD` | Par forex. Substitui o default das Settings |
| `commodity` | `GC.US` | Símbolo de commodity. GC.US (Ouro), SI.US (Prata), CL.US (Petróleo), HG.US (Cobre), NG.US (Gás Natural) |
| `theme` | `auto \| light \| dark` | Tema de cores (default: auto) |

**Exemplos:**
```
[daaz_gmp_market_pulse]
[daaz_gmp_market_pulse stocks="^GSPC" forex="GBP/USD"]
[daaz_gmp_market_pulse commodity="SI.US" theme="dark"]
[daaz_gmp_market_pulse stocks="NI225" forex="USD/JPY" commodity="CL.US"]
```

---

### `[daaz_gmp_chart_advanced]`

**Descrição:** Gráficos interactivos de linha e candlestick para cripto, acções e forex. Carregamento via AJAX (a página renderiza instantaneamente). Suporta múltiplas séries (até 8) dentro da mesma categoria. Zoom e pan com roda do rato/pinch.
**Providers:** CoinGecko (cripto), EODHD (acções/ETFs), TwelveData (forex). Chave API necessária para acções.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `symbol` | `bitcoin \| AAPL.US` | Símbolo único (CoinGecko ID ou ticker com sufixo) |
| `symbols` | `bitcoin,ethereum` | Múltiplas séries separadas por vírgula (substitui `symbol`, max 8) |
| `category` | `crypto \| markets \| forex` | Categoria dos activos (default: crypto) |
| `days` | `30` | Dias de histórico: 7, 14, 30, 90, 180, 365 (default: 30) |
| `type` | `line \| candle` | Tipo de gráfico. Multi-série força `line` |
| `height` | `400` | Altura em px (200-900, default: 400) |
| `show_vol` | `true \| false` | Mostrar volume abaixo do gráfico (default: true) |
| `currency` | `usd` | Moeda fiat (default: usd) |
| `title` | `` | Título sobre o gráfico. Vazio = oculto |
| `color` | `#f7931a` | Cor da série principal |

**Exemplos:**
```
[daaz_gmp_chart_advanced symbol="bitcoin" days="30"]
[daaz_gmp_chart_advanced symbol="AAPL.US" type="candle" days="90" category="markets"]
[daaz_gmp_chart_advanced symbols="bitcoin,ethereum,solana" category="crypto" days="30"]
[daaz_gmp_chart_advanced symbols="AAPL.US,MSTR.US,NVDA.US" category="markets" days="90"]
[daaz_gmp_chart_advanced symbols="EUR/USD,GBP/USD" category="forex" days="30"]
```

> **Nota:** `category="crypto"` usa CoinGecko IDs; `category="markets"` usa EODHD (ex: `GSPC.INDX` para S&P 500). Não é possível misturar categorias numa única chamada — usar dois shortcodes separados.

---

### `[daaz_gmp_btc_correlation]`

**Descrição:** Cards com o coeficiente de correlação de Pearson entre o Bitcoin e activos macro/financeiros. Calculado a partir de log-retornos diários. Sem chave API necessária — CoinGecko para BTC, Yahoo Finance para os restantes. Cache: 1 hora.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `pairs` | `gold,dxy,nasdaq,treasuries` | Chaves de activos separadas por vírgula. Disponíveis: `gold` \| `silver` \| `oil` \| `dxy` \| `nasdaq` \| `sp500` \| `treasuries` \| `vix` |
| `days` | `90` | Janela de correlação em dias: 14, 30, 60, 90, 180 (default: 90) |
| `theme` | `auto \| dark \| light` | Tema de cores (default: auto) |
| `title` | `` | Cabeçalho opcional acima dos cards. Vazio = oculto |

**Mapa de activos disponíveis:**
| Chave | Activo | Fonte (Yahoo) |
|---|---|---|
| `gold` | Ouro | GC=F |
| `silver` | Prata | SI=F |
| `oil` | Petróleo WTI | CL=F |
| `dxy` | Índice Dólar | DX-Y.NYB |
| `nasdaq` | Nasdaq Composite | ^IXIC |
| `sp500` | S&P 500 | ^GSPC |
| `treasuries` | Yield Obrigações EUA 10Y | ^TNX |
| `vix` | VIX Volatilidade | ^VIX |

**Interpretação:**
- `+0.7 a +1.0` — Correlação forte positiva (activos movem juntos)
- `+0.4 a +0.7` — Correlação positiva
- `+0.1 a +0.4` — Correlação fraca positiva
- `-0.1 a +0.1` — Sem correlação
- `-0.4 a -0.1` — Correlação fraca negativa
- `-0.7 a -0.4` — Correlação negativa
- `-1.0 a -0.7` — Correlação forte negativa (activos movem em direcções opostas)

**Exemplos:**
```
[daaz_gmp_btc_correlation]
[daaz_gmp_btc_correlation pairs="gold,dxy,nasdaq,sp500,treasuries,vix" days="90"]
[daaz_gmp_btc_correlation pairs="gold,silver,oil" days="30" theme="dark"]
[daaz_gmp_btc_correlation pairs="nasdaq,sp500" days="180" title="BTC vs Equities"]
```

---

### `[daaz_gmp_market_bar]`

**Descrição:** Barra horizontal compacta com tiles coloridos por activo — inspirada no estilo Reuters/Bloomberg. Cada tile fica verde escuro quando o activo sobe e vermelho escuro quando desce, baseado na variação de 24h. Rolagem horizontal automática.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `crypto` | `bitcoin,ethereum` | IDs CoinGecko. String vazia oculta tiles cripto |
| `gold` | `1` | `1` = mostrar tile Ouro (XAU/GC=F), `0` = ocultar |
| `silver` | `0` | `1` = mostrar tile Prata |
| `oil` | `1` | `1` = mostrar tile Petróleo WTI |
| `gas` | `0` | `1` = mostrar tile Gás Natural |
| `forex` | `EUR/USD` | Pares forex separados por vírgula |
| `treasuries` | `1` | `1` = tile BTC Corporate Treasuries (total BTC detido por empresas públicas) |
| `miner` | `MARA.US` | Tickers de mineiras separados por vírgula |
| `etf` | `IBIT.US` | Tickers de ETFs separados por vírgula |
| `theme` | `auto` | `auto` (default) \| `dark` \| `light` |

**Exemplos:**
```
[daaz_gmp_market_bar]
[daaz_gmp_market_bar crypto="bitcoin" gold="1" oil="1" forex="EUR/USD" treasuries="1" miner="MARA.US" etf="IBIT.US"]
[daaz_gmp_market_bar crypto="bitcoin,ethereum,solana" forex="EUR/USD,GBP/USD,USD/JPY" miner="MARA.US,RIOT.US,CLSK.US" etf="IBIT.US,FBTC.US"]
[daaz_gmp_market_bar crypto="bitcoin" gold="1" silver="1" oil="1" gas="1" forex="" treasuries="0" miner="" etf=""]
```

---

### `[daaz_gmp_market_tabs]`

**Descrição:** Mesmos tiles compactos que `[daaz_gmp_market_bar]` mas organizados em tabs clicáveis por categoria: Cripto, Commodities, Forex, Reservas, Mineiras, ETFs. Tabs sem dados (atributo vazio ou API indisponível) são ocultados automaticamente.

| Atributo | Exemplo | Descrição |
|---|---|---|
| `crypto` | `bitcoin,ethereum,solana,ripple,binancecoin` | IDs CoinGecko. Vazio = ocultar tab Cripto |
| `commodities` | `gold,silver,oil,copper,platinum` | Palavras-chave: gold \| silver \| oil \| brent \| copper \| platinum \| palladium \| gas \| wheat \| corn \| cocoa \| coffee |
| `forex` | `EUR/USD,GBP/USD,USD/JPY,AUD/USD,USD/CHF` | Pares forex. Vazio = ocultar tab Forex |
| `treasuries` | `10` | Nº de empresas no tab Reservas (top N por BTC detido). `0` = ocultar. Default: 10 |
| `miners` | `MARA.US,RIOT.US,CLSK.US,HUT.US,BITF.US` | Tickers de mineiras com sufixo `.US`. Vazio = ocultar |
| `etfs` | `IBIT.US,FBTC.US,ETHA.US,SPY.US,QQQ.US` | Tickers de ETFs com sufixo `.US`. Vazio = ocultar |
| `active` | `crypto` | Tab aberto por defeito: `crypto` \| `commodities` \| `forex` \| `treasuries` \| `miners` \| `etfs` |
| `theme` | `auto` | `auto` \| `dark` \| `light` |

**Exemplos:**
```
[daaz_gmp_market_tabs]
[daaz_gmp_market_tabs active="commodities"]
[daaz_gmp_market_tabs crypto="bitcoin,ethereum,solana,cardano,dogecoin" commodities="gold,silver,oil,brent,copper,platinum" forex="EUR/USD,GBP/USD,USD/JPY,AUD/USD,USD/CHF"]
[daaz_gmp_market_tabs treasuries="0" miners="" etfs="" active="forex"]
```

---

## Notas gerais

- **Sem dados?** Verifica as chaves API em Settings → Providers & Cache e limpa os transients em Tools → Cache.
- **Commodities/Forex** nos shortcodes PRO (`market_bar`, `market_tabs`): usam Yahoo Finance — sem chave necessária.
- **Cripto** em todos os shortcodes: CoinGecko free tier — sem chave.
- **Acções, ETFs, Mineiras:** requerem chave EODHD, TwelveData, Finnhub ou Polygon configurada em Settings.
- **Cache:** por omissão 5-15 minutos (configurável em Settings → Providers & Cache). Override por shortcode com `ttl=`.