Volume 24h—Contratos em aberto—Liquidações 24h$1.36BLong/Short 24h—Dominância BTC—Dominância ETH—
App
Idioma ▾
R$ BRL ▾
/api/sd/funding
GETDisponível

Financiamento de uma moeda

Camada de dados própria: financiamento de uma moeda (normalizado para 8h, ponderado)

GET/api/sd/funding

Requisição

Parâmetros de consulta

NomeTipoObrigatórioPadrãoValores aceitosDescrição
coinstringObrigatório——Símbolo da moeda; 400 quando ausente. Alias: `base`. Exemplo: BTC

Exemplo de requisição

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

Campos da resposta

A tabela de campos é gerada a partir de respostas reais, portanto lista exatamente o que o endpoint retorna. Os caminhos usam a[] para itens de array e {*} para objetos indexados por um nome dinâmico, como uma moeda ou uma corretora.

CampoTipoUnidadeDescrição
successboolean—true quando a requisição foi bem-sucedida. Em caso de falha, o corpo é `{ success: false, code, error, request_id }`.
coinstring—Símbolo da moeda, em maiúsculas (por exemplo, BTC).
nownumbermsHorário do servidor em que a resposta foi montada.
unitstring—Unidade de todos os campos de taxa desta resposta: `fraction` (0.0001 = 0.01 %).
avg_8hnumberfraction per 8hMédia simples das taxas normalizadas para 8h, um contrato por corretora.
oi_weighted_8hnumberfraction per 8hMédia das taxas normalizadas para 8h, ponderada pelos contratos em aberto.
apr_pctnumber% per yearAnualização simples: taxa de 8h × 3 × 365 × 100.
apr_basisstring—Em qual agregado se baseia o `apr_pct` de destaque.
n_exchangesnumber—Número de corretoras que contribuem.
n_normalizednumber—Corretoras cujo intervalo de financiamento é conhecido e pôde ser normalizado para 8h.
n_unknown_intervalnumber—Corretoras deixadas de fora dos agregados porque seu intervalo de financiamento é desconhecido.
settled_cum_7dobject—Soma das taxas de financiamento efetivamente liquidadas nos últimos 7 dias, em média entre as corretoras com histórico de liquidações de financiamento.
settled_cum_7d.avgnumberfractionMédia simples entre corretoras.
settled_cum_7d.oi_weightednumberfractionMédia ponderada pelos contratos em aberto.
settled_cum_7d.nnumber—Corretoras com a janela completa.
settled_cum_30dobject—O mesmo, em 30 dias.
settled_cum_30d.avgnumberfractionMédia simples entre corretoras.
settled_cum_30d.oi_weightednumberfractionMédia ponderada pelos contratos em aberto.
settled_cum_30d.nnumber—Corretoras com a janela completa.
by_exchangearray—Uma linha por corretora: seu contrato principal para esta moeda (o de maior volume de contratos em aberto).
by_exchange[]object—Detalhamento por corretora.
by_exchange[].exchangestring—ID da corretora, em minúsculas (por exemplo, `binance`).
by_exchange[].symbolstring—Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
by_exchange[].marginstring—Classe da moeda de margem.
by_exchange[].kindstring—Tipo.
by_exchange[].primaryboolean—true para o contrato que representa a corretora nos agregados.
by_exchange[].ratenumber—Taxa de financiamento do período atual, conforme publicada pela corretora.
by_exchange[].interval_hnumberhIntervalo de financiamento.
by_exchange[].rate_8hnumber—Taxa normalizada para um período de 8 horas: rate × 8 / interval_h.
by_exchange[].apr_pctnumber% per yearPercentual anualizado.
by_exchange[].next_funding_timenumber|nullmsHorário da próxima liquidação de financiamento.
by_exchange[].next_derivedboolean—true quando o horário da próxima liquidação de financiamento foi derivado do intervalo, em vez de publicado pela corretora.
by_exchange[].predicted_ratenull—Taxa indicativa do próximo período, quando a corretora a publica; caso contrário, null.
by_exchange[].oi_usdnumber|nullUSDContratos em aberto em valor nocional em USD.
by_exchange[].updated_atnumbermsQuando esta linha foi atualizada pela última vez.
by_exchange[].age_snumbersSegundos desde a última atualização desta linha.
by_exchange[].is_staleboolean—true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
by_exchange[].settledobject|null—Registros efetivos de liquidação de financiamento deste contrato; null quando a corretora não tem histórico público.
by_exchange[].settled.last_ratenumber—Taxa da liquidação de financiamento mais recente. pode estar ausente
by_exchange[].settled.last_timenumbermsHorário da liquidação de financiamento mais recente. pode estar ausente
by_exchange[].settled.interval_hnumberhIntervalo de financiamento. pode estar ausente
by_exchange[].settled.cum_7dnumber—Soma das taxas liquidadas nos últimos 7 dias. pode estar ausente
by_exchange[].settled.n_7dnumber—Liquidações de financiamento encontradas nos últimos 7 dias. pode estar ausente
by_exchange[].settled.n_7d_expectednumber—Liquidações de financiamento esperadas em 7 dias com este intervalo. pode estar ausente
by_exchange[].settled.cum_7d_completeboolean—true quando não falta nenhuma liquidação de financiamento na janela de 7 dias. pode estar ausente
by_exchange[].settled.cum_30dnumber—Soma das taxas liquidadas nos últimos 30 dias. pode estar ausente
by_exchange[].settled.n_30dnumber—Liquidações de financiamento encontradas nos últimos 30 dias. pode estar ausente
by_exchange[].settled.n_30d_expectednumber—Liquidações de financiamento esperadas em 30 dias com este intervalo. pode estar ausente
by_exchange[].settled.cum_30d_completeboolean—true quando não falta nenhuma liquidação de financiamento na janela de 30 dias. pode estar ausente
by_exchange[].settled.history_fromnumbermsRegistro de liquidação de financiamento mais antigo mantido para este contrato. pode estar ausente
other_contractsarray—Outros contratos da mesma moeda (USDC, com margem em cripto, …). Não fazem parte dos agregados.
other_contracts[]object—Um contrato de financiamento adicional de uma corretora (com margem em cripto, USDC, …) que não é o seu contrato principal e é excluído dos agregados.
other_contracts[].exchangestring—ID da corretora, em minúsculas (por exemplo, `binance`).
other_contracts[].symbolstring—Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
other_contracts[].marginstring—Classe da moeda de margem.
other_contracts[].kindstring—Tipo.
other_contracts[].primaryboolean—true para o contrato que representa a corretora nos agregados.
other_contracts[].ratenumber—Taxa de financiamento do período atual, conforme publicada pela corretora.
other_contracts[].interval_hnumber|nullhIntervalo de financiamento.
other_contracts[].rate_8hnumber|null—Taxa normalizada para um período de 8 horas: rate × 8 / interval_h.
other_contracts[].apr_pctnumber|null% per yearPercentual anualizado.
other_contracts[].next_funding_timenumber|nullmsHorário da próxima liquidação de financiamento.
other_contracts[].next_derivedboolean—true quando o horário da próxima liquidação de financiamento foi derivado do intervalo, em vez de publicado pela corretora.
other_contracts[].predicted_ratenumber|null—Taxa indicativa do próximo período, quando a corretora a publica; caso contrário, null.
other_contracts[].oi_usdnumber|nullUSDContratos em aberto em valor nocional em USD.
other_contracts[].updated_atnumbermsQuando esta linha foi atualizada pela última vez.
other_contracts[].age_snumbersSegundos desde a última atualização desta linha.
other_contracts[].is_staleboolean—true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
other_contracts[].settledobject|null—Registros efetivos de liquidação de financiamento deste contrato; null quando a corretora não tem histórico público.
other_contracts[].settled.last_ratenumber—Taxa da liquidação de financiamento mais recente. pode estar ausente
other_contracts[].settled.last_timenumbermsHorário da liquidação de financiamento mais recente. pode estar ausente
other_contracts[].settled.interval_hnumberhIntervalo de financiamento. pode estar ausente
other_contracts[].settled.cum_7dnumber—Soma das taxas liquidadas nos últimos 7 dias. pode estar ausente
other_contracts[].settled.n_7dnumber—Liquidações de financiamento encontradas nos últimos 7 dias. pode estar ausente
other_contracts[].settled.n_7d_expectednumber—Liquidações de financiamento esperadas em 7 dias com este intervalo. pode estar ausente
other_contracts[].settled.cum_7d_completeboolean—true quando não falta nenhuma liquidação de financiamento na janela de 7 dias. pode estar ausente
other_contracts[].settled.cum_30dnumber—Soma das taxas liquidadas nos últimos 30 dias. pode estar ausente
other_contracts[].settled.n_30dnumber—Liquidações de financiamento encontradas nos últimos 30 dias. pode estar ausente
other_contracts[].settled.n_30d_expectednumber—Liquidações de financiamento esperadas em 30 dias com este intervalo. pode estar ausente
other_contracts[].settled.cum_30d_completeboolean—true quando não falta nenhuma liquidação de financiamento na janela de 30 dias. pode estar ausente
other_contracts[].settled.history_fromnumbermsRegistro de liquidação de financiamento mais antigo mantido para este contrato. pode estar ausente
coverageobject—O que está e o que não está incluído nos números acima. Compare isto antes de comparar os totais com outra fonte.
coverage.settle_history_exchangesarray—Corretoras para as quais são coletados registros efetivos de liquidação de financiamento.
coverage.settle_history_exchanges[]string—ID de corretora para a qual são coletados registros efetivos de liquidação de financiamento desta moeda.
coverage.no_settle_historyarray—Corretoras sem fonte pública de histórico de liquidações de financiamento; seu `settled` é null.
coverage.no_settle_history[]string—ID de corretora de um contrato principal sem histórico de liquidações de financiamento coletado, de modo que seu bloco `settled` é null.
coverage.unknown_intervalarray—Linhas cujo intervalo de financiamento não pôde ser determinado. vazio nas amostras usadas para gerar esta tabela
coverage.no_liveness_excludedarray—Linhas excluídas porque o contrato não mostra sinal de negociação (sem ticker, contratos em aberto ou cotação recentes). vazio nas amostras usadas para gerar esta tabela
methodobject—Descrição em texto simples das fórmulas usadas nesta resposta.
method.ratestring—Taxa de financiamento do período atual, conforme publicada pela corretora.
method.rate_8hstring—Taxa normalizada para um período de 8 horas: rate × 8 / interval_h.
method.apr_pctstring% per yearPercentual anualizado.
method.aggregatestring—Agregado entre corretoras.
method.settledstring—Registros efetivos de liquidação de financiamento deste contrato; null quando a corretora não tem histórico público.
method.predicted_ratestring—Taxa indicativa do próximo período, quando a corretora a publica; caso contrário, null.
method.livenessstring—Regra em texto simples para descartar contratos mortos: uma linha de financiamento só conta se tiver ticker de até 1h, contratos em aberto de até 3h ou cotação própria de até 3h.

