Tam REST API Referansı

Kapsamlı REST referansımızla Smart Money API'ye hakim olun. Kripto türevleri istihbaratı ve balina takip verileri için tüm uç noktaları, parametreleri, kimlik doğrulama yöntemlerini ve gerçek dünya entegrasyon modellerini öğrenin.

Genel Bakış

Smart Money API, Bybit, Binance ve Hyperliquid gibi üç büyük borsada gerçek zamanlı kripto para türev verilerine RESTful erişim sağlar. API'miz, balina cüzdan pozisyonlarını, fonlama oranlarını, açık ilgi metriklerini, likidasyon verilerini ve zincir üstü sinyalleri tek bir birleşik arayüzde toplar. İster ticaret algoritmaları, risk yönetim sistemleri veya piyasa analiz araçları oluşturuyor olun, REST API size tüm Smart Money istihbaratına doğrudan programatik erişim sağlar.

229'dan fazla otomatik keşfedilen ticaret sembolü ve 600+ izlenen balina cüzdanı ile API, kapsamlı piyasa istihbaratı sunar. Gerçek zamanlı WebSocket bağlantıları saniyenin altında güncellemeler sağlarken, REST uç noktalarımız toplu sorguları, geçmiş veri alımını ve portföy analizini ölçekte işler.

Tüm istekler geçerli kimlik doğrulama bilgileri içermelidir. Ücretsiz kullanıcılar günde 20 istek ile sınırlıdır ve yalnızca BTC için erişim sağlar. Trader seviyesi (günde 400 istek) ve Pro seviyesi (günde 4.000 istek) tüm sembolleri ve gelişmiş özellikleri açar.

Kimlik Doğrulama

Smart Money API, API anahtar kimlik doğrulaması kullanır. Birincil yöntem X-API-Key istek başlığıdır. API anahtarlarınızı kontrol panelinizden oluşturabilirsiniz. Bir oturum JWT'si Authorization: Bearer tarayıcı/kontrol paneli oturumları için yedek olarak kabul edilir, ancak API istemcileri X-API-Key.

API Anahtar Kimlik Doğrulaması (birincil)

API anahtarınızı her istekte X-API-Key başlığında gönderin. Anahtarınızı asla bir URL'ye koymayın.

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

Oturum JWT (yedek)

Tarayıcı/kontrol paneli oturumları bir oturum JWT'sini Authorization: Bearer üzerinden iletebilir (24 saat geçerlidir). Programatik istemciler X-API-Key.

Python

import requests
import json

# JWT token al
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# Sonraki istekler için JWT kullan
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Temel URL ve Uç Noktalar

Tüm API istekleri https://api.smartmoneyapi.comadresine gönderilir. API, sürüm önekleriyle mantıksal kaynak kategorilerine ayrılmıştır. Mevcut kararlı sürüm v1.

Temel URL: https://api.smartmoneyapi.com/api/v1

WebSocket URL: wss://ws.smartmoneyapi.com/stream

Yanıt Formatı

