Índice de prima de Bitcoin de Coinbase
Índice de prima de Bitcoin de Coinbase
/api/p3/coinbase-premiumSolicitud
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Valor por defecto | Valores admitidos | Descripción |
|---|---|---|---|---|---|
| range | string | Opcional | 24h | 24h, 7d, 3m, 1y, 3y, all | Ventana temporal. Ejemplo: 24h |
Solicitud de ejemplo
curl -s "https://www.coinboss.com/api/p3/coinbase-premium?range=24h"Campos de la respuesta
La tabla de campos se genera a partir de respuestas reales, por lo que recoge exactamente lo que devuelve el endpoint. Las rutas usan a[] para los elementos de un array y {*} para los objetos cuya clave es un nombre dinámico, como una moneda o un exchange.
| Campo | Tipo | Unidad | Descripción |
|---|---|---|---|
| success | boolean | — | true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`. |
| now | number | ms | Hora del servidor en el momento de generar la respuesta. |
| range | string | — | Ventana solicitada. |
| latest | object | — | Registro más reciente. |
| latest.ts | number | ms | Marca de tiempo. |
| latest.cb | number | USD | Precio de BTC-USD en Coinbase del último punto de `series`. |
| latest.bn | number | USDT | Precio spot de BTCUSDT en Binance del último punto de `series`. |
| latest.gap | number | — | Diferencia de precio. |
| latest.gap_pct | number | % | Diferencia de precio. |
| series | array | — | Serie temporal. |
| series[] | object | — | Serie temporal. |
| series[].ts | number | ms | Marca de tiempo. |
| series[].cb | number | USD | Precio de BTC-USD en Coinbase: media del tramo (tramos de 1 minuto para `24h` y de 15 minutos para `7d`) o cierre diario en los rangos más largos. |
| series[].bn | number | USDT | Precio spot de BTCUSDT en Binance: media del tramo (tramos de 1 minuto para `24h` y de 15 minutos para `7d`) o cierre diario en los rangos más largos. |
| series[].gap | number | — | Diferencia de precio. |
| series[].gap_pct | number | % | Diferencia de precio. |
Generada 2026-11-11 23:00 UTC a partir de 1 respuestas reales.
Respuesta de ejemplo
/api/p3/coinbase-premium?range=24h · Respuesta real capturada 2026-11-13 04:02:46 UTC. Los arrays y mapas largos se abrevian para su visualización: series tenía 1440 elementos.
- "success"true
- "now"1794542566952
- "range""24h"
- "latest"
- "ts"1794542520000
- "cb"68655.16
- "bn"68731
- "gap"-75.84
- "gap_pct"-0.1103
- "series"
Detalles
- Autenticación
- Ninguna. Endpoint público.
- Límite de solicitudes
- 1200 solicitudes por minuto por IP
- Caché del servidor
- 60s
- Microcaché de borde
- 10s
- Frecuencia de actualización
- cada 1 min (ticks intradía); la serie diaria se actualiza cada 6 horas
- Ventana
- `range` = 24h (tramos de 1 min, por defecto), 7d (tramos de 15 min), 3m / 1y / 3y / all (cierres diarios)
- Fuentes de datos
- Índice de prima de Coinbase calculado internamente a partir de los precios públicos de BTC de ambos exchanges.
- Cobertura de exchanges
- Solo BTC; compara cotizaciones en USD con cotizaciones en USDT, por lo que incorpora cualquier desviación USDT/USD.
- Ordenación
- hora ascendente
- Unidades
- USD (gap) and percent (gap_pct)
- Método
- gap = Coinbase BTC-USD price - Binance BTCUSDT price; gap_pct = gap / Binance price x 100; intraday buckets are averages.
- Marcas de tiempo
- Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
- Formato de respuesta
- json
- Estabilidad
- Estable
Estado en vivo
Disponibilidad, últimos 30 días
100% de 411 comprobaciones superadas
Errores
Las llamadas fallidas tienen la misma estructura en todos los endpoints. La lista completa está en la página de errores. Errores y límites de solicitudes →
| Código | HTTP | Significado | Qué hacer |
|---|---|---|---|
| INVALID_PARAM | 400 | Falta un parámetro obligatorio o un valor no se acepta. `param` indica el nombre del parámetro cuando se conoce. | No reintente sin cambios; corrija la solicitud. |
| UNAUTHORIZED | 401 | Se envió la cabecera `CB-API-KEY`, pero la clave es desconocida o está revocada. Los datos públicos no necesitan clave: elimine la cabecera o use una clave válida. | No reintente sin cambios. |
| FORBIDDEN | 403 | La ruta no forma parte de la API pública (interna o solo para cuentas). | No reintente. |
| NOT_FOUND | 404 | Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe. | No reintente; compruebe la ruta y los identificadores en el catálogo. |
| RATE_LIMITED | 429 | Más solicitudes que el límite por minuto. `Retry-After` indica los segundos de espera. | Espere el tiempo de `Retry-After` y después reintente con espera progresiva. |
| INTERNAL | 500 | Error inesperado del servidor. El mensaje es genérico por diseño; cite `request_id` al informar del error. | Reintente una vez tras unos segundos; si persiste, infórmelo con el ID de solicitud. |
| UPSTREAM_FAILED | 503 | La fuente de datos de este endpoint no respondió a tiempo. No se devuelven cifras desactualizadas ni sustitutas en su lugar. | Reintente con espera progresiva; consulte la página de estado. |
| UNAVAILABLE | 501 / 503 | El conjunto de datos no está listo temporalmente (calentamiento de la caché) o el endpoint aún no tiene una fuente pública lícita. | Reintente más tarde; el catálogo marca los endpoints que no están disponibles por diseño. |
| REQUEST_FAILED | 200 | Algunos endpoints antiguos responden HTTP 200 con `success: false`. Compruebe siempre `success`, no solo el estado HTTP. | Depende del mensaje; trátelo como una solicitud fallida. |
Pruébelo
/api/p3/coinbase-premiumDisponiblestring · por defecto 24h — Time window.
https://www.coinboss.com/api/p3/coinbase-premium?range=24hMás en esta categoría
- Base de futuros (todas las plataformas) /api/sd/basis
- Historial de la base (horario) /api/sd/basis/history
- Monedas ordenadas por base /api/sd/basis/rank
- Lista de base futuros-spot /api/derivatives/basis
- Diferencial diario del precio de BTC entre Coinbase y Kraken /api/p3/cb-kr-spread
- Índice de prima de Bitcoin de Coinbase /api/p3/coinbase-premium
- Lista del índice de prima de perpetuos /api/p3/premium-index
- Historial del índice de prima de una moneda /api/p3/premium-index/history
- Velas del índice de prima /api/p3/premium-index/klines
- Prima OTC de USDT frente a los tipos de cambio fiat /api/usdt-premium
- Lista completa de base futuros-spot /api/basis/list