Volumen 24h—Interés abierto—Liquidaciones 24h$1.36BLargo/Corto 24h—Dominancia BTC—Dominancia ETH—
App
Idioma ▾
€ EUR ▾
/api/sd/funding
GETDisponible

Financiación de una moneda

Capa de datos propia: financiación de una moneda (normalizada a 8h, ponderada)

GET/api/sd/funding

Solicitud

Parámetros de consulta

NombreTipoObligatorioValor por defectoValores admitidosDescripción
coinstringObligatorio——Símbolo de la moneda; 400 cuando falta. Alias: `base`. Ejemplo: BTC

Solicitud de ejemplo

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

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.

CampoTipoUnidadDescripción
successboolean—true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`.
coinstring—Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
nownumbermsHora del servidor en el momento de generar la respuesta.
unitstring—Unidad de todos los campos de tasa de esta respuesta: `fraction` (0.0001 = 0.01 %).
avg_8hnumberfraction per 8hMedia simple de las tasas normalizadas a 8h, con un contrato por exchange.
oi_weighted_8hnumberfraction per 8hMedia ponderada por interés abierto de las tasas normalizadas a 8h.
apr_pctnumber% per yearAnualización simple: tasa de 8h × 3 × 365 × 100.
apr_basisstring—Agregado en el que se basa el `apr_pct` principal.
n_exchangesnumber—Número de exchanges que aportan datos.
n_normalizednumber—Exchanges cuyo intervalo de financiación se conoce y pudo normalizarse a 8h.
n_unknown_intervalnumber—Exchanges excluidos de los agregados porque se desconoce su intervalo de financiación.
settled_cum_7dobject—Suma de las tasas de financiación efectivamente liquidadas en los últimos 7 días, promediada entre los exchanges con historial de pagos.
settled_cum_7d.avgnumberfractionMedia simple entre exchanges.
settled_cum_7d.oi_weightednumberfractionMedia ponderada por interés abierto.
settled_cum_7d.nnumber—Exchanges con una ventana completa.
settled_cum_30dobject—Lo mismo, a 30 días.
settled_cum_30d.avgnumberfractionMedia simple entre exchanges.
settled_cum_30d.oi_weightednumberfractionMedia ponderada por interés abierto.
settled_cum_30d.nnumber—Exchanges con una ventana completa.
by_exchangearray—Una fila por exchange: su contrato principal para esta moneda (el de mayor interés abierto).
by_exchange[]object—Desglose por exchange.
by_exchange[].exchangestring—Id del exchange, en minúsculas (por ejemplo `binance`).
by_exchange[].symbolstring—Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
by_exchange[].marginstring—Clase de moneda de margen.
by_exchange[].kindstring—Clase.
by_exchange[].primaryboolean—true para el contrato que representa al exchange en los agregados.
by_exchange[].ratenumber—Tasa de financiación del periodo en curso tal como la publica el exchange.
by_exchange[].interval_hnumberhIntervalo de financiación.
by_exchange[].rate_8hnumber—Tasa normalizada a un periodo de 8 horas: tasa × 8 / interval_h.
by_exchange[].apr_pctnumber% per yearPorcentaje anualizado.
by_exchange[].next_funding_timenumber|nullmsHora del próximo pago.
by_exchange[].next_derivedboolean—true cuando la hora del próximo pago se derivó del intervalo en lugar de ser publicada por el exchange.
by_exchange[].predicted_ratenull—Tasa indicativa del próximo periodo cuando el exchange la publica; en caso contrario, null.
by_exchange[].oi_usdnumber|nullUSDInterés abierto en nocional USD.
by_exchange[].updated_atnumbermsMomento de la última actualización de esta fila.
by_exchange[].age_snumbersSegundos transcurridos desde la última actualización de esta fila.
by_exchange[].is_staleboolean—true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
by_exchange[].settledobject|null—Registros de pagos reales de este contrato; null cuando el exchange no tiene historial público.
by_exchange[].settled.last_ratenumber—Tasa del pago más reciente. puede faltar
by_exchange[].settled.last_timenumbermsHora del pago más reciente. puede faltar
by_exchange[].settled.interval_hnumberhIntervalo de financiación. puede faltar
by_exchange[].settled.cum_7dnumber—Suma de las tasas liquidadas en los últimos 7 días. puede faltar
by_exchange[].settled.n_7dnumber—Pagos encontrados en los últimos 7 días. puede faltar
by_exchange[].settled.n_7d_expectednumber—Pagos esperados en 7 días con este intervalo. puede faltar
by_exchange[].settled.cum_7d_completeboolean—true cuando no falta ningún pago en la ventana de 7 días. puede faltar
by_exchange[].settled.cum_30dnumber—Suma de las tasas liquidadas en los últimos 30 días. puede faltar
by_exchange[].settled.n_30dnumber—Pagos encontrados en los últimos 30 días. puede faltar
by_exchange[].settled.n_30d_expectednumber—Pagos esperados en 30 días con este intervalo. puede faltar
by_exchange[].settled.cum_30d_completeboolean—true cuando no falta ningún pago en la ventana de 30 días. puede faltar
by_exchange[].settled.history_fromnumbermsRegistro de pago más antiguo conservado de este contrato. puede faltar
other_contractsarray—Otros contratos de la misma moneda (USDC, con margen en moneda, …). No forman parte de los agregados.
other_contracts[]object—Un contrato de financiación adicional de un exchange (con margen en moneda, USDC, …) que no es su contrato principal y se excluye de los agregados.
other_contracts[].exchangestring—Id del exchange, en minúsculas (por ejemplo `binance`).
other_contracts[].symbolstring—Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
other_contracts[].marginstring—Clase de moneda de margen.
other_contracts[].kindstring—Clase.
other_contracts[].primaryboolean—true para el contrato que representa al exchange en los agregados.
other_contracts[].ratenumber—Tasa de financiación del periodo en curso tal como la publica el exchange.
other_contracts[].interval_hnumber|nullhIntervalo de financiación.
other_contracts[].rate_8hnumber|null—Tasa normalizada a un periodo de 8 horas: tasa × 8 / interval_h.
other_contracts[].apr_pctnumber|null% per yearPorcentaje anualizado.
other_contracts[].next_funding_timenumber|nullmsHora del próximo pago.
other_contracts[].next_derivedboolean—true cuando la hora del próximo pago se derivó del intervalo en lugar de ser publicada por el exchange.
other_contracts[].predicted_ratenumber|null—Tasa indicativa del próximo periodo cuando el exchange la publica; en caso contrario, null.
other_contracts[].oi_usdnumber|nullUSDInterés abierto en nocional USD.
other_contracts[].updated_atnumbermsMomento de la última actualización de esta fila.
other_contracts[].age_snumbersSegundos transcurridos desde la última actualización de esta fila.
other_contracts[].is_staleboolean—true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
other_contracts[].settledobject|null—Registros de pagos reales de este contrato; null cuando el exchange no tiene historial público.
other_contracts[].settled.last_ratenumber—Tasa del pago más reciente. puede faltar
other_contracts[].settled.last_timenumbermsHora del pago más reciente. puede faltar
other_contracts[].settled.interval_hnumberhIntervalo de financiación. puede faltar
other_contracts[].settled.cum_7dnumber—Suma de las tasas liquidadas en los últimos 7 días. puede faltar
other_contracts[].settled.n_7dnumber—Pagos encontrados en los últimos 7 días. puede faltar
other_contracts[].settled.n_7d_expectednumber—Pagos esperados en 7 días con este intervalo. puede faltar
other_contracts[].settled.cum_7d_completeboolean—true cuando no falta ningún pago en la ventana de 7 días. puede faltar
other_contracts[].settled.cum_30dnumber—Suma de las tasas liquidadas en los últimos 30 días. puede faltar
other_contracts[].settled.n_30dnumber—Pagos encontrados en los últimos 30 días. puede faltar
other_contracts[].settled.n_30d_expectednumber—Pagos esperados en 30 días con este intervalo. puede faltar
other_contracts[].settled.cum_30d_completeboolean—true cuando no falta ningún pago en la ventana de 30 días. puede faltar
other_contracts[].settled.history_fromnumbermsRegistro de pago más antiguo conservado de este contrato. puede faltar
coverageobject—Qué se incluye y qué no en las cifras anteriores. Conviene revisarlo antes de comparar totales con otra fuente.
coverage.settle_history_exchangesarray—Exchanges de los que se recopilan registros de pagos reales.
coverage.settle_history_exchanges[]string—Id del exchange del que se recopilan registros de pagos reales de financiación para esta moneda.
coverage.no_settle_historyarray—Exchanges sin una fuente pública de historial de pagos; su `settled` es null.
coverage.no_settle_history[]string—Id del exchange de un contrato principal sin historial de pagos recopilado, por lo que su bloque `settled` es null.
coverage.unknown_intervalarray—Filas cuyo intervalo de financiación no pudo determinarse. vacío en las muestras usadas para generar esta tabla
coverage.no_liveness_excludedarray—Filas excluidas porque el contrato no muestra señales de negociación (sin ticker, interés abierto ni cotización recientes). vacío en las muestras usadas para generar esta tabla
methodobject—Enunciado en texto plano de las fórmulas utilizadas en esta respuesta.
method.ratestring—Tasa de financiación del periodo en curso tal como la publica el exchange.
method.rate_8hstring—Tasa normalizada a un periodo de 8 horas: tasa × 8 / interval_h.
method.apr_pctstring% per yearPorcentaje anualizado.
method.aggregatestring—Agregado entre exchanges.
method.settledstring—Registros de pagos reales de este contrato; null cuando el exchange no tiene historial público.
method.predicted_ratestring—Tasa indicativa del próximo periodo cuando el exchange la publica; en caso contrario, null.
method.livenessstring—Regla en texto plano para descartar contratos muertos: una fila de financiación solo cuenta si tiene un ticker de menos de 1h, interés abierto de menos de 3h o una cotización propia de menos de 3h.

Generada 2026-11-11 23:00 UTC a partir de 4 respuestas reales.

Respuesta de ejemplo

/api/sd/funding?coin=BTC · Respuesta real capturada 2026-11-13 03:57:42 UTC. Los arrays y mapas largos se abrevian para su visualización: by_exchange tenía 23 elementos; other_contracts tenía 18 elementos; coverage.settle_history_exchanges tenía 16 elementos.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542262267,
    • "unit": "fraction",
    • "avg_8h": 0.00006731782608695654,
    • "oi_weighted_8h": 0.00005745116946489526,
    • "apr_pct": 6.2909,
    • "apr_basis": "oi_weighted_8h",
    • "n_exchanges": 23,
    • "n_normalized": 23,
    • "n_unknown_interval": 0,
    • "settled_cum_7d": {
      • "avg": 0.0016089506666666666,
      • "oi_weighted": 0.0015317230977727185,
      • "n": 15
      },
    • "settled_cum_30d": {
      • "avg": 0.0066857086666666675,
      • "oi_weighted": 0.006362887957085279,
      • "n": 15
      },
    • "by_exchange": [
      • { … 17 },
      • { … 17 }
      ],
    • "other_contracts": [
      • { … 17 },
      • { … 17 }
      ],
    • "coverage": {
      • "settle_history_exchanges": [ … 8 ],
      • "no_settle_history": [ … 7 ],
      • "unknown_interval": [],
      • "no_liveness_excluded": []
      },
    • "method": {
      • "rate": "current funding-period rate as published by the exchange (charged at next settlement; may change until then)",
      • "rate_8h": "rate × 8 / interval_h (rows with unknown interval excluded from aggregates)",
      • "apr_pct": "per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…",
      • "aggregate": "one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd",
      • "settled": "actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window",
      • "predicted_rate": "exchange-published indicative/next-period rate where available",
      • "liveness": "a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
      }
    }

Muestras verificadas

Además del ejemplo anterior, la sonda llama a este endpoint con estos parámetros y comprueba el esquema en cada ocasión.

ParámetrosHTTPLatenciaResultado
coin=ETH20043 msCorrecto
coin=SOL20044 msCorrecto
coin=ARKM20041 msCorrecto
—4001 msCorrecto devuelve el error esperado

Comprobado 2026-11-13 03:57:42 UTC

Detalles

Autenticación
Ninguna. Endpoint público.
Límite de solicitudes
1200 solicitudes por minuto por IP
Caché del servidor
20s
Microcaché de borde
10s
Frecuencia de actualización
cada 60 s en la mayoría de las plataformas (se escribe junto con los tickers; tarea dedicada de 60 s para binance); el resto de las tareas de financiación y los contratos con margen en moneda cada 5 min; registros de pagos cada hora
Ventana
última instantánea (filas de financiación de las últimas 4 h en contratos con ticker / OI activo); sumas de pagos liquidados a 7 d y 30 d
Fuentes de datos
Tasas de financiación actuales consultadas por los recolectores internos en las API REST públicas de 24 plataformas de perpetuos (p. ej. binance, okx, bybit, bitget, gate, hyperliquid).
Cobertura de exchanges
24 plataformas para las tasas actuales; historial de pagos de 16 plataformas (los perpetuos con margen en moneda de binance, okx y bybit se mantienen por separado)
Unidades
unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
Método
one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
Marcas de tiempo
Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
Formato de respuesta
json
Estabilidad
Estable
Disponible desde
2026-11-11

Estado en vivo

DisponibleComprobado 2026-11-13 03:57:42 UTCHTTP 20052 msEl esquema coincideAntigüedad del dato más reciente: 1s

Disponibilidad, últimos 30 días

100% de 410 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ódigoHTTPSignificadoQué hacer
INVALID_PARAM400Falta 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.
UNAUTHORIZED401Se 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.
FORBIDDEN403La ruta no forma parte de la API pública (interna o solo para cuentas).No reintente.
NOT_FOUND404Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED429Má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.
INTERNAL500Error 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_FAILED503La 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.
UNAVAILABLE501 / 503El 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_FAILED200Algunos 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

GET/api/sd/fundingDisponible
Parámetros

string — Coin symbol; 400 when missing. Alias: `base`.

URL de la solicitudhttps://www.coinboss.com/api/sd/funding?coin=BTC
Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.