Gerada 2026-11-11 23:00 UTC a partir de 4 respostas reais.

Exemplo de resposta

/api/sd/funding?coin=BTC · Resposta real capturada 2026-11-13 03:57:42 UTC. Arrays e mapas longos são encurtados para exibição: by_exchange tinha 23 itens; other_contracts tinha 18 itens; coverage.settle_history_exchanges tinha 16 itens.

  • {
    • "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 …"
      }
    }

Amostras verificadas

Além do exemplo acima, a sonda chama este endpoint com estes parâmetros e verifica o esquema a cada vez.

ParâmetrosHTTPLatênciaResultado
coin=ETH20043 msAprovado
coin=SOL20044 msAprovado
coin=ARKM20041 msAprovado
—4001 msAprovado retorna o erro esperado

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

Detalhes

Autenticação
Nenhuma. Endpoint público.
Limite de requisições
1200 requisições por minuto por IP
Cache do servidor
20s
Microcache de borda
10s
Frequência de atualização
a cada 60 s para a maioria das corretoras (gravado junto com os tickers; job dedicado de 60 s para a binance); demais jobs de financiamento e contratos com margem em cripto a cada 5 min; registros de liquidação de financiamento a cada hora
Janela
snapshot mais recente (linhas de financiamento de até 4 h em contratos com ticker / OI ativo); somas liquidadas em 7 d e 30 d
Fontes de dados
Taxas de financiamento atuais consultadas por coletores internos nas APIs REST públicas de 24 corretoras de perpétuos (p. ex., binance, okx, bybit, bitget, gate, hyperliquid).
Cobertura de corretoras
24 corretoras para as taxas atuais; histórico de liquidações de financiamento de 16 corretoras (os perpétuos com margem em cripto de binance, okx e bybit são mantidos em 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)
Timestamps
Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
Formato da resposta
json
Estabilidade
Estável
Disponível desde
2026-11-11

