Bitnovo Developers

Documentación de la API pública

La API de Bitnovo permite consultar el estado del servicio, obtener tipos de cambio y crear suscripciones para integraciones profesionales. Esta página reúne la autenticación, los permisos, los endpoints y ejemplos de solicitudes en un formato accesible sin JavaScript.

Autenticación OAuth 2.0

Las integraciones privadas aprobadas utilizan el flujo OAuth 2.0 Client Credentials. Solicita credenciales a Bitnovo, obtiene el token en el endpoint autorizado y envía ese token como Bearer en las solicitudes protegidas. El contrato de descubrimiento se publica en /.well-known/oauth-authorization-server y anuncia el endpoint de token y sus permisos. Los endpoints públicos de esta página no requieren token; no incluyas secretos en el navegador ni en repositorios públicos.

Permisos disponibles

health:read para consultar el estado de la API.
rates:read para consultar tipos de cambio.
subscriptions:write para crear suscripciones.

Endpoints públicos

Método	Endpoint	Acceso
`GET`	`/api/health`	Público
`POST`	`/api/v1/exchange-rates`	Público
`POST`	`/api/subscribe`	Público

Consulta el contrato completo para conocer parámetros, respuestas y requisitos de cada operación. Las integraciones privadas reciben scopes aprobados por Bitnovo; las operaciones públicas actuales no requieren token.

Ejemplos de solicitudes

curl https://www.bitnovo.com/api/health \
  -H "Accept: application/json"

curl https://www.bitnovo.com/api/v1/exchange-rates \
  -H "Content-Type: application/json" \
  -d '{"cryptos":["BTC","ETH"]}'

# Integración privada con credenciales emitidas por Bitnovo
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d scope=rates:read \
  https://www.bitnovo.com/oauth/token