Pular para o conteúdo principal

API de Estrutura de Capital DAT

A API de Estrutura de Capital DAT descreve como uma empresa de tesouraria em bitcoin financia seu bitcoin: cada nota conversível, empréstimo e ação preferencial com sua senioridade, taxa, vencimento e datas de put dos detentores; quantas vezes os ativos em bitcoin e em USD cobrem cada camada de senioridade; o calendário mensal de juros e dividendos; a visão do mercado por meio do mNAV e dos rendimentos das ações preferenciais; as emissões semanais at-the-market (ATM); e a exposição gama dos dealers nas opções listadas sobre os valores mobiliários da empresa. A empresa piloto é a Strategy (MSTR).

Saldos, quantidades de ações e termos dos instrumentos vêm dos documentos da empresa arquivados na SEC e só são publicados após revisão; entre um documento e outro, o saldo mais recente reportado, somado às emissões semanais reportadas, é levado adiante. Os preços são fechamentos diários em dias de pregão nos EUA. Os cenários sobre movimentos do BTC e horizontes ficam em um endpoint separado: Cenários de capital e de estresse.

Enterprise

Todos os endpoints abaixo exigem uma chave de API Enterprise. Os demais planos recebem 403 com required_grade: 2.

Endpoints​

MétodoCaminhoDescrição
GET/v1/dat/capital/entitiesEmpresas cobertas e as chaves de suas séries (camadas, tickers de preferenciais, programas ATM, ativos subjacentes de opções)
GET/v1/dat/capital/instrumentsEstrutura de capital atual, cobertura em BTC e preço de ruptura de cada camada de senioridade, KPIs mais recentes
GET/v1/dat/capital/obligationsObrigações de caixa mensais: juros, dividendos de preferenciais, puts dos detentores, vencimentos; ativos em USD e runway
GET/v1/dat/capital/metricsmNAV diário (básico, diluído, EV), preço do BTC com mNAV = 1, BTC por ação diluída, obrigações, runway, diluição
GET/v1/dat/capital/layersCobertura diária e preço de ruptura do BTC de uma camada de senioridade (padrão: a mais júnior)
GET/v1/dat/capital/preferredsFechamento diário da preferencial, taxa, rendimento corrente e spread sobre o rendimento do Treasury de 10 anos
GET/v1/dat/capital/atmVendas ATM semanais por programa: unidades, receitas, capacidade restante, % do volume negociado
GET/v1/dat/capital/optionsGEX diário das opções listadas sobre um ativo subjacente (MSTR, IBIT, STRC, STRD, STRF)
GET/v1/dat/capital/options/profileGEX e fluxo de hedge dos dealers por nível de preço, GEX por strike, open interest por vencimento
GET/v1/dat/capital/scenariosGrade de cenários pré-calculada (metodologia)

URL base: https://api.blocklens.co. As respostas usam o envelope {"success": true, "data": …}.

Parâmetros​

ParâmetroEndpointsDescrição
entitytodos, exceto opçõesTicker da ação ordinária da empresa, padrão MSTR
from_date, to_dateséries diárias / semanaisIntervalo de datas (YYYY-MM-DD)
limitséries diárias / semanaisLinhas mais recentes mantidas (retornadas da mais antiga para a mais recente)
fields/metricsColunas separadas por vírgula (date é sempre retornado)
layer/layersChave da camada obtida em /entities, junior (padrão) ou all
ticker/preferredsTicker da preferencial, por exemplo STRC; padrão: todas as preferenciais
program/atmPrograma ATM, padrão ALL (receitas de todos os programas; unidades e % do volume da ação ordinária)
months/obligationsMeses à frente, 1–60, padrão 24
underlying, date, range_pct/options, /options/profileAtivo subjacente (padrão MSTR), sessão (padrão: a mais recente), janela do perfil em ± % do fechamento

Definições​

  • mNAV (básico) = ações básicas × preço da ação / (BTC em tesouraria × preço do BTC). O diluído usa as ações básicas mais as ações resultantes da conversão das notas conversíveis e das ações preferenciais conversíveis. O EV soma à capitalização de mercado o valor de face da dívida e a preferência de liquidação das ações preferenciais e subtrai os ativos em USD (USD Reserve e caixa).
  • Cobertura de uma camada = (BTC em tesouraria × preço do BTC + ativos em USD) / direitos seniores à camada, incluindo ela própria. Preço de ruptura = o preço do BTC em que essa cobertura é igual a 1.
  • Obrigações de caixa anuais = valor em circulação × taxa atual, somado sobre notas, empréstimos e ações preferenciais. Runway = ativos em USD / um mês dessas obrigações.
  • Rendimento corrente da preferencial = taxa anual × preferência de liquidação / fechamento; spread = rendimento − rendimento do Treasury de 10 anos.
  • GEX = Σ ± open interest × 100 × gama × preço² / 100, em USD por movimento de 1%, supondo que os dealers estejam comprados em calls e vendidos em puts; o gama vem da volatilidade implícita de cada contrato (Black-Scholes-Merton). O fluxo de hedge em um nível = USD que os dealers comprariam (+) ou venderiam (−) se o preço fosse até lá.

As mesmas séries são métricas do registro (dat_cap_*, categoria DAT) disponíveis no Lab e via MCP (get_dat_capital_structure, get_dat_capital_options).

Exemplo​

curl -H "Authorization: Bearer $BLOCKLENS_API_KEY" \
"https://api.blocklens.co/v1/dat/capital/metrics?entity=MSTR&fields=mnav_basic,mnav_ev,runway_months&limit=5"
{"success": true, "entity": "MSTR", "count": 5,
"data": [{"date": "2026-11-13", "mnav_basic": 0.82, "mnav_ev": 1.08, "runway_months": 39.8}]}

Erros​

StatusQuando
403A chave não é Enterprise (required_grade: 2)
404entity, camada ou sessão desconhecida, ou dados ainda não gerados
400Valor de fields desconhecido
Não é recomendação de investimento

Os dados descrevem documentos públicos e preços de mercado. Não são uma previsão nem uma recomendação de investimento.