Status ao vivo

DisponívelVerificado 2026-11-13 03:57:42 UTCHTTP 20052 msEsquema confereDado mais recente: há 1s

Disponibilidade, últimos 30 dias

100% de 410 verificações aprovadas

Erros

As chamadas com falha têm o mesmo formato em todos os endpoints. A lista completa está na página de erros. Erros e limites de requisições →

CódigoHTTPSignificadoO que fazer
INVALID_PARAM400Falta um parâmetro obrigatório ou um valor não é aceito. `param` indica o nome do parâmetro quando ele é conhecido.Não repita a requisição sem alterações; corrija-a.
UNAUTHORIZED401O cabeçalho `CB-API-KEY` foi enviado, mas a chave é desconhecida ou foi revogada. Dados públicos não exigem chave — remova o cabeçalho ou use uma chave válida.Não repita a requisição sem alterações.
FORBIDDEN403A rota não faz parte da API pública (é interna ou exclusiva de conta).Não tente novamente.
NOT_FOUND404Rota desconhecida, ou a moeda / corretora / fundo solicitado não existe.Não tente novamente; confira o caminho e os identificadores no catálogo.
RATE_LIMITED429Mais requisições do que o limite por minuto. `Retry-After` informa os segundos a aguardar.Aguarde `Retry-After` e então tente novamente com backoff.
INTERNAL500Erro inesperado do servidor. A mensagem é genérica de propósito; cite `request_id` ao reportá-lo.Tente novamente uma vez após alguns segundos; se persistir, reporte-o com o ID da requisição.
UPSTREAM_FAILED503A fonte de dados por trás deste endpoint não respondeu a tempo. Nenhum número desatualizado ou substituto é retornado em seu lugar.Tente novamente com backoff; consulte a página de status.
UNAVAILABLE501 / 503O conjunto de dados ainda não está pronto temporariamente (aquecimento do cache) ou o endpoint ainda não tem uma fonte pública lícita.Tente novamente mais tarde; o catálogo marca os endpoints que são indisponíveis por design.
REQUEST_FAILED200Alguns endpoints mais antigos respondem HTTP 200 com `success: false`. Verifique sempre `success`, não apenas o status HTTP.Depende da mensagem; trate como uma requisição com falha.

Experimente

GET/api/sd/fundingDisponível
Parâmetros

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

URL da requisiçãohttps://www.coinboss.com/api/sd/funding?coin=BTC
Escolha um endpoint e clique em “Enviar requisição”. A resposta, os cabeçalhos e o tempo de resposta aparecerão aqui.