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.
Todos os endpoints abaixo exigem uma chave de API Enterprise. Os demais planos recebem 403 com required_grade: 2.
Endpoints
| Método | Caminho | Descrição |
|---|---|---|
GET | /v1/dat/capital/entities | Empresas cobertas e as chaves de suas séries (camadas, tickers de preferenciais, programas ATM, ativos subjacentes de opções) |
GET | /v1/dat/capital/instruments | Estrutura de capital atual, cobertura em BTC e preço de ruptura de cada camada de senioridade, KPIs mais recentes |
GET | /v1/dat/capital/obligations | Obrigações de caixa mensais: juros, dividendos de preferenciais, puts dos detentores, vencimentos; ativos em USD e runway |
GET | /v1/dat/capital/metrics | mNAV 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/layers | Cobertura diária e preço de ruptura do BTC de uma camada de senioridade (padrão: a mais júnior) |
GET | /v1/dat/capital/preferreds | Fechamento diário da preferencial, taxa, rendimento corrente e spread sobre o rendimento do Treasury de 10 anos |
GET | /v1/dat/capital/atm | Vendas ATM semanais por programa: unidades, receitas, capacidade restante, % do volume negociado |
GET | /v1/dat/capital/options | GEX diário das opções listadas sobre um ativo subjacente (MSTR, IBIT, STRC, STRD, STRF) |
GET | /v1/dat/capital/options/profile | GEX e fluxo de hedge dos dealers por nível de preço, GEX por strike, open interest por vencimento |
GET | /v1/dat/capital/scenarios | Grade de cenários pré-calculada (metodologia) |
URL base: https://api.blocklens.co. As respostas usam o envelope {"success": true, "data": …}.
Parâmetros
| Parâmetro | Endpoints | Descrição |
|---|---|---|
entity | todos, exceto opções | Ticker da ação ordinária da empresa, padrão MSTR |
from_date, to_date | séries diárias / semanais | Intervalo de datas (YYYY-MM-DD) |
limit | séries diárias / semanais | Linhas mais recentes mantidas (retornadas da mais antiga para a mais recente) |
fields | /metrics | Colunas separadas por vírgula (date é sempre retornado) |
layer | /layers | Chave da camada obtida em /entities, junior (padrão) ou all |
ticker | /preferreds | Ticker da preferencial, por exemplo STRC; padrão: todas as preferenciais |
program | /atm | Programa ATM, padrão ALL (receitas de todos os programas; unidades e % do volume da ação ordinária) |
months | /obligations | Meses à frente, 1–60, padrão 24 |
underlying, date, range_pct | /options, /options/profile | Ativo 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
| Status | Quando |
|---|---|
403 | A chave não é Enterprise (required_grade: 2) |
404 | entity, camada ou sessão desconhecida, ou dados ainda não gerados |
400 | Valor de fields desconhecido |
Os dados descrevem documentos públicos e preços de mercado. Não são uma previsão nem uma recomendação de investimento.