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

تغییرات

این صفحه همه تغییرات مهم پلتفرم Blocklens و API آن را مستند می‌کند.

2026-10-22​

نقشه لیکوئیدیشن (داشبورد جدید، Lab → Dashboards → Blocklens Special)

  • نشان می‌دهد پوزیشن‌های اهرمی باز در چه قیمت‌هایی به‌اجبار بسته می‌شوند: Hyperliquid — پوزیشن‌های واقعی (هر پوزیشن باز همراه با قیمت لیکوئیدیشن آن، اسکن روزانه) و Binance — مدل (سطوح برآوردشده بر اساس اوپن اینترست و اهرم‌های معمول) — کنار هم یا جداگانه، برای BTC، ETH، SOL و HYPE.
  • نقشه حرارتی در طول زمان (نقشه هر روز همراه با خط قیمت؛ زوم، کلیک روی یک روز نقشه آن را باز می‌کند) و نقشه فعلی (حجم لیکوئیدیشن در هر بازه قیمتی همراه با منحنی‌های تجمعی، خوشه‌های اصلی و پوشش).
  • کلید بدون 20 پوزیشن بزرگ برای Hyperliquid؛ روزهایی که پنجره مدل Binance در آن‌ها ناقص است و روزهایی که بین اسنپ‌شات‌های آرشیو بازسازی شده‌اند، به‌عنوان برآورد علامت‌گذاری می‌شوند.
  • خروجی PNG برای همه، CSV/JSON در Pro؛ علاقه‌مندی‌ها و پیوندهای قابل اشتراک‌گذاری.
  • پلن‌ها: Free — 30 روز اخیر و نقشه فعلی؛ Pro — کل تاریخچه.

نمودارها

  • Charts → Futures → Liquidation maps: نقشه‌های حرارتی و نقشه‌های فعلی هر دو منبع به‌صورت نمودارهای جداگانه.

API & MCP

  • اندپوینت‌های جدید نقشه لیکوئیدیشن (Liquidation Map API) و ابزارهای MCP get_liquidation_map و get_liquidation_heatmap، با همان محدودیت‌های پلن.

نقشه‌ها چگونه ساخته می‌شوند و چه چیزی را می‌توانند و نمی‌توانند نشان دهند: روش‌شناسی نقشه لیکوئیدیشن. نقشه لیکوئیدیشن ابزاری توصیفی است، نه هدف قیمتی یا سیگنال معاملاتی.

2026-10-19​

Cohort Spending Analysis (داشبورد Enterprise)

  • اصلاح داده‌ها: در بازه‌های طولانی‌تر از دو سال، هفته یا ماهِ واقع در هر مرز بارگذاری داخلی دو بار شمرده می‌شد (برای نمونه هفته‌ی 2019-12-30 به‌جای ₿1.14M مقدار ₿2.3M را نشان می‌داد) و SOPR سالانه به‌صورت تقریبی محاسبه می‌شد (LTH SOPR برای 2018 به‌جای 1.33 مقدار 1.10 را نشان می‌داد). اکنون هر دو دقیقاً با داده‌های منبع مطابقت دارند. تاریخ‌ها دیگر برای کاربرانِ شرق UTC یک روز جابه‌جا نمی‌شوند.
  • دوره‌های ناقصِ اول/آخر به‌عنوان جزئی علامت‌گذاری می‌شوند؛ کوهورت‌های پیش‌فرض اکنون با 1d (سن دقیقاً 1 روز) و 1d–1w (2–6 روز) شروع می‌شوند.
  • بارگذاری سریع‌تر برای بازه‌های طولانی، جابه‌جایی فوری بین BTC/USD، و وضعیت داشبورد (بازه، تجمیع، واحد، زبانه، تاریخ‌ها، کوهورت‌های سفارشی) در یک پیوند قابل اشتراک‌گذاری حفظ می‌شود.
  • Market X-Ray با یک مقایسه‌ی پیش‌فرض باز می‌شود (آخرین دوره در برابر ~1M/3M/6M/1Y پیش‌تر)، دوره‌ها بر اساس سال انتخاب می‌شوند و ستون‌ها بر اساس کوهورت برچسب‌گذاری شده‌اند.
  • Cohort Breakdown نمای % از حجم، لایه‌ی SOPR کوهورت و سهمِ خرج‌شده با زیان را اضافه می‌کند؛ SOPR Pulse به‌طور پیش‌فرض از مقیاس لگاریتمی استفاده می‌کند.
  • ویرایشگر کوهورت پیش از اعمال، نام‌ها و بازه‌ها را اعتبارسنجی می‌کند؛ تاریخ‌ها و اعداد از زبان شما پیروی می‌کنند؛ خروجی‌ها (PNG/CSV/JSON) دقیقاً همان چیزی را دارند که زبانه‌ی فعال نشان می‌دهد.