Tüm API yanıtları, standart bir zarf formatında JSON nesneleri olarak döndürülür. Başarılı yanıtlar, yanıt gövdesinde veri ile HTTP 200-299 durum kodlarını döndürür. Hata yanıtları, ayrıntılı hata mesajları ve çözüm önerileri içerir.

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [
      {
        "wallet_address": "0x1234...",
        "symbol": "BTCUSDT",
        "position_size": 15.5,
        "entry_price": 42150.0,
        "current_price": 43200.5,
        "pnl": 16577.75,
        "pnl_percent": 3.91,
        "leverage": 5,
        "funding_rate": 0.00012,
        "last_updated": "2026-03-21T14:30:45Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total_pages": 1
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Balina Pozisyonları Uç Noktası

İzlenen balina cüzdanlarından tüm borsalardaki detaylı pozisyonları alın. Bu uç nokta, yüksek değerli pozisyonlar için gerçek zamanlı kaldıraç, giriş fiyatları, likidasyon fiyatları ve gerçekleşmemiş K/Z gösterir.

GET /v1/whales/events PRO

Parametre	Tür	Açıklama
symbol	string	Ticaret çifti (örn., BTCUSDT, ETHUSDT) optional
exchange	string	Borsaya göre filtrele: bybit, binance, hyperliquid optional
min_position_size	number	Temel varlık cinsinden minimum pozisyon büyüklüğü optional
direction	string	Yalnızca long veya short pozisyonlar optional
page	integer	Sayfalama sayfa numarası, varsayılan 1 optional
limit	integer	Sayfa başına sonuç, maksimum 100, varsayılan 50 optional

Örnek İstek:

cURL

curl -X GET "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&min_position_size=10&limit=25" \
  -H "X-API-Key: sm_your_key" \
  -H "Content-Type: application/json"

Fonlama Oranları Uç Noktası

Bybit, Binance ve Hyperliquid üzerinden gerçek zamanlı ve geçmiş fonlama oranlarına erişin. Fonlama oranları, arbitraj ticareti, salınım stratejileri ve türev koruma için kritik öneme sahiptir. API'miz, 15 dakikalık detayla oranları toplar ve geçmiş oran analizi sağlar.

GET /v1/funding-rates FREE

Parametre	Tür	Açıklama
symbol	string	Ticaret çifti (örn., BTCUSDT) required
exchange	string	Borsa: bybit, binance, hyperliquid optional
interval	string	1h, 4h, 1d, varsayılan 1h optional
limit	integer	Döndürülecek geçmiş dönemler, maksimum 500 optional

Örnek İstek:

JavaScript

const fetchFundingRates = async () => {
  const response = await fetch(
    "https://api.smartmoneyapi.com/v1/funding-rates?symbol=BTCUSDT&interval=4h&limit=100",
    {
      headers: {
        "X-API-Key": "sm_your_key",
        "Content-Type": "application/json"
      }
    }
  );
  const data = await response.json();
  console.log(data);
};
fetchFundingRates();

Açık Pozisyon Uç Noktası

Tüm kaldıraçlı yatırımcıların toplam açık pozisyonlarını izleyin. Fiyat hareketinden sapma gösteren açık pozisyonlar, potansiyel tersine dönüşler ve trend devamlılık fırsatlarını işaret eder. Hem mutlak açık pozisyonu hem de açık pozisyon değişim oranlarını takip edin.

GET /v1/open-interest TRADER

Parametre	Tür	Açıklama
symbol	string	İşlem çifti zorunlu
exchange	string	bybit, binance veya hyperliquid isteğe bağlı
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, varsayılan 15m isteğe bağlı

Likidasyon Uç Noktası

Bir sembol için iki tamamlayıcı görünüm döndürür: kaldıraç-projeksiyonlu seviyeler (likidasyon kümelerinin nerede olduğuna dair bir tahmin) ve bir realized_heatmap — Binance, OKX, Bybit, Bitget ve BitMEX gibi halka açık borsaların WebSocket veri akışlarından toplanan GERÇEKLEŞEN zorunlu likidasyon yoğunluğu (fiyat × zaman). Sembol için veri akışı varsa ısı haritası mevcuttur.

GET /v1/liquidations TRADER

Parametre	Tür	Açıklama
symbol	string	Varlık sembolü, varsayılan BTC isteğe bağlı

Trader kademeli risk, en yakın mesafeler ve gerçekleşen toplamlar/tarafları döndürür. Pro tam projeksiyonlu seviyeler artı tam realized_heatmap (matrisler, fiyat başına kümeler, borsa başına sayılar).

On-Chain DeFi Likidasyonları

Kendi yerel BSC ve Avalanche tam düğümlerimizden doğrudan yakalanan gerçekleşen DeFi borç verme protokolü likidasyonları — herhangi bir işlem botundan bağımsız. BSC'de Venus/Cream ve Moolah, Avalanche'da ise AAVE V3/V2, Benqi, BankerJoe, Granary ve Vinium'u kapsar. Kimlik doğrulamalı bir anahtar gerektirir (Trader+); Pro ayrıca bot bağımlı risk altındaki pozisyonları da döndürür.

GET /v1/liquidations/onchain TRADER

Parametre	Tür	Açıklama
chain	string	bsc veya avax; tümü için boş bırakın isteğe bağlı
limit	integer	Maksimum satır sayısı, varsayılan 100, maksimum 500 (en yeni ilk) isteğe bağlı

Onay Uç Noktası

The /v1/confirm uç noktası, türevler, on-chain (ücretsiz Coin Metrics: MVRV / borsa-akışı / aktif-adres) ve balina pozisyonlarını birleştiren kural tabanlı, çok faktörlü bir birleşim skoru döndürür. Bu bileşik skor -1.0 ile +1.0 arasındadır (0–100 değil) ve her yanıt şeffaf bir faktörler ayrıştırması (bacak başına skor × ağırlık), ayarlamalar, ağırlıklar, ve kapsamiçerir. Bu bir karar destek aracıdır, garanti edilmiş bir kazanma oranı değildir. İzlenmeyen bir sembol, uydurulmuş bir DÜŞÜK skor yerine açık bir NO_DATA / desteklenmeyen sonucu döndürür.

GET /v1/confirm TRADER

Parametreler: sembol (BTC/ETH/SOL) ve yön (long/short). güven HIGH / MEDIUM / LOW / VETO / NO_DATA değerlerinden biridir; eylem CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP değerlerinden biridir; boyut_çarpanı önerilen pozisyon büyüklüğü çarpanıdır.

On-Chain Veri Uç Noktaları

Bitcoin ve Ethereum on-chain metriklerine erişin: borsa akışları, balina cüzdan hareketleri, MVRV oranı, NUPL, harcama koşulları ve gerçekleşmiş volatilite. Bu metrikler birikim/dağıtım döngülerini belirler ve büyük dönüşler için erken sinyaller sağlar.

GET /v1/on-chain/metrics PRO

Parametre	Tür	Açıklama
varlık	string	bitcoin veya ethereum zorunlu
metrikler	array	Belirli metrikler: exchange_flows, mvrv, nupl, whale_moves isteğe bağlı
aralık	string	1d (günlük), 1w (haftalık), varsayılan 1d isteğe bağlı

Veri Modelleri Referansı

API yanıtlarının yapısını anlamak entegrasyon için çok önemlidir. Aşağıda tüm uç noktalarda kullanılan veri modeli tanımları bulunmaktadır.

WhalePosition Nesnesi

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": 15.5,
  "entry_price": 42150.0,
  "current_price": 43200.5,
  "pnl": 16577.75,
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": 129000.0,
  "used_margin": 126225.0,
  "available_margin": 2775.0,
  "liquidation_price": 34560.0,
  "funding_rate": 0.00012,
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:30:45Z"
}

FundingRateRecord Nesnesi

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "funding_rate": 0.00012,
    "next_rate": 0.00015
  },
  "binance": {
    "funding_rate": 0.00010,
    "next_rate": 0.00013
  },
  "hyperliquid": {
    "funding_rate": 0.00014,
    "next_rate": 0.00016
  },
  "aggregated": {
    "mean": 0.000120,
    "median": 0.000120,
    "spread": 0.000060
  }
}

