Cookbook

API Cookbook

Praktikal, kopya-paste na mga recipe para sa pinakakaraniwang paraan upang ikonekta ang Smart Money trade-confirmation API sa isang bot. Ang bawat recipe ay tumatawag GET /v1/confirm at kumikilos sa action, confidence, at size_multiplier. Ipadala ang iyong key sa X-API-Key header — tingnan ang buong docs.

Kailangan mo muna ng key? Mag-sign up nang libre, kopyahin ito mula sa iyong dashboard, at palitan ang sm_your_key sa ibaba.

Recipe 1

Kumpirmahin bago pumasok (Python)

Ang karaniwang loop. Bago magbukas ng posisyon ang iyong estratehiya, tanungin ang API kung sang-ayon ang istruktura ng merkado. Pumasok lamang kapag action == "CONFIRM".

Python

import requests

API_KEY = sm_your_key
BASE = https://api.smartmoneyapi.com/v1
def kumpirmahin(symbol, direction):
    r = requests.kumuha(
        f{BASE}/confirm,
        params={"symbol": symbol, "direction": direction},
        headers={"X-API-Key": API_KEY},
        timeout=5,
    )
    r.raise_for_status()
    return r.json()

sig = kumpirmahin(BTC, long)
kung sig["aksyon"] == "KONFIRMA":
    maglagay_ng_order(BTC, long)   # ang iyong execution
kung_hindi:
    i-print("laktawan:", sig["mga_dahilan"])

Tugon
{
  "symbol": "BTC",
  "direction": "long",
  "action": "CONFIRM",
  "confidence": "HIGH",
  "composite": 0.74,
  "size_mult": 1.5,
  "reasons": ["Positive ang funding sa lahat ng venues", "67% ng whales ay long"]
}

Recipe 2

Gate a Freqtrade signal

Override confirm_trade_entry kaya ang Freqtrade ay kumukuha lamang ng mga entry na kinukumpirma ng API. Fail open sa mga error ng API para hindi hadlangan ng timeout ang lahat ng 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 kumpirmahin_ang_pasok_ng_trade(self, pair, order_type, amount, rate,
                            time_in_force, current_time, entry_tag, **kwargs):
        symbol = pairsplit("/")[0]
        kung simbolo wala sa ("BTC", "ETH", "SOL"):
            ibalik ang True
subukan:kumuha(f"{self.SM_BASE}/confirm","symbol": symbol, "direction": "long"},"X-API-Key": self.SM_KEY},3,
            ).timeout=()
            json r.kumuha("aksyon") == "KONFIRMA"
maliban Exception:
            ibalik ang True # hindi magsara sa API error

Recipe 3

Sukat ayon sa size_multiplier

Hayaan ang kumpiyansa ang magtakda ng laki ng posisyon. I-multiply ang iyong base size sa size_mult (0.0–1.5) upang ang HIGH-confidence trades ay makakuha ng mas maraming kapital at ang mahina ay mas kaunti.

Python

BASE_SIZE_USD = 1000

sig = kumpirmahin("ETH", "long")
mult = sig.kunin("size_mult", 0.0laki = BASE_SIZE_USD * mult

kung laki > 0:
    maglagay_ng_order(ETH, long, size_usd=size)
    print(f"pumasok ng ${size:.0f} (mult {mult})")

A size_mult ang 0.0 ay nangangahulugang huwag pumasok — parehong resulta sa isang SKIP. Ituring ang anumang bagay na mas mababa sa iyong sariling sahig bilang isang skip.

Recipe 4

Skip sa SKIP / bawasan sa REDUCE

Hawakan nang tahasan ang lahat ng tatlong aksyon. Ang CONFIRM ay pumapasok sa buong laki, ang REDUCE ay pumapasok sa (mas maliit) na multiplier, ang SKIP ay tumatabi.

Python

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

kung action == "CONFIRM":
    maglagay_ng_order(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
kung_hindi action == "REDUCE":
    # magkahalong istraktura — pumasok nang mas maliit, higpitan ang stop
maglagay_ng_order(symbol, direction, BASE_SIZE_USD * sig["size_mult"])
kung_hindi:  # LAMPASAN
log(f"lampasan {symbol} {direction}: {sig['reasons']}")

Recipe 5

I-handle ang 402 / 429

A 402 ibig sabihin ang symbol o endpoint ay nangangailangan ng mas mataas na plan; ang 429 ibig sabihin naabot mo ang rate limit. Ituring ang 429/5xx bilang pansamantala (mag-back off), ang 402/401/403 bilang terminal (ayusin ang plan o key).

Python

import time, requests

def confirm_safe(symbol, direction, retries=3):
    para sa attempt sa range(mga pagsubok):kumuha(f"{BASE}/confirm","symbol" "direksyon": direksyon},"X-API-Key": API_KEY}, timeout=5,
        )
        kung r.status_code == 200:
            ibalik r.json()
        kung r.status_code sa (401, 402, 403):
            itaas RuntimeError(r.json())   # terminal: ayusin ang key/plan
kung r.status_code == 429: reset =int(r.headers.(kunin, 2))            oras.tulog(min(reset, 2 ** subok))
            magpatuloy
        oras.tulog(2 ** subukan)        # 5xx / pansamantala
return None

Recipe 6

Gamitin kasama ang coding agent

Ibigay kay Claude Code, Codex, o Cursor ang machine-readable references at hayaan itong magkabit ng integrasyon. Ituro ito sa /llms.txt para sa overview at ang OpenAPI spec para sa eksaktong mga hugis.

Prompt

# I-paste sa Claude Code / Cursor / Codex
Basahin ang https://smartmoneyapi.com/llms.txt at ang OpenAPI spec sa github.com/tashiardit/smartmoneyapi-docs, pagkatapos ay magdagdag ng pre-trade check sa aking bot: tawagan ang GET /v1/confirm gamit ang aking X-API-Key, at laktawan ang anumang entry maliban kung action == "CONFIRM". I-scale ang size ayon sa size_multiplier.

Mga Mapagkukunan: /llms.txt · OpenAPI spec · Python client.

Handa ka na bang i-gate ang iyong unang trade?

Kumuha ng libreng key at basahin ang buong endpoint reference.

Kumuha ng libreng API key Buong docs

Desisyon support, hindi execution advice. Hindi financial advice. Ang cryptocurrency trading ay may malaking panganib ng pagkalugi.