Coloque as ferramentas de cripto ao vivo da Bitculator diretamente no seu próprio site com um único <iframe> — um gráfico de preços em tempo real, um conversor, um flipper de marketcap e seis calculadoras. Sem SDK, sem etapa de build.
9 widgetsChave de embed + domínioModo anônimo
Cada widget é uma página autônoma em /{locale}/embed/… que você insere no seu site com um <iframe>. Ela renderiza os dados de mercado ao vivo da Bitculator — o mesmo feed que o app usa — e não requer JavaScript do seu lado.
Cole em qualquer lugar — nenhuma tag de script necessária:
Adicione a sua chave de embed como um parâmetro de consulta e registre o domínio onde vai incorporar (ambos no seu console de desenvolvedor). Embeds sem chave também funcionam em modo anônimo — útil para um teste rápido — mas são limitados por IP de visitante. Cada widget respeita o {locale} na URL e segue o cookie theme (ou ?theme=dark).
Content-Security-Policy
Está a servir uma Content-Security-Policy no seu site? Adicione https://bitculator.com ao seu frame-src (e child-src para navegadores mais antigos) para que o widget possa carregar. Nada a alterar do nosso lado — o Bitculator já permite a incorporação em qualquer domínio.
Uma chave de embed é um token com a capacidade api, gerado no seu console de desenvolvedor. Ao contrário das chaves da Data API, ela viaja na URL do iframe como um parâmetro de consulta — nunca em um cabeçalho — então é pública por design. Ela carrega apenas a capacidade api; as chaves data-api (exclusivamente Bearer) são rejeitadas aqui para que não vazem para referers ou logs.
Passe-a como ?embed_key=… (ou o alias ?api_key=…). Uma requisição com chave também precisa vir de um domínio na lista de permissões (veja abaixo). Se você estiver logado na Bitculator no mesmo navegador, a verificação da chave é ignorada para a sua própria sessão.
Domínios
Um embed com chave só renderiza em domínios que você registrou. A Bitculator lê o Referer da página incorporadora (recorrendo ao Origin), normaliza-o (em minúsculas, com www. e qualquer ponto final removidos) e compara-o exatamente com a sua lista de permissões. Um host não registrado ou ilegível retorna 403.
Gerencie domínios no seu console de desenvolvedor; cada plano permite um número definido (abaixo). Como o Referer/Origin é definido pelo navegador do visitante e pode ser falsificado, a lista de permissões é uma proteção contra a reutilização casual de chaves, não uma prova criptográfica — trate a chave como pública de qualquer forma. Embeds anônimos (sem chave) não são restringidos por domínio; em vez disso, são limitados por IP.
Cota e limites
Os embeds usam um pool mensal totalmente separado da Data API — seu próprio plano, seu próprio contador. Carregamentos anônimos contam por IP de visitante (1,000/mês); carregamentos com chave contam contra o limite mensal do seu plano. Planos Free reiniciam no mês do calendário; planos pagos reiniciam no seu dia de faturamento.
*As respostas de embed não carregam cabeçalhos `X-Quota-** — deliberadamente, para que os números de cota nunca vazem para as páginas dos seus visitantes. Em vez disso, acompanhe o seu uso no [console de desenvolvedor](/user/developer/api). (Os cabeçalhosX-Quota-*` que você talvez tenha visto estão apenas na Data API.)
Acima do limite
Quando um widget excede a cota, ele retorna 429. Em um iframe de navegador, essa é uma pequena página estilizada de "limite de uso atingido" (para que o seu layout não quebre); um chamador JSON recebe {"message", "limit", "used"}. Adicione uma chave, ou faça upgrade do seu plano, para mais.
Planos
Os planos de embed são separados do seu plano da Data API. Cada conta começa no Free; visitantes sem chave recebem o nível anônimo.
Plano
Carregamentos / mês
Domínios
Chaves
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anônimo
1,000 por IP
—
—
Anônimo é o nível sem chave — sem domínios ou chaves, limitado por IP de visitante. Faça upgrade no console de desenvolvedor.
Widgets
Nove widgets prontos a usar. Copie um trecho, insira a sua chave, registre o seu domínio — pronto. Segmentos de caminho (como o slug de uma moeda) resolvem pelo slug do ativo e devem ser um mercado ativo; cada widget também aceita os parâmetros de consulta compartilhados abaixo.
GET
Conversor de moedas
/{locale}/embed/converter/bitcoin/usd
Converta um valor entre quaisquer dois ativos cripto ou fiduciários a taxas de mercado ao vivo, com uma tabela de comparação opcional.