SWCore / Componentes / Cotação

Cotação Componentes

Widget de câmbio ao vivo (dólar, euro, bitcoin...) via API pública gratuita.

O que é

Mostra cotações de moedas atualizadas, em cards ou tabela — usa a AwesomeAPI pública, sem precisar de chave/token.

Como funciona

Busca economia.awesomeapi.com.br/last/{pares} ao carregar (e a cada intervalo, se sw-cotacao-auto estiver definido) e renderiza os pares pedidos.

Exemplos

1. Padrão — Cards Ao vivo
<div sw-cotacao sw-cotacao-pares="USD-BRL,EUR-BRL,BTC-BRL,ETH-BRL" sw-cotacao-auto="30000"></div>
2. Modo Tabela — compra, venda, variação, máx/mín Ao vivo
<div sw-cotacao sw-cotacao-pares="USD-BRL,EUR-BRL,GBP-BRL,BTC-BRL" sw-cotacao-mode="table" sw-cotacao-auto="60000"></div>
3. Compra (bid) vs Venda (ask) Ao vivo

sw-cotacao-tipo="c" (padrão)

sw-cotacao-tipo="v"

<!-- Compra (bid) — padrão -->
<div sw-cotacao sw-cotacao-pares="USD-BRL,EUR-BRL" sw-cotacao-tipo="c"></div>

