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

API و توسعه

مستندات API برای توسعه‌دهندگان

شروع کار با API

API نهنگ رادار به شما اجازه می‌دهد:

  • داده‌های نهنگ‌ها را دریافت کنید
  • هشدارها را مدیریت کنید
  • به داده‌های بازار دسترسی داشته باشید
  • اتوماسیون معاملات بسازید

نیازمندی‌ها:

  1. حساب VIP فعال
  2. کلید API (از تنظیمات دریافت کنید)
  3. آشنایی با HTTP/REST API

احراز هویت

برای استفاده از API باید کلید API خود را در هدر درخواست ارسال کنید:

Authorization: Bearer YOUR_API_KEY

نکات امنیتی:

  • کلید API را محرمانه نگه دارید
  • از کلید در سمت سرور استفاده کنید (نه مرورگر)
  • در صورت لو رفتن، فوراً کلید را غیرفعال کنید

Endpoints

GET/api/v1/whalesلیست نهنگ‌ها
GET/api/v1/whales/:addressاطلاعات یک نهنگ
GET/api/v1/positionsپوزیشن‌های فعال
GET/api/v1/alertsلیست هشدارها
POST/api/v1/alertsساخت هشدار جدید
DELETE/api/v1/alerts/:idحذف هشدار
GET/api/v1/market/fundingفاندینگ ریت
GET/api/v1/market/oiOpen Interest

نمونه کدها

JavaScript / Node.js

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.nahangradar.ir/v1';

async function getWhales() {
  const response = await fetch(`${BASE_URL}/whales`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  });
  return response.json();
}

// Usage
getWhales().then(data => {
  console.log(data.whales);
});

Python

import requests

API_KEY = 'your_api_key'
BASE_URL = 'https://api.nahangradar.ir/v1'

def get_whales():
    headers = {'Authorization': f'Bearer {API_KEY}'}
    response = requests.get(f'{BASE_URL}/whales', headers=headers)
    return response.json()

# Usage
whales = get_whales()
print(whales['whales'])

cURL

curl -X GET "https://api.nahangradar.ir/v1/whales" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"