Autenticación

Autenticación

La API de CoinBoss es pública. No se necesita una cuenta ni una clave de API para llamar a ningún endpoint de datos.

No requiere clave

Llame a cualquier endpoint del catálogo con un simple GET por HTTPS. Las solicitudes anónimas se limitan por dirección IP: 1200 solicitudes por minuto.

curl -s "https://www.coinboss.com/api/sd/oi?coin=BTC"

Clave de API opcional

Si varios de sus servicios comparten una misma dirección IP, o si llama desde una red cuya dirección cambia, puede crear una clave en su cuenta y enviarla en la cabecera CB-API-KEY. Una solicitud con una clave válida se contabiliza contra la clave y no contra la dirección IP.

  • Las claves se crean y se revocan en la página de claves de API de su cuenta. Se requiere una dirección de correo electrónico verificada.
  • La clave completa se muestra una sola vez, al crearla. Solo se almacena un hash, por lo que no puede volver a mostrarse.
  • Cada cuenta puede tener hasta cinco claves activas.
  • Una clave desconocida o revocada se ignora: la solicitud se atiende como anónima y se contabiliza contra la dirección IP.

Gestionar claves de API

Solicitud con clave

curl -s "https://www.coinboss.com/api/sd/oi?coin=BTC" \
  -H "CB-API-KEY: $COINBOSS_API_KEY"

Niveles del límite de solicitudes

Todos los niveles devuelven los mismos datos. Durante el actual periodo gratuito, el tráfico anónimo y todas las claves se atienden en el nivel más alto.

NivelSolicitudes por minuto
hobbyist30
startup80
standard300
professional1200vigente para todos

Proteger las claves

  • Trate una clave como una contraseña. Guárdela en una variable de entorno o en un almacén de secretos, no en el código fuente.
  • No incluya una clave en una página web, una extensión de navegador ni una aplicación móvil. Todo lo que se distribuye a un cliente puede ser leído por sus usuarios. Llame a la API desde su servidor, o hágalo de forma anónima desde el navegador.
  • Revoque una clave en cuanto sospeche que se ha filtrado y cree una nueva.
  • CoinBoss nunca solicita claves de API de exchanges. Los datos se recopilan de endpoints públicos de los exchanges, y esta API no necesita ni acepta ninguna credencial de exchange.

Llamadas desde un navegador

Las respuestas incluyen Access-Control-Allow-Origin: *, por lo que los endpoints de datos pueden llamarse desde cualquier origen web. Las cabeceras X-Request-Id, X-Cache y X-RateLimit-* están expuestas a los scripts.

Endpoints de cuenta

Los endpoints bajo /api/user y /api/auth pertenecen a la experiencia del sitio web con sesión iniciada (listas de seguimiento, preferencias, gestión de claves). Usan la sesión del sitio, no forman parte de la API pública de datos y no figuran en el catálogo.