Pon las herramientas cripto en vivo de Bitculator directamente en tu propio sitio con un solo <iframe> — un gráfico de precios en tiempo real, un conversor, un comparador de marketcap y seis calculadoras. Sin SDK, sin paso de compilación.
9 widgetsClave de embed + dominioModo anónimo
Cada widget es una página autónoma en /{locale}/embed/… que colocas en tu sitio con un <iframe>. Renderiza los datos de mercado en vivo de Bitculator — el mismo feed que usa la app — y no necesita JavaScript por tu parte.
Pégalo donde quieras — sin necesidad de una etiqueta script:
Añade tu clave de embed como parámetro de consulta y registra el dominio en el que vas a embeber (ambas cosas en tu consola de desarrollador). Los embeds sin clave también funcionan en modo anónimo — práctico para una prueba rápida — pero están limitados por IP de visitante. Cada widget respeta el {locale} de la URL y sigue la cookie theme (o ?theme=dark).
Content-Security-Policy
¿Sirves una Content-Security-Policy en tu sitio? Añade https://bitculator.com a tu frame-src (y a child-src para navegadores antiguos) para que el widget pueda cargarse. No hay nada que cambiar por nuestra parte — Bitculator ya permite la incrustación en cualquier dominio.
Una clave de embed es un token con la habilidad api, generado en tu consola de desarrollador. A diferencia de las claves de la Data API, viaja en la URL del iframe como parámetro de consulta — nunca en una cabecera — por lo que es pública por diseño. Solo lleva la habilidad api; las claves data-api (solo Bearer) se rechazan aquí para que no puedan filtrarse en referers o registros.
Pásala como ?embed_key=… (o el alias ?api_key=…). Una petición con clave también debe provenir de un dominio de la lista de permitidos (ver abajo). Si has iniciado sesión en Bitculator en el mismo navegador, la comprobación de la clave se omite para tu propia sesión.
Dominios
Un embed con clave solo renderiza en los dominios que hayas registrado. Bitculator lee el Referer de la página que embebe (recurriendo a Origin), lo normaliza (en minúsculas, eliminando www. y cualquier punto final) y lo compara exactamente con tu lista de permitidos. Un host no registrado o ilegible devuelve 403.
Gestiona los dominios en tu consola de desarrollador; cada plan permite un número determinado (abajo). Como Referer/Origin lo establece el navegador del visitante y puede falsificarse, la lista de permitidos es una protección contra la reutilización casual de la clave, no una prueba criptográfica — trata la clave como pública en cualquier caso. Los embeds anónimos (sin clave) no están restringidos por dominio; en su lugar están limitados por IP.
Cuota y límites
Los embeds consumen de un pool mensual completamente separado de la Data API — su propio plan, su propio contador. Las cargas anónimas cuentan por IP de visitante (1,000/mes); las cargas con clave cuentan contra el límite mensual de tu plan. Los planes gratuitos se reinician con el mes natural; los planes de pago se reinician en tu día de facturación.
*Las respuestas de embed no llevan cabeceras `X-Quota-** — deliberadamente, para que los números de cuota nunca se filtren en las páginas de tus visitantes. En su lugar, controla tu uso en la [consola de desarrollador](/user/developer/api). (Las cabecerasX-Quota-*` que puedas haber visto están solo en la Data API.)
Sobre el límite
Cuando un widget supera la cuota devuelve 429. En un iframe de navegador es una pequeña página con estilo de «límite de uso alcanzado» (para que tu diseño no se rompa); una llamada JSON recibe {"message", "limit", "used"}. Añade una clave, o mejora tu plan, para más.
Planes
Los planes de embed son independientes de tu plan de la Data API. Cada cuenta empieza en Free; los visitantes sin clave obtienen el nivel anónimo.
Plan
Cargas / mes
Dominios
Claves
Free
10,000
1
2
Starter
50,000
3
5
Pro
500,000
10
10
Anónimo
1,000 por IP
—
—
Anónimo es el nivel sin clave — sin dominios ni claves, limitado por IP de visitante. Mejora en la consola de desarrollador.
Widgets
Nueve widgets listos para usar. Copia un snippet, sustituye tu clave, registra tu dominio — listo. Los segmentos de ruta (como el slug de una coin) se resuelven por el slug del activo y deben ser un mercado activo; cada widget también acepta los parámetros de consulta compartidos de abajo.
GET
Conversor de divisas
/{locale}/embed/converter/bitcoin/usd
Convierte una cantidad entre dos activos cripto o fiat cualesquiera a precios de mercado en vivo, con una tabla de comparación opcional.