Oficiální SDK knihovny

Oficiální klientské knihovny pro Python, JavaScript, Go a Rust. Zjednodušte si integraci API s typovanými klienty, automatickou logikou opakování a podporou WebSocket.

Python SDK

Balíček: smartmoney-api

Instalace: pip install smartmoney-api

Repozitář: github.com/smartmoneyapi/python-client

Python

from smartmoney import SmartMoneyAPI

# Inicializace klienta
client = SmartMoneyAPI(api_key="sk_live_abc123xyz789")

# Získání pozic velryb
whales = client.whale_positions(symbol="BTCUSDT", limit=50)
for position in whales:
    print(f"{position.wallet_address}: {position.position_size} BTC @ {position.entry_price}")

# Získání funding rates
funding = client.funding_rates(symbol="BTCUSDT", interval="4h", limit=24)

# Streamování živých aktualizací
with client.stream_whale_positions(["BTCUSDT", "ETHUSDT"]) as stream:
    for update in stream:
        print(f"Aktualizace pozice: {update}")

Funkce

Podpora async/await (asyncio, aiohttp)
Automatické opakování s exponenciálním backoffem
WebSocket streamování s automatickým připojením
Typové nápovědy a autodoplňování v IDE
Logování a ladění požadavků

JavaScript SDK

Balíček: smartmoney-api

Instalace: npm install smartmoney-api

Repozitář: github.com/smartmoneyapi/js-client

JavaScript

import { SmartMoneyAPI } from "smartmoney-api";

const client = new SmartMoneyAPI({
  apiKey: "sk_live_abc123xyz789"
});

// Získání pozic velryb
const whales = await client.whalePositions({
  symbol: "BTCUSDT",
  limit: 50
});

whales.positions.forEach(pos => {
  console.log(`${pos.wallet_address}: ${pos.position_size} BTC`);
});

// Streamování aktualizací v reálném čase
const stream = client.streamWhalePositions(["BTCUSDT", "ETHUSDT"]);
stream.on("data", (update) => {
  console.log("Aktualizace pozice:", update);
});
stream.on("error", (err) => {
  console.error("Chyba streamu:", err);
});

Go SDK

Modul: github.com/smartmoneyapi/go-client

Instalace: go get github.com/smartmoneyapi/go-client

package main

import (
    "fmt"
    "github.com/smartmoneyapi/go-client"
)

func main() {
    // Vytvoření klienta
    client := smartmoney.NewClient("sk_live_abc123xyz789")

    // Získání pozic velryb
    positions, err := client.WhalePositions(ctx, &smartmoney.WhalePositionsFilter{
        Symbol: "BTCUSDT",
        Limit:  50,
    })
    if err != nil {
        panic(err)
    }

    for _, pos := range positions {
        fmt.Printf("%s: %.2f BTC\n", pos.WalletAddress, pos.PositionSize)
    }
}

Rust SDK

Krabice: smartmoney-api

Instalace: cargo add smartmoney-api

Rust

use smartmoney_api::Client;

#[tokio::main]
async fn main() -> Result<(), Box> {
    let client = Client::new("sk_live_abc123xyz789");

    // Získání pozic velryb
    let positions = client
        .whale_positions()
        .symbol("BTCUSDT")
        .limit(50)
        .send()
        .await?;

    for position in positions.iter() {
        println!(
            "{}: {} BTC @ {}",
            position.wallet_address,
            position.position_size,
            position.entry_price
        );
    }

    Ok(())
}

Běžné vzory

Zpracování chyb

Všechny SDK poskytují bohaté typy chyb s automatickou logikou opakování. Chyby obsahují stavový kód, kód chyby a lidsky čitelnou zprávu.

Časové limity požadavků

Nastavitelné časové limity požadavků (výchozí 30s). Nastavte vlastní limity pro dlouhotrvající operace.

Zpracování rate limitů

Automatický exponenciální backoff při dosažení rate limitů. Respektuje hlavičku Retry-After.

Vyberte si SDK

Začněte s jazykem dle vašeho výběru. Kompletní dokumentace a příklady jsou součástí.