Cookbook

API Cookbook

Resep praktis siap salin-tempel untuk cara paling umum menghubungkan API konfirmasi perdagangan Smart Money ke bot. Setiap resep memanggil GET /v1/confirm dan bertindak berdasarkan action, confidence, size_multiplierdan X-API-Key . Kirim kunci Anda di header — lihat.

dokumentasi lengkap Perlu kunci terlebih dahulu?Daftar gratis , salin daridashboard sm_your_key , dan ganti

di bawah.

Resep 1

Konfirmasi sebelum masuk (Python) action == "CONFIRM".

Loop standar. Sebelum strategi Anda membuka posisi, tanyakan pada API apakah struktur pasar setuju. Masuk hanya ketika

Salin import requests
"sm_your_key" "https://api.smartmoneyapi.com/v1"
def confirm(symbol, direction):
    r = requests.get({BASE}/confirm,
        params={"symbol": simbol, "arah": arah},"X-API-Key"API_KEY}, timeout=5, ) r.raise_for_status()
    return r.json() sig = confirm(BTC, long)
jika sig["action"] == "CONFIRM":
    place_order("BTC", "long")   # eksekusi Anda
lain:
    cetak("skip:", sig["reasons"])

Response
{
  "symbol": "BTC",
  "direction": "long",
  "action": "CONFIRM",
  "confidence": "HIGH",
  "composite": 0.74,
  "size_mult": 1.5,
  "reasons": ["Funding positif di berbagai venue", "Paus 67% long"]
}

Resep 2

Gerbang sinyal Freqtrade

Timpa confirm_trade_entry sehingga Freqtrade hanya mengambil entri yang dikonfirmasi API. Gagal buka pada error API sehingga timeout tidak pernah memblokir semua trading.

Python — Freqtrade

import requests
from freqtrade.strategy import IStrategy

class SmartMoneyStrategy(IStrategy):
    SM_KEY = "sm_your_key"
    SM_BASE = "https://api.smartmoneyapi.com/v1"
def confirm_trade_entry(self, pair, order_type, amount, rate,
                            time_in_force, current_time, entry_tag, **kwargs):
        symbol = pair.split("/")[0]
        if symbol not in ("BTC", "ETH", "SOL"):
            return True
coba:r = requests.("{self.SM_BASE}/confirm","symbol": simbol, "arah": "long"},"X-API-Key": self.SM_KEY},3,
            ).waktu tunggu=()
            mengembalikan r.dapatkan("action") == "CONFIRM"
kecuali Exception:
            return True # gagal terbuka pada error API

Resep 3

Ukuran berdasarkan size_multiplier

Biarkan keyakinan menentukan ukuran posisi. Kalikan ukuran dasar Anda dengan size_mult (0.0–1.5) agar perdagangan dengan keyakinan TINGGI mendapatkan lebih banyak modal dan yang lemah mendapatkan lebih sedikit.

Python

BASE_SIZE_USD = 1000

sig = konfirmasi("ETH", "long")
mult = sig.dapatkan("size_mult", 0.0)

jika ukuran > 0:
    tempatkan_pesanan(ETH, long, size_usd=size)
    print(f"masuk ${size:.0f} (mult {mult})")

A size_mult 0.0 berarti tidak masuk — hasil yang sama dengan SKIP. Perlakukan apa pun di bawah batas Anda sendiri sebagai skip.

Resep 4

Skip pada SKIP / kurangi pada REDUCE

Tangani ketiga aksi secara eksplisit. CONFIRM masuk dengan ukuran penuh, REDUCE masuk dengan (lebih kecil) pengali, SKIP tidak melakukan apa-apa.

Python

sig = konfirmasi(symbol, direction)
action = sig["action"]

jika action == "CONFIRM":
    place_order(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
elif action == "REDUCE":
    # strukturnya campuran — masuk lebih kecil, perketat stop
place_order(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
else:  # SKIP
log(f"skip {symbol} {direction}: {sig['reasons']}")

Resep 5

Tangani 402 / 429

A 402 berarti simbol atau endpoint memerlukan paket yang lebih tinggi; 429 berarti Anda mencapai batas kecepatan. Perlakukan 429/5xx sebagai sementara (mundur), 402/401/403 sebagai akhir (perbaiki paket atau kunci).

Python

import time, requests

def confirm_safe(symbol, direction, retries=3):
    for attempt in range(retries):get({BASE}/confirm,"symbol": symbol, "direction": direction},"X-API-Key": API_KEY}, timeout=5,
        )
        if r.status_code == 200:
            return r.json()
        jika r.status_code di (401, 402, 403):
            naikkan RuntimeError(r.json())   # terminal: perbaiki kunci/rencana
jika r.status_code == 429: reset =int(r.headers.(dapatkan, 2)) waktu.tidur(menit(reset, 2 ** mencoba))
            lanjutkan
        waktu.tidur(2 ** upaya)        # 5xx / sementara
kembalikan None

Resep 6

Gunakan dengan agen coding

Berikan Claude Code, Codex, atau Cursor referensi yang dapat dibaca mesin dan biarkan mereka menyambungkan integrasi. Arahkan ke /llms.txt untuk ikhtisar dan spesifikasi OpenAPI untuk bentuk yang tepat.

Prompt

# Tempelkan ke Claude Code / Cursor / Codex
Baca https://smartmoneyapi.com/llms.txt dan spesifikasi OpenAPI di github.com/tashiardit/smartmoneyapi-docs, lalu tambahkan pemeriksaan pra-perdagangan ke bot saya: panggil GET /v1/confirm dengan X-API-Key saya, dan lewati entri apa pun kecuali action == "CONFIRM". Skalakan ukuran dengan size_multiplier.

Sumber daya: /llms.txt · Spesifikasi OpenAPI · Klien Python.

Siap untuk membatasi perdagangan pertama Anda?

Dapatkan kunci gratis dan baca referensi endpoint lengkap.

Dapatkan kunci API gratis Dokumentasi lengkap

Dukungan keputusan, bukan saran eksekusi. Bukan saran finansial. Perdagangan cryptocurrency melibatkan risiko kerugian yang besar.