<!-- Venda (ask) -->
<div sw-cotacao sw-cotacao-pares="USD-BRL,EUR-BRL" sw-cotacao-tipo="v"></div>
4. Pares Suportados — Américas Ao vivo
CódigoNomePaís / Região
USD-BRLDólar AmericanoEstados Unidos
CAD-BRLDólar CanadenseCanadá
ARS-BRLPeso ArgentinoArgentina
CLP-BRLPeso ChilenoChile
COP-BRLPeso ColombianoColômbia
PEN-BRLSol PeruanoPeru
UYU-BRLPeso UruguaioUruguai
MXN-BRLPeso MexicanoMéxico
<table class="sw-cotacao-table"><thead><tr><th>Código</th><th>Nome</th><th>País / Região</th></tr></thead><tbody>
<tr><td class="sw-cotacao-tcod">USD-BRL</td><td>Dólar Americano</td><td>Estados Unidos</td></tr>
<tr><td class="sw-cotacao-tcod">CAD-BRL</td><td>Dólar Canadense</td><td>Canadá</td></tr>
<tr><td class="sw-cotacao-tcod">ARS-BRL</td><td>Peso Argentino</td><td>Argentina</td></tr>
<tr><td class="sw-cotacao-tcod">CLP-BRL</td><td>Peso Chileno</td><td>Chile</td></tr>
<tr><td class="sw-cotacao-tcod">COP-BRL</td><td>Peso Colombiano</td><td>Colômbia</td></tr>
<tr><td class="sw-cotacao-tcod">PEN-BRL</td><td>Sol Peruano</td><td>Peru</td></tr>
<tr><td class="sw-cotacao-tcod">UYU-BRL</td><td>Peso Uruguaio</td><td>Uruguai</td></tr>
<tr><td class="sw-cotacao-tcod">MXN-BRL</td><td>Peso Mexicano</td><td>México</td></tr>
</tbody></table>
5. Pares Suportados — Europa Ao vivo
CódigoNomePaís / Região
EUR-BRLEuroZona Euro
GBP-BRLLibra EsterlinaReino Unido
CHF-BRLFranco SuíçoSuíça
NOK-BRLCoroa NorueguesaNoruega
SEK-BRLCoroa SuecaSuécia
DKK-BRLCoroa DinamarquesaDinamarca
PLN-BRLZłoty PolonêsPolônia
RUB-BRLRublo RussoRússia
TRY-BRLLira TurcaTurquia
<table class="sw-cotacao-table"><thead><tr><th>Código</th><th>Nome</th><th>País / Região</th></tr></thead><tbody>
<tr><td class="sw-cotacao-tcod">EUR-BRL</td><td>Euro</td><td>Zona Euro</td></tr>
<tr><td class="sw-cotacao-tcod">GBP-BRL</td><td>Libra Esterlina</td><td>Reino Unido</td></tr>
<tr><td class="sw-cotacao-tcod">CHF-BRL</td><td>Franco Suíço</td><td>Suíça</td></tr>
<tr><td class="sw-cotacao-tcod">NOK-BRL</td><td>Coroa Norueguesa</td><td>Noruega</td></tr>
<tr><td class="sw-cotacao-tcod">SEK-BRL</td><td>Coroa Sueca</td><td>Suécia</td></tr>
<tr><td class="sw-cotacao-tcod">DKK-BRL</td><td>Coroa Dinamarquesa</td><td>Dinamarca</td></tr>
<tr><td class="sw-cotacao-tcod">PLN-BRL</td><td>Złoty Polonês</td><td>Polônia</td></tr>
<tr><td class="sw-cotacao-tcod">RUB-BRL</td><td>Rublo Russo</td><td>Rússia</td></tr>
<tr><td class="sw-cotacao-tcod">TRY-BRL</td><td>Lira Turca</td><td>Turquia</td></tr>
</tbody></table>
6. Pares Suportados — Ásia & Oceania Ao vivo
CódigoNomePaís / Região
JPY-BRLIene JaponêsJapão
CNY-BRLYuan ChinêsChina
AUD-BRLDólar AustralianoAustrália
NZD-BRLDólar NeozelandêsNova Zelândia
SGD-BRLDólar de SingapuraSingapura
HKD-BRLDólar de Hong KongHong Kong
KRW-BRLWon Sul-CoreanoCoreia do Sul
INR-BRLRúpia IndianaÍndia
<table class="sw-cotacao-table"><thead><tr><th>Código</th><th>Nome</th><th>País / Região</th></tr></thead><tbody>
<tr><td class="sw-cotacao-tcod">JPY-BRL</td><td>Iene Japonês</td><td>Japão</td></tr>
<tr><td class="sw-cotacao-tcod">CNY-BRL</td><td>Yuan Chinês</td><td>China</td></tr>
<tr><td class="sw-cotacao-tcod">AUD-BRL</td><td>Dólar Australiano</td><td>Austrália</td></tr>
<tr><td class="sw-cotacao-tcod">NZD-BRL</td><td>Dólar Neozelandês</td><td>Nova Zelândia</td></tr>
<tr><td class="sw-cotacao-tcod">SGD-BRL</td><td>Dólar de Singapura</td><td>Singapura</td></tr>
<tr><td class="sw-cotacao-tcod">HKD-BRL</td><td>Dólar de Hong Kong</td><td>Hong Kong</td></tr>
<tr><td class="sw-cotacao-tcod">KRW-BRL</td><td>Won Sul-Coreano</td><td>Coreia do Sul</td></tr>
<tr><td class="sw-cotacao-tcod">INR-BRL</td><td>Rúpia Indiana</td><td>Índia</td></tr>
</tbody></table>
7. Pares Suportados — Criptomoedas Ao vivo
CódigoNome
BTC-BRLBitcoin
ETH-BRLEthereum
LTC-BRLLitecoin
XRP-BRLRipple
DOGE-BRLDogecoin
SOL-BRLSolana
ADA-BRLCardano
DOT-BRLPolkadot
MATIC-BRLPolygon
LINK-BRLChainlink
XLM-BRLStellar
ATOM-BRLCosmos
<table class="sw-cotacao-table"><thead><tr><th>Código</th><th>Nome</th></tr></thead><tbody>
<tr><td class="sw-cotacao-tcod">BTC-BRL</td><td>Bitcoin</td></tr>
<tr><td class="sw-cotacao-tcod">ETH-BRL</td><td>Ethereum</td></tr>
<tr><td class="sw-cotacao-tcod">LTC-BRL</td><td>Litecoin</td></tr>
<tr><td class="sw-cotacao-tcod">XRP-BRL</td><td>Ripple</td></tr>
<tr><td class="sw-cotacao-tcod">DOGE-BRL</td><td>Dogecoin</td></tr>
<tr><td class="sw-cotacao-tcod">SOL-BRL</td><td>Solana</td></tr>
<tr><td class="sw-cotacao-tcod">ADA-BRL</td><td>Cardano</td></tr>
<tr><td class="sw-cotacao-tcod">DOT-BRL</td><td>Polkadot</td></tr>
<tr><td class="sw-cotacao-tcod">MATIC-BRL</td><td>Polygon</td></tr>
<tr><td class="sw-cotacao-tcod">LINK-BRL</td><td>Chainlink</td></tr>
<tr><td class="sw-cotacao-tcod">XLM-BRL</td><td>Stellar</td></tr>
<tr><td class="sw-cotacao-tcod">ATOM-BRL</td><td>Cosmos</td></tr>
</tbody></table>

Atributos

sw-cotacao-pares
pares separados por vírgula, ex.: "USD-BRL,EUR-BRL,BTC-BRL"
sw-cotacao-tipo
"c" (compra, padrão) ou "v" (venda) — só no modo cards
sw-cotacao-mode
"cards" (padrão) ou "table"
sw-cotacao-auto
intervalo de atualização automática em ms

Variantes

sw-cotacao-mode="cards"
padrão — compacto, ideal para widgets e barras de cotação
sw-cotacao-mode="table"
completo — mostra compra, venda, variação, máxima e mínima do dia lado a lado

Eventos

Nenhum.

API (JavaScript)

Nenhum.

Requisitos

  • Precisa de acesso à internet e à API economia.awesomeapi.com.br (sem chave, mas sujeita ao limite de uso gratuito deles).

Limitações — o que ele não faz

  • Depende de uma API pública de terceiro (AwesomeAPI) — se ela ficar fora do ar, mostra "Cotação indisponível" (com tratamento de erro, não quebra a página).