API

  • POST /v1/enterprise/sopr: باکت‌ها و کوهورت‌ها اکنون btc_volume، usd_volume و cost_basis_usd را نیز برمی‌گردانند؛ هر دوره first_date، last_date و days را برمی‌گرداند. نام کوهورت‌ها می‌تواند به هر خطی باشد؛ نام‌های تکراری و بازه‌های سنیِ هم‌پوشان با 422 رد می‌شوند.

2026-10-18​

اصلاح داده‌ها

  • Net Liquidity (macro_net_liquidity): مؤلفه‌ی Reverse Repo بدون تبدیل واحد کسر می‌شد و همین باعث می‌شد سطح آن در 2021–2023 تا ~$2T بیش از مقدار واقعی نشان داده شود (برای نمونه 2022-06-01: $6.16T، که پیش‌تر $8.12T نمایش داده می‌شد). کل تاریخچه دوباره محاسبه شد. این سری اکنون به‌جای هفتگی، برای هر روز کاری آمریکا منتشر می‌شود.
  • Bitcoin treasuries (/v1/dat/*): دارایی‌های بخشی از شرکت‌ها و دولت‌های تحت پیگیری روی مقادیر 2026-08-10 ثابت مانده بود. تاریخچه‌ی 2026-08-11 → 2026-10-16 اصلاح و مقادیر تجمیعی دوباره محاسبه شد.
  • مجموع ETFها (/v1/etf/aggregate): Grayscale Mini در بازه 2024-07-31 → 2026-07-18 دو بار شمرده می‌شد و کل دارایی BTC در ETFها را تا حدود ۴۸ هزار BTC بیشتر نشان می‌داد (مثلاً 2025-06-02: 1,301,052 BTC، پیش‌تر 1,344,415). کل دارایی، AUM، سهم BTC، تعداد ETFها، سهم بازار و قیمت تحقق‌یافته ETF بازمحاسبه شدند.
  • WisdomTree Bitcoin Fund (BTCW) اکنون به‌عنوان ETF اسپات آمریکا شمرده می‌شود: us_btc_holdings، us_aum و قیمت تحقق‌یافته ETFهای اسپات آمریکا از 2024-01-11 آن را شامل می‌شوند.
  • توضیحات etf_realized_price و us_spot_etf_realized_price اکنون با روش واقعی محاسبه (مجموع بهای تمام‌شده میانگین موزون هر صندوق / BTC نگهداری‌شده) مطابقت دارد؛ مقادیر تغییری نکرده‌اند.

جریان‌های ETF

  • جریان‌های روزانه اکنون برای همه‌ی صندوق‌ها با تاریخ معامله هم‌تراز شده‌اند.
  • فیلدهای جدید: flow_usd (/v1/etf/ticker) و us_spot_net_flow_usd (/v1/etf/aggregate) — جریان خالص روزانه به USD.
  • جریان‌های تاریخی FBTC و IBIT اصلاح و روزهای جاافتاده تکمیل شد (برای نمونه ARKB 2026-09-21).
  • MSBT (Morgan Stanley Bitcoin Trust) اضافه شد.
  • flow_usd و us_spot_net_flow_usd اکنون کل تاریخچه از 2024-01-11 را پوشش می‌دهند؛ آخرین روز تا زمانی که همه صندوق‌ها رقم خود را منتشر کنند موقت است.
  • جریان‌های تجمعی USD بازمحاسبه شدند بر پایه جریان دقیق روزانه USD: us_spot_cumulative_money_flow اکنون مجموع us_spot_net_flow_usd از 2024-01-11 است ($56.9 میلیارد در 2026-10-16؛ برآورد قبلی $83.3 میلیارد). etf_cumulative_money_flow برای ETFهای اسپات آمریکا از جریان دقیق استفاده می‌کند؛ ETPهای غیرآمریکایی و GBTC پیش از 2024 همچنان برآورد هستند (تغییر BTC × قیمت BTC).
  • نمودارهای ETF Net Flow و ETF Net Flow Comparison اکنون جریان USD را در کنار جریان BTC نشان می‌دهند.

مشتقات

  • پس از تعطیلی صرافی، BitMEX از open interest و funding حذف شد (داده‌ها تا 2026-09-16 حفظ می‌شوند).
  • funding rate صرافی‌های Kraken و Bitfinex اضافه شد.

2026-09-04​

اصلاح داده‌ها

  • قیمت‌های تاریخی روزانه‌ی BTC (OHLC) برای بازه‌ی 2026-04-17 → 2026-07-11 مطابق با منبع مرجع ما اصلاح شد. سری‌های مشتق‌شده از قیمت — realized volatility (1w–1y) و price drawdown — برای بازه‌ی متأثر دوباره محاسبه شدند.
  • Realized Cap by Age (<24h) و تفکیک Realized Cap by Age (%) برای 2026-07-06 و 2026-07-07 دوباره محاسبه شد (پیش‌تر کمتر از مقدار واقعی گزارش شده بود).
  • هیچ متریک دیگری تحت تأثیر قرار نگرفت: realized cap، MVRV، NUPL و سری‌های هولدر بدون تغییر هستند.

2026-05-17​

Snapshot API

  • اکنون خروجی SVG در کنار PNG یک شهروند درجه‌یک است. فیلد format در POST /v1/chart/snapshot مقادیر "png"، "svg" یا "json" را می‌پذیرد؛ هر دو روش GET و POST نیز Accept: image/svg+xml را رعایت می‌کنند.
  • مسیر جدید: GET /v1/chart/renders/{render_id}.svg — تصاویر SVG رندرشده برای ۱ ساعت نگه‌داری می‌شوند و از طریق URL قابل بازیابی هستند، که رفتار موجود .png را بازتاب می‌دهد.
  • پاسخ‌های SVG اکنون شامل X-Render-Id هستند تا بتوان URL پایدار را از یک فراخوانی رندر واحد بازسازی کرد.
  • نسخه‌های PNG و SVG از یک نمودار واحد به‌صورت مستقل کش می‌شوند.
  • لایه‌های روی‌هم عملکرد چرخه (x_axis: "day_offset") اکنون برچسب‌های تیک محور X را به‌صورت تاریخ‌های تقویمی از آخرین چرخه خانواده انتخاب‌شده رندر می‌کنند (مثلاً Oct '25، Jan '26، … برای لایه‌های روی‌هم ATH که در cycle_ath_5 → 2025-10-06 لنگر گرفته‌اند) به‌جای Day 0، Day 90، … . چرخه‌های پیشین در همان موقعیت‌های محور هم‌تراز باقی می‌مانند.

MCP Server

  • render_chart: مجموعه مقادیر پارامتر format اکنون "png" | "svg" | "json" است (پیش‌تر "png" | "json" بود). وقتی format: "svg" ارسال شود، ابزار یک بلوک محتوای image/svg+xml و یک URL از نوع /chart/renders/{id}.svg را در خلاصه بازمی‌گرداند.

2026-04-02​

Metrics & API

  • تعداد متریک‌ها از ۱۲۷ به بیش از ۲۱۰ متریک فعال گسترش یافت (صرافی‌ها، مشتقات، DAT و موارد دیگر).
  • نقطه پایانی جدید: GET /v1/cycle-boundaries — تاریخ‌های شروع/پایان و مدت‌زمان چرخه‌های هاوینگ بیت‌کوین.
  • Metrics API اکنون برای قالب‌بندی یکپارچه پاسخ‌ها از یک سازنده پرس‌وجوی مبتنی بر رجیستری استفاده می‌کند.

Snapshot API

  • رندر نقشه حرارتی (Heatmap): نمودارهای مبتنی بر توزیع (مثلاً توزیع مبنای هزینه) را با مقیاس‌های رنگی قابل‌پیکربندی (viridis، plasma و غیره) و مقیاس‌های محور Y رندر کنید. شامل راهنمای مقیاس رنگ است.
  • نمودارهای لایه روی‌هم عملکرد چرخه: x_axis: "day_offset" همه چرخه‌های هاوینگ را برای مقایسه با Day 0 هم‌تراز می‌کند.
  • پارامتر جدید برای هر متریک: show_in_legend — کنترل اینکه آیا متریک‌های منفرد در راهنمای نمودار ظاهر شوند یا نه.

MCP Server

  • ابزار جدید: get_cycle_boundaries — پرس‌وجوی مستقیم تاریخ‌های چرخه هاوینگ از سوی عامل‌های هوش مصنوعی.
  • render_chart اکنون از رندر نقشه حرارتی و لایه‌های روی‌هم عملکرد چرخه پشتیبانی می‌کند.
  • پایگاه کد یکپارچه TypeScript (tools.ts) برای همه ابزارهای MCP.
  • تعداد ابزارها: ۱۸ ← ۱۹.

2025-09-25​

  • راه‌اندازی اولیه سایت مستندات docs.blocklens.co.