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

مرجع API

به API بلاک‌لنز (Blocklens) خوش آمدید! API ما دسترسی برنامه‌نویسی به بیش از ۲۱۰ متریک آن‌چین را فراهم می‌کند — همان داده‌های دقیق و باکیفیتی که پشتوانه داشبوردهای وب ما هستند. این API برای معامله‌گران حرفه‌ای، تحلیلگران، صندوق‌ها و توسعه‌دهندگانی ساخته شده که برای مدل‌ها، پژوهش‌ها و برنامه‌های خود به داده‌های قابل‌اعتماد و یکدست نیاز دارند.

شروع به کار​

برای شروع کار با API بلاک‌لنز، به یک کلید API نیاز خواهید داشت. دسترسی به API برای کاربران دارای پلن‌های اشتراک پولی ما در دسترس است.

  1. اشتراک بگیرید: در صفحه قیمت‌گذاری ما به پلنی ارتقا دهید که دسترسی به API را شامل شود.
  2. یک کلید بسازید: به بخش کلیدهای API در داشبورد حساب خود بروید تا نخستین کلید خود را ایجاد کنید.
  3. احراز هویت کنید: کلید API خود را در هدر Authorization درخواست‌هایتان قرار دهید.

برای جزئیات کامل، لطفاً راهنمای احراز هویت را ببینید.

نماگرفت نمودار (Snapshot API)​

Snapshot API به شما امکان می‌دهد نمودارهای تحلیل آن‌چین را به صورت تصاویر PNG، گرافیک برداری SVG یا فراداده JSON رندر کنید — همه از طریق یک نقطه‌پایانی واحد.

# Simple: render a BTC price chart
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.blocklens.co/v1/chart/snapshot?metric=price" -o chart.png

# Template: MVRV ratio with dark theme
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.blocklens.co/v1/chart/snapshot?template=mvrv_ratio&theme=dark" -o mvrv.png

از قالب‌های آماده برای نمودارهای رایج استفاده کنید، یا برای سفارشی‌سازی کامل (استایل‌دهی به‌ازای هر متریک، فرمول‌ها، محورهای سفارشی، نقشه‌های حرارتی، روی‌هم‌گذاری عملکرد چرخه) از نقطه‌پایانی POST بهره ببرید. سرور MCP از همین API در پشت‌صحنه برای ابزار render_chart استفاده می‌کند.

برای مشاهده تمام پارامترها، قالب‌ها و مثال‌ها، مستندات کامل Snapshot API را ببینید.

فلسفه API​

API ما با در نظر گرفتن اصول زیر طراحی شده است:

  • یکپارچگی: ساختار نقاط‌پایانی و طرح‌واره‌های داده به گونه‌ای طراحی شده‌اند که در همه شبکه‌های پشتیبانی‌شده قابل‌پیش‌بینی و یکپارچه باشند.
  • کارایی: ما زیرساخت خود را بهینه می‌کنیم تا برای پرسش‌های حساس به زمان، پاسخ‌هایی با تأخیر کم ارائه دهیم.
  • شفافیت: مستندات و فیلدهای داده ما به‌گونه‌ای روشن نام‌گذاری شده‌اند که گویا و بی‌نیاز از توضیح باشند.
  • قابلیت اطمینان: ما برای در دسترس‌بودن بالا می‌سازیم و فهرست تغییرات شفافی برای تمام به‌روزرسانی‌ها ارائه می‌دهیم.