Libro de recetas

Libro de recetas de la API

Recetas prácticas y listas para copiar y pegar para las formas más comunes de integrar la API de confirmación de operaciones de Smart Money en un bot. Cada receta llama GET /v1/confirm y actúa sobre action, confidence, size_multiplier. Envía tu clave en el encabezado X-API-Key — consulta la documentación completa.

¿Necesitas una clave primero? Regístrate gratis, cópiala desde tu panel de control, y reemplaza sm_your_key a continuación.
Receta 1

Confirmar antes de entrar (Python)

El bucle canónico. Antes de que tu estrategia abra una posición, consulta a la API si la estructura del mercado está de acuerdo. Solo entra cuando action == "CONFIRM".

Python
importar requests "sm_your_key" "https://api.smartmoneyapi.com/v1" def confirmar (símbolo, dirección):obtener(f"{BASE}/confirm","símbolo": símbolo, "dirección": dirección},"X-API-Key": API_KEY},5tiempo de espera=,() levantar_para_estado devolver.json ()(confirmar, "BTC") "long" si["acción"]] == == "CONFIRMAR": colocar_orden("BTC", "long") # tu ejecución si no: imprimir("omitir:", sig["razones"]Respuesta])
"símbolo"
{ "BTC": "dirección", "long": "acción", "CONFIRMAR": "confianza", "ALTA": "compuesto", "tamaño_mult": 0.74, "razones": 1.5, "Financiamiento positivo en todas las plataformas": ["Ballenas 67% en largo", Receta 2] }
Controlar una señal de Freqtrade

Anular

para que Freqtrade solo tome entradas que la API confirme. Fallar confirm_trade_entry abrir en errores de la API para que un tiempo de espera nunca bloquee todo el trading. Python — Freqtrade

Copiar
requests desde freqtrade.strategy importar IStrategy clase SmartMoneyStrategy (IStrategy):"sm_your_key" "https://api.smartmoneyapi.com/v1" def confirmar_entrada_de_operación (self, par, tipo_de_orden, cantidad, tasa, tiempo_en_force, hora_actual, etiqueta_de_entrada, **kwargs): dividirsisímbolo("/")[0] no está en "BTC" "ETH" ("SOL", devolver True, intentar): : obtener(f"{self.SM_BASE}/confirm","símbolo": símbolo,"dirección" "long": },"X-API-Key": self.SM_KEY},tiempo de espera=3, ).json() devolver r.obtener("acción") == "CONFIRMAR" excepto Excepción: devuelve True # falla abierta en error de API
Receta 3

Tamaño por size_multiplier

Deja que la convicción establezca el tamaño de la posición. Multiplica tu tamaño base por size_mult (0.0–1.5) para que las operaciones de ALTA confianza obtengan más capital y las débiles obtengan menos.

Python
BASE_SIZE_USD = 1000 sig = confirmar("ETH", "long") mult = sig.obtener("size_mult", 0.0size = BASE_SIZE_USD * mult if tamaño > 0: realizar_orden(ETH, larga, size_usd=size) imprimir(f"entró ${size:.0f} (mult {mult})")
A size_mult de 0.0 significa no entrar — mismo resultado que un SKIP. Trata cualquier valor por debajo de tu propio mínimo como un skip.
Receta 4

Saltar en SKIP / reducir en REDUCE

Maneja las tres acciones explícitamente. CONFIRM entra con tamaño completo, REDUCE entra con el multiplicador (menor), SKIP se abstiene.

Python
sig = confirmar(symbol, direction) action = sig["action"] si action == "CONFIRM": realizar_orden(símbolo, dirección, BASE_SIZE_USD * sig["size_mult"]) elif acción == "REDUCE": # la estructura es mixta — entrar más pequeño, ajustar stop realizar_orden(símbolo, dirección, BASE_SIZE_USD * sig["size_mult"]) else: # SKIP registrar(f"omitir {símbolo} {dirección}: {sig['razones']}")
Receta 5

Manejar 402 / 429

A 402 significa que el símbolo o endpoint necesita un plan superior; 429 significa que alcanzaste un límite de tasa. Trata 429/5xx como transitorio (retrocede), 402/401/403 como terminal (corrige el plan o la clave).

Python
importar time, requests def confirmar_seguro(símbolo, dirección, reintentos=3): para intento en rango(reintentos): r = requests.get( f{BASE}/confirm, params={"symbol": symbol, dirección: dirección},X-API-Key: API_KEY}, tiempo de espera=5, ) si r.código_de_estado == 200: devolver r.json() si r.status_code en (401, 402, 403): lanzar RuntimeError(r.json()) # terminal: corregir clave/plan si r.status_code == 429: reset =int(r.headers.(obtener, 2))tiempo.(dormirmin 2 (reiniciar, ** intento)) continuartiempo.(2 dormir ** intento) # 5xx / transitorio
devolver Ninguno

Receta 6

Usar con un agente de programación /llms.txt Proporciona a Claude Code, Codex o Cursor las referencias legibles por máquina y deja que realice la integración. Dirígelo a

Prompt
# Pegar en Claude Code / Cursor / Codex Lee https://smartmoneyapi.com/llms.txt y la especificación OpenAPI en github.com/tashiardit/smartmoneyapi-docs, luego añade una verificación previa a la operación en mi bot: llama a GET /v1/confirm con mi X-API-Key, y omite cualquier entrada a menos que action == "CONFIRM". Escala el tamaño por size_multiplier.

Recursos: /llms.txt · Especificación OpenAPI · Cliente Python.

¿Listo para ejecutar tu primera operación?

Obtén una clave gratuita y lee la referencia completa de los endpoints.

Soporte para la toma de decisiones, no consejos de ejecución. No es asesoramiento financiero. El comercio de criptomonedas implica un riesgo sustancial de pérdida.