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

تغییرات

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

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

  • جریان‌های روزانه اکنون برای همه‌ی صندوق‌ها با تاریخ معامله هم‌تراز شده‌اند.
  • فیلدهای جدید: 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) اضافه شد.

مشتقات

  • پس از تعطیلی صرافی، 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.