DAT Capital Structure API
DAT Capital Structure API توضیح میدهد که یک شرکت خزانه Bitcoin چگونه بیتکوینهای خود را تأمین مالی میکند: هر اوراق قابل تبدیل، وام و سهام ممتاز همراه با ارشدیت، نرخ، سررسید و تاریخهای اختیار فروش دارنده (holder put)؛ داراییهای بیتکوین و USD هر لایه ارشدیت را چند برابر پوشش میدهند؛ تقویم ماهانه بهره و سود سهام؛ دیدگاه بازار از طریق mNAV و بازده سهام ممتاز؛ انتشار هفتگی at-the-market (ATM)؛ و گاما اکسپوژر دیلرها در آپشنهای بورسی روی اوراق بهادار شرکت. شرکت آزمایشی Strategy (MSTR) است.
ماندهها، تعداد سهام و شرایط ابزارها از گزارشهای SEC شرکت گرفته میشوند و تنها پس از بازبینی منتشر میشوند؛ در فاصله میان گزارشها، آخرین مانده گزارششده بهاضافه انتشار هفتگی گزارششده به جلو منتقل میشود. قیمتها قیمتهای پایانی روزانه در روزهای معاملاتی آمریکا هستند. سناریوها بر اساس حرکتهای BTC و افقهای زمانی، اندپوینت جداگانهای دارند: سناریوهای سرمایه و استرس.
همه اندپوینتهای زیر به کلید 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/metrics | mNAV روزانه (پایه، رقیقشده، 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/options | GEX روزانه آپشنهای بورسی روی یک دارایی پایه (MSTR، IBIT، STRC، STRD، STRF) |
GET | /v1/dat/capital/options/profile | GEX و جریان هج دیلرها در سطوح مختلف قیمت، 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) |
404 | entity، لایه یا جلسه معاملاتی ناشناخته است، یا هنوز دادهای ساخته نشده |
400 | مقدار ناشناخته در fields |
این دادهها گزارشهای عمومی و قیمتهای بازار را توصیف میکنند. پیشبینی نیستند و توصیه سرمایهگذاری هم نیستند.