Kuchařka

API Kuchařka

Praktické, kopírovatelné recepty pro nejběžnější způsoby integrace obchodního potvrzovacího API Smart Money do bota. Každý recept volá GET /v1/confirm a reaguje na action, confidence, a size_multiplier. Odešlete svůj klíč v hlavičce X-API-Key — viz kompletní dokumentace.

Potřebujete nejprve klíč? Zaregistrujte se zdarma, zkopírujte jej ze svého nástěnkya nahraďte sm_your_key níže.

Recept 1

Potvrdit před vstupem (Python)

Kanonická smyčka. Než vaše strategie otevře pozici, zeptejte se API, zda souhlasí tržní struktura. Vstupujte pouze, když action == "CONFIRM".

Python

import requests "sm_your_key"
"https://api.smartmoneyapi.com/v1" def
confirm (symbol, direction):get(f"{BASE}/confirm","symbol": symbol,"direction" : direction},"X-API-Key": API_KEY},timeout=5,raise_for_status()
    return r.json() confirm("BTC", "long")
if sig["action"] == ] == "CONFIRM"::
    place_order("BTC", "long")   # váš execution
else::
    print("skip:", sig["reasons"])

Odpověď
{
  "symbol": "BTC",
  "direction": "long",
  "action": "CONFIRM",
  "confidence": "HIGH",
  "composite": 0.74,
  "size_mult": 1.5,
  "reasons": ["Funding positive across venues", "Whales 67% long"]
}

Recept 2

Omezit Freqtrade signál

Přepsat confirm_trade_entry tak, aby Freqtrade vstupoval pouze při potvrzení API. Při chybách API otevřít pozici, aby timeout neblokoval veškeré obchodování.

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,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},timeout=3,
            ).json()
            return r.získat("akce") == "POTVRDIT"
kromě Výjimka:
            return True # v případě chyby API nechat otevřeno

Recept 3

Velikost podle size_multiplier

Nechte přesvědčení určit velikost pozice. Vynásobte svou základní velikost size_mult (0.0–1.5), aby vysoce důvěryhodné obchody získaly více kapitálu a slabé méně.

Python

BASE_SIZE_USD = 1000

sig = potvrdit("ETH", long) mult = sig.get("size_mult", 0.0velikost = BASE_SIZE_USD * mult

pokud velikost > 0:
    vytvořit_objednávku(ETH, long, size_usd=size)
    print(f"vstoupil ${size:.0f} (násobek {mult})")

A size_mult hodnota 0.0 znamená nevstupovat — stejný výsledek jako SKIP. Jakákoli hodnota pod vaší vlastní hranicí se považuje za skip.

Recept 4

Přeskočit při SKIP / snížit při REDUCE

Explicitně ošetřete všechny tři akce. CONFIRM vstupuje v plné velikosti, REDUCE vstupuje s (menším) násobkem, SKIP zůstává stranou.

Python

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

if action == "CONFIRM":
    place_order(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
elif action == "REDUCE":
    # struktura je smíšená — vstupte menší, utáhněte stop
place_order(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
else:  # SKIP
log(f"skip {symbol} {direction}: {sig['reasons']}")

Recept 5

Zpracování 402 / 429

A 402 znamená, že symbol nebo endpoint vyžaduje vyšší plán; 429 znamená, že jste dosáhli limitu rychlosti. Zacházejte s 429/5xx jako s přechodnými (zpomalte), 402/401/403 jako s konečnými (opravte plán nebo klíč).

Python

import time, requests

def confirm_safe(symbol, direction, retries=3):
    pro pokus v rozsahu(opakování):get(f"{BASE}/confirm","symbol" směr: direction}, headers={X-API-Key: API_KEY}, timeout=5,
        )
        pokud r.status_code == 200:
            vrátit r.json()
        pokud r.status_code v (401, 402, 403):
            vyvolat RuntimeError(r.json())   # terminál: opravit klíč/plán
pokud r.status_code == 429: reset =int(r.headers.(získat, 2)) čas.spánek(min(reset, 2 ** pokus))
            pokračovat
        čas.spánek(2 ** pokus)        # 5xx / přechodné
vrátit None

Recept 6

Použijte s kódovacím agentem

Dejte Claudovi Code, Codexu nebo Cursoru strojově čitelné reference a nechte ho propojit integraci. Nasměrujte ho na /llms.txt pro přehled a OpenAPI specifikaci pro přesné tvary.

Prompt

# Vložit do Claude Code / Cursor / Codex
Přečtěte si https://smartmoneyapi.com/llms.txt a specifikaci OpenAPI na github.com/tashiardit/smartmoneyapi-docs, poté přidejte předobchodní kontrolu do mého botu: zavolejte GET /v1/confirm s mým X-API-Key a přeskočte jakýkoli vstup, pokud action != "CONFIRM". Upravte velikost podle size_multiplier.

Zdroje: /llms.txt · Specifikace OpenAPI · Python klient.

Jste připraveni uzavřít svůj první obchod?

Získejte zdarma klíč a přečtěte si kompletní referenci endpointů.

Získejte zdarma API klíč Kompletní dokumentace

Podpora rozhodování, nikoli investiční doporučení. Nejedná se o finanční poradenství. Obchodování s kryptoměnami s sebou nese značné riziko ztráty.