Офіційні SDK бібліотеки

Офіційні клієнтські бібліотеки для Python, JavaScript, Go та Rust. Спрощуйте інтеграцію з API за допомогою типізованих клієнтів, автоматичної логіки повторних спроб та підтримки WebSocket.

Python SDK

Пакет: smartmoney-api

Встановлення: pip install smartmoney-api

Репозиторій: github.com/smartmoneyapi/python-client

Python

from smartmoney import SmartMoneyAPI

# Ініціалізація клієнта
client = SmartMoneyAPI(api_key="sk_live_abc123xyz789")

# Отримання позицій китів
whales = client.whale_positions(symbol="BTCUSDT", limit=50)
for position in whales:
    print(f"{position.wallet_address}: {position.position_size} BTC @ {position.entry_price}")

# Отримання ставок фандингу
funding = client.funding_rates(symbol="BTCUSDT", interval="4h", limit=24)

# Потокове отримання оновлень
with client.stream_whale_positions(["BTCUSDT", "ETHUSDT"]) as stream:
    for update in stream:
        print(f"Оновлення позиції: {update}")

Функції

Підтримка async/await (asyncio, aiohttp)
Автоматичні повторні спроби з експоненційним відступом
Потокове передавання через WebSocket з автоматичним перепідключенням
Підказки типів та автозаповнення в IDE
Логування та налагодження запитів

JavaScript SDK

Пакет: smartmoney-api

Встановлення: npm install smartmoney-api

Репозиторій: github.com/smartmoneyapi/js-client

JavaScript

import { SmartMoneyAPI } from "smartmoney-api";

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

// Отримання позицій китів
const whales = await client.whalePositions({
  symbol: "BTCUSDT",
  limit: 50
});

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

// Потокове отримання оновлень у реальному часі
const stream = client.streamWhalePositions(["BTCUSDT", "ETHUSDT"]);
stream.on("data", (update) => {
  console.log("Оновлення позиції:", update);
});
stream.on("error", (err) => {
  console.error("Помилка потоку:", err);
});

Go SDK

Модуль: github.com/smartmoneyapi/go-client

Встановлення: go get github.com/smartmoneyapi/go-client

package main

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

func main() {
    // Створення клієнта
    client := smartmoney.NewClient("sk_live_abc123xyz789")

    // Отримання позицій китів
    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

Крейт: smartmoney-api

Встановлення: cargo add smartmoney-api

Rust

use smartmoney_api::Client;

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

    // Отримання позицій китів
    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(())
}

Поширені шаблони

Обробка помилок

Усі SDK надають багаті типи помилок з автоматичною логікою повторних спроб. Помилки включають код статусу, код помилки та зрозуміле повідомлення.

Тайм-аути запитів

Налаштовувані тайм-аути запитів (за замовчуванням 30с). Встановлюйте власні тайм-аути для тривалих операцій.

Обробка лімітів запитів

Автоматичний експоненційний відступ при досягненні лімітів запитів. Враховує заголовок Retry-After.

Оберіть свій SDK

Почніть з вашої улюбленої мови. Повна документація та приклади включені.

Переглянути довідник API