پرش به مطلب اصلی

DAT Capital Structure API

DAT Capital Structure API توضیح می‌دهد که یک شرکت خزانه Bitcoin چگونه بیت‌کوین‌های خود را تأمین مالی می‌کند: هر اوراق قابل تبدیل، وام و سهام ممتاز همراه با ارشدیت، نرخ، سررسید و تاریخ‌های اختیار فروش دارنده (holder put)؛ دارایی‌های بیت‌کوین و USD هر لایه ارشدیت را چند برابر پوشش می‌دهند؛ تقویم ماهانه بهره و سود سهام؛ دیدگاه بازار از طریق mNAV و بازده سهام ممتاز؛ انتشار هفتگی at-the-market (ATM)؛ و گاما اکسپوژر دیلرها در آپشن‌های بورسی روی اوراق بهادار شرکت. شرکت آزمایشی Strategy (MSTR) است.

مانده‌ها، تعداد سهام و شرایط ابزارها از گزارش‌های SEC شرکت گرفته می‌شوند و تنها پس از بازبینی منتشر می‌شوند؛ در فاصله میان گزارش‌ها، آخرین مانده گزارش‌شده به‌اضافه انتشار هفتگی گزارش‌شده به جلو منتقل می‌شود. قیمت‌ها قیمت‌های پایانی روزانه در روزهای معاملاتی آمریکا هستند. سناریوها بر اساس حرکت‌های BTC و افق‌های زمانی، اندپوینت جداگانه‌ای دارند: سناریوهای سرمایه و استرس.

Enterprise

همه اندپوینت‌های زیر به کلید API سطح Enterprise نیاز دارند. سطوح دیگر کد 403 همراه با required_grade: 2 دریافت می‌کنند.

اندپوینت‌ها​

متدمسیرتوضیح
GET/v1/dat/capital/entitiesشرکت‌های تحت پوشش و کلیدهای سری‌های آن‌ها (لایه‌ها، تیکرهای سهام ممتاز، برنامه‌های ATM، دارایی‌های پایه آپشن‌ها)
GET/v1/dat/capital/instrumentsساختار سرمایه فعلی، پوشش BTC و قیمت شکست هر لایه ارشدیت، آخرین KPIها
GET/v1/dat/capital/obligationsتعهدات نقدی ماهانه: بهره، سود سهام ممتاز، اختیار فروش دارندگان، سررسیدها؛ دارایی‌های USD و ران‌وی (runway)
GET/v1/dat/capital/metricsmNAV روزانه (پایه، رقیق‌شده، EV)، قیمت BTC در mNAV = 1، BTC به ازای هر سهم رقیق‌شده، تعهدات، ران‌وی، رقیق‌شدگی
GET/v1/dat/capital/layersپوشش روزانه و قیمت شکست BTC برای یک لایه ارشدیت (پیش‌فرض: جونیورترین لایه)
GET/v1/dat/capital/preferredsقیمت پایانی روزانه سهام ممتاز، نرخ، بازده جاری و اسپرد نسبت به بازده اوراق خزانه 10 ساله
GET/v1/dat/capital/atmفروش هفتگی ATM برای هر برنامه: تعداد واحدها، عواید، ظرفیت باقی‌مانده، % از حجم معاملات
GET/v1/dat/capital/optionsGEX روزانه آپشن‌های بورسی روی یک دارایی پایه (MSTR، IBIT، STRC، STRD، STRF)
GET/v1/dat/capital/options/profileGEX و جریان هج دیلرها در سطوح مختلف قیمت، GEX بر حسب استرایک، اوپن اینترست بر حسب سررسید
GET/v1/dat/capital/scenariosشبکه سناریوهای ازپیش‌محاسبه‌شده (روش‌شناسی)

آدرس پایه: https://api.blocklens.co. پاسخ‌ها از پوشش {"success": true, "data": …} استفاده می‌کنند.

پارامترها​

پارامتراندپوینت‌هاتوضیح
entityهمه به جز optionsتیکر سهام عادی شرکت، پیش‌فرض MSTR
from_date, to_dateسری‌های روزانه / هفتگیبازه تاریخ (YYYY-MM-DD)
limitسری‌های روزانه / هفتگیتعداد جدیدترین ردیف‌هایی که نگه داشته می‌شوند (به ترتیب از قدیمی‌ترین برگردانده می‌شوند)
fields/metricsستون‌ها، جداشده با کاما (date همیشه برگردانده می‌شود)
layer/layersکلید لایه از /entities، junior (پیش‌فرض) یا all
ticker/preferredsتیکر سهام ممتاز، مثلاً STRC؛ پیش‌فرض: همه سهام ممتاز
program/atmبرنامه ATM، پیش‌فرض ALL (عواید همه برنامه‌ها؛ تعداد واحدها و % از حجم برای سهام عادی)
months/obligationsتعداد ماه‌های پیش رو، 1–60، پیش‌فرض 24
underlying, date, range_pct/options, /options/profileدارایی پایه (پیش‌فرض MSTR)، جلسه معاملاتی (پیش‌فرض آخرین)، پنجره پروفایل ± % از قیمت پایانی

تعاریف​

  • mNAV (پایه) = سهام پایه × قیمت سهم / (دارایی BTC × قیمت BTC). نسخه رقیق‌شده از سهام پایه به‌اضافه سهام حاصل از فرض تبدیل اوراق قابل تبدیل و سهام ممتاز قابل تبدیل استفاده می‌کند. نسخه EV ارزش اسمی بدهی و ارجحیت انحلال سهام ممتاز را به ارزش بازار اضافه و دارایی‌های USD (USD Reserve و وجه نقد) را از آن کم می‌کند.
  • پوشش یک لایه = (دارایی BTC × قیمت BTC + دارایی‌های USD) / مطالباتی که ارشدتر از آن لایه هستند، به‌اضافه خود لایه. قیمت شکست = قیمتی از BTC که در آن این پوشش برابر 1 می‌شود.
  • تعهدات نقدی سالانه = مبلغ باقی‌مانده × نرخ فعلی، جمع‌شده روی اوراق، وام‌ها و سهام ممتاز. ران‌وی = دارایی‌های USD / تعهدات یک ماه.
  • بازده جاری سهام ممتاز = نرخ سالانه × ارجحیت انحلال / قیمت پایانی؛ اسپرد = بازده − بازده اوراق خزانه 10 ساله.
  • GEX = Σ ± اوپن اینترست × 100 × گاما × قیمت² / 100، بر حسب USD به ازای هر حرکت 1%، با این فرض که دیلرها در کال‌ها لانگ و در پوت‌ها شورت هستند؛ گاما از نوسان ضمنی هر قرارداد محاسبه می‌شود (Black-Scholes-Merton). جریان هج در یک سطح = مبلغ USD که دیلرها اگر قیمت به آن سطح برسد می‌خرند (+) یا می‌فروشند (−).

همین سری‌ها متریک‌های رجیستری هستند (dat_cap_*، دسته DAT) و در Lab و از طریق MCP (get_dat_capital_structure، get_dat_capital_options) در دسترس‌اند.

مثال​

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}]}

خطاها​

وضعیتچه زمانی
403کلید از سطح Enterprise نیست (required_grade: 2)
404entity، لایه یا جلسه معاملاتی ناشناخته است، یا هنوز داده‌ای ساخته نشده
400مقدار ناشناخته در fields
توصیه سرمایه‌گذاری نیست

این داده‌ها گزارش‌های عمومی و قیمت‌های بازار را توصیف می‌کنند. پیش‌بینی نیستند و توصیه سرمایه‌گذاری هم نیستند.