Kod Örnekleri

Aşağıda yaygın entegrasyon modelleri için hazır kod örnekleri bulunmaktadır.

Python ile Balina Pozisyonlarını İzleme

Python

import requests
import time
from typing import List, Dict

class SmartMoneyClient:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.smartmoneyapi.com/api/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def get_whale_positions(self, symbol: str = None) -> Dict:
        """Opsiyonel sembol filtresi ile balina pozisyonlarını getir"""
        params = {}
        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            f"{self.base_url}/whales/events",
            headers=self.headers,
            params=params
        )
        return response.json()

    def get_funding_rates(self, symbol: str) -> Dict:
        """Mevcut ve geçmiş fonlama oranlarını al"""
        response = requests.get(
            f"{self.base_url}/funding-rates",
            headers=self.headers,
            params={"symbol": symbol, "limit": 100}
        )
        return response.json()

    def monitor_whale_activity(self, symbol: str, interval_seconds: int = 60):
        """Balina pozisyonlarını sürekli olarak izle"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Balina {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Kullanım
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Toplam balina pozisyonları: {whales['data']['total']}")

En İyi Uygulamalar & Performans İpuçları

Sayfalama kullanın: Büyük sonuç setlerini her zaman sayfalayın. Tüm veriyi tek seferde değil, 50-100 kayıtlık parçalar halinde almak için limit ve page parametrelerini kullanın.

Yanıtları önbelleğe alın: Balina pozisyonları her saniye değişmez. API çağrılarını azaltmak ve performansı artırmak için sonuçları 30-60 saniye önbelleğe alın.

Erken filtreleyin: Veriyi uygulama kodunuzda değil, sunucu tarafında filtrelemek için sorgu parametrelerini (sembol, borsa, yön) kullanın.

Oran sınırlarını yönetin: Üstel geri çekme mantığı uygulayın. Oran sınırlarına (429 durum kodu) ulaştığınızda bekleyin ve tekrar deneyin.

Gerçek zamanlı için WebSocket kullanın: Akış verileri için REST endpoint'lerini sürekli sorgulamak yerine WebSocket bağlantılarını tercih edin. Bant genişliğinden tasarruf eder ve saniyenin altında gecikme elde edersiniz.

Zaman damgalarını doğrulayın: Tüm zaman damgaları ISO 8601 UTC formatındadır. Görüntüleme için her zaman yerel saat diliminize dönüştürün ve saklarken UTC formatında tutun.

Bağlantı kesilmelerini yönetin: WebSocket bağlantıları için üstel geri çekme ile otomatik yeniden bağlantı mantığı uygulayın.

Kotanızı izleyin: Yanıtlardaki X-Requests-Remaining başlığını kontrol edin. API kullanımınızı kademe limitiniz dahilinde planlayın.

Yaygın Entegrasyon Modelleri

Model 1: Balina Birikimi Uyarısı

Potansiyel boğa hareketlerini veya birikim fazlarını işaret eden balina pozisyonları bir eşiği aştığında uyarılar kurun.

Model 2: Fonlama Oranı Arbitraj Tespiti

Borsalar arasında fonlama oranı farkları karlı eşikleri aştığında otomatik olarak tespit edin ve çapraz borsa arbitraj algoritmalarını etkinleştirin.

Model 3: Tasfiye Kaskad İzleme

Büyük tasfiyeleri takip edin ve algoritmayı zincirleme tasfiyelerden ve yüksek etkili fiyat hareketlerinden yararlanacak şekilde konumlandırın.

Model 4: Çoklu Sinyal Onayı

Balina pozisyonları, fonlama oranları, zincir üstü metrikler ve AI onay puanlarını birleştirerek yüksek inançlı giriş sinyalleri oluşturun.

Başlamaya Hazır mısınız?

API anahtarınızı konsoldan alın ve bugün oluşturmaya başlayın. Yeni tüm hesaplar ücretsiz erişimle günde 20 istek hakkı alır (BTC, ETH, SOL). Tüm sembollere ve gelişmiş özelliklere sınırsız erişim için Trader veya Pro'ya yükseltin.

API Anahtarı Al

Pro Özelliklerin Kilidini Aç

Balina pozisyonları, onay puanları, zincir üstü veriler ve günde 2000+ API isteğine tam erişim elde edin.

Fiyatlandırmayı Görüntüle