Кулінарна книга

API Кулінарна книга

Практичні, готові до використання рецепти для найпоширеніших способів підключення API підтвердження угод Smart Money до бота. Кожен рецепт викликає GET /v1/confirm та діє на action, confidence, і size_multiplier. Надсилайте ваш ключ у X-API-Key заголовку — дивіться повну документацію.

Потрібен ключ? Зареєструйтесь безкоштовно, скопіюйте його з вашого панелі керування, та замініть sm_your_key нижче.

Рецепт 1

Підтвердити перед входом (Python)

Канонічний цикл. Перед тим як ваша стратегія відкриє позицію, запитайте API, чи згодна ринкова структура. Входьте лише тоді, коли action == "CONFIRM".

Python

import requests

API_KEY = sm_your_key
BASE = https://api.smartmoneyapi.com/v1
def підтвердити(symbol, direction):
    r = requests.get(
        f{BASE}/confirm,
        params={"symbol": symbol, "direction": direction},
        headers={"X-API-Key": API_KEY},
        timeout=5,
    )
    r.raise_for_status()
    return r.json() sig =
confirm(BTC, лонг)
якщо sig[дія] == ПІДТВЕРДИТИ:
    place_order(BTC, лонг)   # ваше виконання
інакше:
    друк(пропустити:, sig[причини])

Відповідь
{
  "symbol": "BTC",
  "direction": "long",
  "action": "CONFIRM",
  "confidence": "HIGH",
  "composite": 0.74,
  "size_mult": 1.5,
  "reasons": ["Фінансування позитивне на всіх майданчиках", "Кити 67% у лонгах"]
}

Рецепт 2

Налаштуйте сигнал Freqtrade

Перевизначення confirm_trade_entry щоб Freqtrade приймав угоди лише після підтвердження API. Помилка відкрити при помилках API, щоб тайм-аут не блокував усі угоди.

Python — Freqtrade

import requests
from freqtrade.strategy import IStrategy

class SmartMoneyStrategy(IStrategy): "sm_your_key"
    "https://api.smartmoneyapi.com/v1" def
confirm_trade_entry (self, pair, order_type, amount, rate, time_in_force, current_time, entry_tag, **kwargs):splitif("/")[0]
        symbol not in "BTC" ("ETH", "SOL", return True):
            try
:get(f"{self.SM_BASE}/confirm","symbol": symbol, "direction": "long"},"X-API-Key": self.SM_KEY},3,
            ).timeout=()
            json р.отримати("дія") == "ПІДТВЕРДИТИ"
за винятком Виняток:
            повернути True # не вдається відкрити через помилку API

Рецепт 3

Розмір за size_multiplier

Дозвольте переконанню визначати розмір позиції. Помножте ваш базовий розмір на size_mult (0.0–1.5), щоб високо-впевнені угоди отримували більше капіталу, а слабкі — менше.

Python

BASE_SIZE_USD = 1000

sig = підтвердити("ETH", long) mult = sig.get("size_mult", 0.0size = BASE_SIZE_USD * mult

якщо розмір > 0:
    розмістити_замовлення(ETH, лонг, size_usd=size)
    print(f"введено ${size:.0f} (мульт {mult})")

A size_mult значення 0.0 означає не входити — той самий результат, що й SKIP. Вважайте будь-що нижче вашого мінімуму як пропуск.

Рецепт 4

Пропустити на SKIP / зменшити на REDUCE

Обробляйте всі три дії явно. CONFIRM входить на повний розмір, REDUCE входить на (менший) множник, SKIP залишається осторонь.

Python

sig = підтвердити(символ, напрямок)
action = sig["дія"]

якщо дія == "ПІДТВЕРДИТИ":
    розмістити_замовлення(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
elif action == "REDUCE":
    # структура змішана — увійти меншим, підтягнути стоп
розмістити_замовлення(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
else:  # ПРОПУСТИТИ
log(f"skip {symbol} {direction}: {sig['reasons']}")

Рецепт 5

Обробка 402 / 429

A 402 означає, що символ або кінцева точка потребують вищого плану; 429 означає, що ви досягли ліміту швидкості. Вважайте 429/5xx тимчасовими (відступити), 402/401/403 як термінальні (виправити план або ключ).

Python

import time, requests

def confirm_safe(symbol, direction, retries=3):
    for attempt in range(повторні спроби):get(f"{BASE}/confirm",{"symbol" "direction": direction},
            headers={"X-API-Key": API_KEY}, timeout=5,
        )
        if r.status_code == 200:
            return r.json()
        якщо r.status_code в (401, 402, 403):
            викликати RuntimeError(r.json())   # terminal: виправити ключ/план
якщо r.status_code == 429: reset =int(r.headers.(отримати, 2)) час.сон(хв(скинути, 2 ** спроба))
            продовжити
        час.sleep(2 ** спроба)        # 5xx / тимчасовий
return None

Рецепт 6

Використовуйте з кодувальним агентом

Надайте Claude Code, Codex або Cursor машинозчитні посилання та дозвольте йому налаштувати інтеграцію. Вкажіть йому /llms.txt для огляду та специфікацію OpenAPI для точних структур.

Підказка

# Вставте в Claude Code / Cursor / Codex
Прочитайте https://smartmoneyapi.com/llms.txt та специфікацію OpenAPI на github.com/tashiardit/smartmoneyapi-docs, потім додайте перевірку перед торгівлею до мого бота: викличте GET /v1/confirm з моїм X-API-Key і пропустіть будь-який вхід, якщо action != "CONFIRM". Масштабуйте розмір за size_multiplier.

Ресурси: /llms.txt · Специфікація OpenAPI · Python клієнт.

Готові здійснити свою першу угоду?

Отримайте безкоштовний ключ і прочитайте повний опис кінцевих точок.

Отримайте безкоштовний API ключ Повна документація

Підтримка прийняття рішень, не поради щодо виконання. Не фінансова порада. Торгівля криптовалютою пов'язана зі значним ризиком втрати.