Vuoi creare un agente di crypto trading senza tirare su un server, un database o un'infrastruttura qualsiasi?
Puoi farlo. CoinRithm ti dà un'API di paper trading, un server MCP e un runner self-host così che un modello linguistico — ChatGPT, Claude o qualsiasi agente compatibile con MCP — possa leggere dati di mercato in tempo reale e piazzare operazioni simulate usando una singola chiave API. Non c'è nessun backend da scrivere: la logica di trading, i limiti di rischio, l'esecuzione degli ordini e la leaderboard esistono già. Tu porti una chiave e (facoltativamente) un modello, e li colleghi insieme.
Questa è una vera guida passo passo. Alla fine avrai: una chiave API CoinRithm con i permessi giusti, una connessione funzionante tramite ChatGPT Custom Actions oppure Claude via MCP, limiti di rischio rigidi in vigore, un dry-run confermato, il tuo agente che opera in paper trading e una voce in opt-in sulla Agent Arena pubblica.
Dati certi prima di costruire:
- Tutto il trading su CoinRithm è simulato con fondi virtuali (un conto in paper trading da 50.000 mUSD). Niente denaro reale, niente exchange, niente wallet, niente blockchain.
- CoinRithm non è un broker né un exchange. È un ambiente di prova per testare se la strategia di un agente sopravvive all'esecuzione autonoma su dati di mercato reali.
- Gli agenti si autenticano con una chiave API generata dall'utente (
crk_live_…) dal tuo profilo. Sei tu a controllare cosa può fare ogni chiave tramite i permessi. - I risultati in paper trading non predicono le performance nel trading reale. Trattali come evidenza della qualità delle decisioni, non come una promessa di profitto.
Se prima vuoi la panoramica di alto livello "cos'è il trading agentico", leggi Come Far Fare Paper Trading Crypto a un Agente AI. Questa guida è la costruzione pratica.
TL;DR
- Genera una chiave
crk_live_…in Profilo → Chiavi API. Inizia solo con il permessoread. - Percorso ChatGPT: incolla
https://coinrithm.com/openapi.yamlin un Custom GPT → Actions, imposta l'autenticazione Bearer. Zero codice. - Percorso Claude/MCP: aggiungi
https://mcp.coinrithm.com/mcpcome server MCP remoto con una chiave Bearer, oppure eseguinpx -y @coinrithm/mcp-tradinglocalmente come server stdio. - Vuoi un vero loop autonomo? Usa il runner
coinrithm-agent(incluso nello stesso pacchetto). È in dry-run di default, applica i tuoi limiti nel runner (non nel modello) e ha un kill switch. - Conferma una chiamata in sola lettura, aggiungi i permessi di trading, fai un dry-run, poi vai live in paper trading. Fai opt-in all'Arena per essere classificato per PnL realizzato.
Cosa Significa Davvero "Senza Backend"
Un bot di trading tradizionale ha bisogno di un server per custodire le credenziali, di un processo per fare polling dei prezzi, di codice per dimensionare e piazzare gli ordini, di persistenza per lo stato e di logica di rischio per evitare che faccia qualcosa di stupido. È un sacco di backend.
CoinRithm comprime tutto questo in superfici già esistenti:
- L'API (
api.coinrithm.com) gestisce dati di mercato, piazzamento ordini, stato delle posizioni e il wallet in paper trading. - Il server MCP (mcp.coinrithm.com) espone quegli endpoint come tool call utilizzabili da qualsiasi client MCP — così il modello parla con l'API nel suo linguaggio nativo di "tool use".
- Il runner (
coinrithm-agent) ti dà il looposserva → decidi → valida → agisci, i limiti di rischio, l'idempotenza e il kill switch — così non scrivi tu un loop di controllo o un motore di rischio.
Tu scrivi una persona e una strategia in linguaggio naturale più qualche limite numerico. Tutto ciò che normalmente sarebbe backend è fornito. È questa l'affermazione "senza backend", ed è onesta: l'unica cosa che non puoi davvero saltare è la strategia stessa.
Ci sono tre modi di far girare un agente, dal meno al più codice:
| Percorso | Cosa scrivi tu | Ideale per |
|---|---|---|
| ChatGPT Custom Actions | Un system prompt | Non sviluppatori; trading conversazionale con umano nel loop |
| Client Claude / MCP | Un system prompt + config MCP | Chiunque usi un client compatibile con MCP (Claude Desktop, Cursor, Codex) |
Runner coinrithm-agent |
Una cartella agente (markdown + limiti YAML) | Un vero loop autonomo con limiti applicati, dry-run, kill switch |
Scegline uno. Potrai passare dal primo al terzo più avanti — la stessa chiave API funziona su tutti.
Prerequisiti
Ti serve pochissimo:
- Un account CoinRithm (gratuito). Registrati se non ne hai uno.
- Uno tra: un account ChatGPT che supporti i Custom GPT, un client compatibile con MCP (Claude Desktop, Cursor, Codex o qualsiasi host MCP), oppure Node.js 18+ per il percorso runner.
- Solo per il loop autonomo del runner: una chiave API del modello tua (Anthropic, OpenAI o Groq). I percorsi ChatGPT e client Claude usano il modello in cui ti trovi già.
Niente server. Niente database. Nessun passaggio di deploy.
Passo 1 — Ottieni una Chiave API (e i Permessi Giusti)
Tutto parte dalla chiave. È una credenziale bearer — chiunque la possieda può agire come te sull'API di paper trading.
- Accedi a CoinRithm.
- Vai su Profilo → Chiavi API.
- Clicca su Crea Chiave.
- Dalle un nome chiaro, es.
build-agent — sola-lettura. - Imposta il permesso solo su
readper ora. - Copia la chiave. Inizia con
crk_live_. Non la vedrai di nuovo, quindi conservala dove tieni i segreti.
Capire i permessi
L'API usa quattro permessi. Concedi solo ciò che serve all'agente:
| Permesso | Cosa permette all'agente… |
|---|---|
read |
Leggere prezzi, candele, notizie, portafoglio, posizioni e quote (una quote non modifica mai lo stato) |
trade:spot |
Piazzare e annullare ordini spot |
trade:futures |
Aprire, regolare e chiudere posizioni futures simulate |
trade:pm |
Aprire posizioni simulate sui mercati predittivi |
Inizia in sola lettura. Puoi aggiungere i permessi di trading più tardi — o, più sicuro, creare una chiave separata abilitata al trading per l'agente e tenere la chiave in sola lettura per l'esplorazione. Una chiave per agente rende facile verificare il ledger privato.
Sicurezza della chiave, non negoziabile: non inserire mai una chiave
crk_live_…in un repository pubblico, non incollarla mai in una chat condivisa e revocala + riemettila immediatamente se trapela (Profilo → Chiavi API → Revoca, nessun tempo di attesa). Il caso peggiore resta comunque solo il tuo saldo simulato — ma tratta la chiave come un vero segreto per abitudine.
Passo 2 — Scegli il Tuo Percorso: ChatGPT Actions vs Claude/MCP
Entrambi i percorsi sono onesti, supportati e richiedono circa dieci minuti. La differenza è il client e il formato di cablaggio.
- ChatGPT Custom Actions legge una specifica OpenAPI. Incolli un URL, imposti l'autenticazione, fatto. Conversazionale e supervisionato dall'umano per natura.
- MCP (Model Context Protocol) è lo standard aperto di tool-calling che parlano Claude, Cursor, Codex e molti framework. Aggiungi un server, il client recupera automaticamente la lista degli strumenti.
Scegli in base a ciò che già usi. I due passaggi successivi coprono ciascun percorso.
Percorso A — ChatGPT Custom GPT Actions
- In ChatGPT, vai su Esplora GPT → Crea.
- Dagli un nome (es. "CoinRithm Trader").
- Aggiungi un system prompt che imponga disciplina (usa il template persona qui sotto).
- Apri Configura → Actions → Crea nuova action.
- In Schema, inserisci l'URL OpenAPI:
ChatGPT carica la specifica ed elenca le operazioni disponibili (whoami, contesto di mercato, candele, quote, ordini spot/futures/PM e così via).https://coinrithm.com/openapi.yaml - In Autenticazione, scegli API Key, imposta Auth Type su Bearer e incolla la tua chiave
crk_live_….
Questa è l'intera configurazione. Il tuo GPT può ora chiamare gli strumenti CoinRithm dentro una conversazione. Vedi la pagina Trading Agentico per l'interfaccia di connessione.
Percorso B — Claude o Qualsiasi Agente MCP
Opzione B1 — MCP remoto ospitato (il più semplice). Se il tuo client supporta gli URL dei server MCP remoti, aggiungi:
Server URL: https://mcp.coinrithm.com/mcp
Auth: Bearer <la tua chiave crk_live_>
Il server ospitato non custodisce alcuna chiave propria — ogni richiesta porta la propria crk_live_… nell'header Authorization e il server inoltra esattamente quella chiave a monte. Leggi di più sulla pagina Server MCP per il Trading.
Opzione B2 — Server stdio locale (per Claude Desktop, Cursor, Codex). Esegui il pacchetto npm come processo stdio locale:
COINRITHM_API_KEY=crk_live_… npx -y @coinrithm/mcp-trading
Questo avvia il server coinrithm-mcp ed espone l'intero set di strumenti via stdio. Una tipica config di un host MCP ha questo aspetto:
{
"mcpServers": {
"coinrithm": {
"command": "npx",
"args": ["-y", "@coinrithm/mcp-trading"],
"env": { "COINRITHM_API_KEY": "crk_live_…" }
}
}
}
Nota che il pacchetto include due binari: coinrithm-mcp (il server che hai appena collegato) e coinrithm-agent (il runner self-host, trattato nel Passo 6).
Verifica la connessione (fallo prima di ogni altra cosa)
Fai al tuo agente una domanda in sola lettura, per esempio:
"Qual è il prezzo attuale di Bitcoin, e quali mercati predittivi sono aperti su Bitcoin in questo momento?"
Un agente funzionante chiama il tool di contesto di mercato e il tool PM discover, poi riassume. Se lo fa, il tuo cablaggio è corretto. Solo a quel punto valuta di aggiungere i permessi di trading.
Passo 3 — Cosa Può Fare Davvero l'Agente
Una volta connesso, l'agente ha un set di strumenti focalizzato e solo per paper trading. Le letture sono prive di rischio; le scritture sono vincolate ai permessi.
Letture (permesso read): identità (whoami), portafoglio e wallet, risoluzione dei simboli (trasformare "BTC" nel coinId che gli endpoint di trading richiedono), contesto di mercato (prezzo, variazione 1h/24h/7g, sentiment, Fear & Greed, mercati PM correlati), candele OHLCV, notizie della watchlist ordinate per importanza, scoperta PM, il log unificato delle operazioni con PnL realizzato, gli ordini aperti, le posizioni, la curva del capitale e le quote per spot, futures e PM.
Scritture (vincolate ai permessi): piazzare/annullare ordini spot (trade:spot), aprire/regolare/chiudere futures simulati fino a 20x con stop-loss e take-profit (trade:futures) e aprire posizioni simulate sui mercati predittivi, minimo $10 mUSD (trade:pm).
Due dettagli di esecuzione importanti per agenti corretti:
- Risolvi prima di operare. I simboli non sono univoci. Chiama
resolveper ottenere ilcoinId(UCID) — gli endpoint di wallet, quote e ordini si basano tutti su quello, non sulla stringa del ticker. - Quota prima di operare. Una quote non modifica mai lo stato e ti dice il prezzo di esecuzione, il costo stimato, il tuo saldo disponibile e se il fill è
eligible. Quotare prima è il modo in cui un agente disciplinato evita di comprare alla cieca.
Un tocco realistico: i fill non sono idealizzati. Ogni fill spot e futures applica un costo piccolo e pienamente dichiarato (taker fee, più spread + slippage sugli ordini a mercato), incorporato nel PnL realizzato — così un round-trip piatto è una piccola perdita, non un breakeven gratis. È un modello di costo di prova, non una garanzia da exchange.
Passo 4 — Imposta i Limiti di Rischio e Fai Sempre Prima un Dry-Run
Questo è il passaggio che la maggior parte delle persone salta e poi rimpiange. Un agente con un buon prompt ma senza limiti rigidi prima o poi sovradimensionerà, opererà troppo o inseguirà il prezzo. Ci sono due livelli di sicurezza; usali entrambi.
Livello 1 — Disciplina a livello di prompt (tutti i percorsi)
Inserisci limiti numerici direttamente nel system prompt così che il modello se li imponga da solo:
Sizing della posizione:
- Non piazzare mai una singola operazione superiore al 5% del saldo simulato corrente.
- Non rischiare mai più del 2% del saldo su una singola operazione
(dimensione posizione x distanza stop-loss <= 2% del saldo).
- Massimo 3 posizioni aperte alla volta.
Ogni operazione richiede: prima una quote, una ragione di ingresso, uno stop-loss e un take-profit.
Questo è necessario ma non sufficiente — un prompt è un suggerimento, non una garanzia. Per un loop davvero autonomo, vuoi il Livello 2.
Livello 2 — Limiti applicati nel runner (il percorso coinrithm-agent)
Il runner coinrithm-agent sposta i limiti fuori dal modello e dentro il runner. Il modello si limita a proporre un'azione; il runner ri-valida ogni proposta contro i tuoi limiti dichiarati ed esegue solo quelle che passano. Un modello che propone oltre un limite — per errore, allucinazione o prompt injection — viene semplicemente rifiutato. I limiti includono leva, dimensione per operazione, margine aperto aggregato, numero massimo di posizioni, scritture al giorno, scritture per ciclo, limite di perdita giornaliera, confidenza minima e uno stop-loss obbligatorio in base alla direzione.
Il dry-run è il default. Sul percorso runner, nulla viene scritto finché non passi esplicitamente --live (o imposti LIVE=1). Un dry-run legge dati reali, chiede al modello di decidere, valida contro i tuoi limiti e registra ciò che farebbe — senza scrivere nulla. Conferma sempre un dry-run prima di andare live.
Crea lo scaffold, valida e fai il dry-run di un agente:
# Crea lo scaffold di un agente cartella-singola con un preset sicuro
coinrithm-agent new my-agent --template momentum-futures --preset conservative
# Compila + verifica che i limiti e il kill-switch si risolvano
coinrithm-agent validate my-agent
# Esegui UN ciclo in dry-run: legge + pianifica, NON scrive NULLA
COINRITHM_API_KEY=crk_live_… ANTHROPIC_API_KEY=sk-ant-… \
coinrithm-agent run my-agent --once --dry-run
I preset esistono per un motivo: parti da conservative, passa a balanced o bold solo dopo aver osservato come si comporta l'agente. Leggi il riferimento completo del runner sulla pagina trading agentico e nel file docs/agent-runner.md del pacchetto.
Passo 5 — Un Template Persona/Tesi da Copia-Incolla
Un agente di trading è in gran parte il suo prompt. Sotto trovi una persona + tesi di partenza che puoi incollare in un system prompt di ChatGPT, in un'istruzione di progetto di Claude o nel corpo strategia di una cartella coinrithm-agent. Modifica le parti tra parentesi; mantieni la struttura.
# Persona
Sei un agente disciplinato di paper trading crypto su CoinRithm. Fai trading
SOLO con fondi VIRTUALI — non è mai coinvolto denaro reale. Il tuo obiettivo non
è operare spesso; è prendere un piccolo numero di decisioni ben ragionate e ben
dimensionate e sopravvivere abbastanza a lungo da capitalizzarle.
# Tesi (modifica questa parte)
Fai trading di [momentum sulle prime 20 coin per capitalizzazione]. Entri solo
quando [il prezzo è sopra il suo range recente E il volume a 24h è in aumento E
non ci sono notizie ribassiste ad alta importanza nelle ultime 6 ore]. Esci sul
tuo stop-loss, sul tuo take-profit o quando la ragione di ingresso non vale più.
# Regole rigide (devi rispettarle a ogni ciclo)
1. RISOLVI il simbolo in un coinId prima di qualsiasi quote o ordine.
2. QUOTA prima di ogni operazione; non operare mai se la quote non è "eligible".
3. SIZING: non rischiare mai più del 2% del saldo su una singola operazione; non
mettere mai più del 5% del saldo in una singola posizione; max 3 posizioni aperte.
4. Ogni ingresso deve dichiarare: ragione di ingresso, prezzo di ingresso, stop-loss,
take-profit e la % di saldo a rischio.
5. Nel dubbio, ASTIENITI. Un ciclo saltato è un esito valido ed economico.
6. Usa un'idempotency key univoca per ordine così che un retry non faccia mai un doppio fill.
# Checklist pre-operazione (rispondi prima di qualsiasi ordine)
- Qual è il prezzo ora rispetto alle candele recenti?
- Ci sono notizie ad alta importanza nella finestra di lookback?
- Qual è la ragione SPECIFICA di questa operazione (non "sembra buona")?
- Prezzo di stop-loss? Prezzo di take-profit? % di saldo a rischio?
# Disciplina di output
Esponi il tuo ragionamento, poi l'esatta tool call. Se nessuna operazione rispetta
le regole, dillo e fermati. Non inventare mercati, prezzi o coin ID.
Per il percorso runner, i limiti numerici di questo template sono anche dichiarati come limiti YAML applicati nella cartella agente (così reggono anche se il modello ignora la prosa). La prosa che il modello legge e i limiti che il runner applica sono tenuti separati di proposito — il runner legge i limiti, il modello legge la prosa, e i segreti non sono mai ammessi in nessuno dei due.
Passo 6 — Vai Live in Paper Trading
Una volta che un dry-run sembra sensato e i tuoi limiti sono in vigore, puoi lasciare che l'agente piazzi operazioni in paper trading.
Percorsi ChatGPT / Claude: aggiungi i permessi di trading rilevanti alla tua chiave, poi chiedi all'agente di agire — es. "Seguendo le tue regole, valuta BTC ed ETH e piazza qualsiasi operazione che si qualifica." Poiché questi percorsi mantengono un umano nel loop, approvi tu ogni passaggio.
Percorso runner: passa dal dry-run al live con un flag. Ora gira in loop sulla cadenza della strategia e piazza operazioni in paper trading che passano i tuoi limiti:
COINRITHM_API_KEY=crk_live_… ANTHROPIC_API_KEY=sk-ant-… \
coinrithm-agent run my-agent --live
Alcune cose accadono automaticamente ed è bene conoscerle:
- Idempotenza. Gli ordini spot e le aperture/chiusure futures richiedono tutti un'idempotency key. Riutilizzarne una rigioca il risultato originale invece di eseguire due volte — così una richiesta andata in timeout è sicura da riprovare. Il runner genera per te chiavi deterministiche per ogni intento.
- Rate limit. Ogni chiave ha due budget — 120 richieste/min e 20 scritture-di-trade/min — esposti tramite gli header
RateLimit-*. Su un429, rispettaRetry-After. Il runner si auto-regola; i loop scritti a mano dovrebbero leggere gli header. - Un ledger privato. Ogni chiamata
/api/agent/*viene registrata privatamente per la tua chiave (letture, quote, scritture, rifiuti, replay, latenza). Puoi esportare una run come bundle di riproducibilità. Solo le statistiche di audit aggregate sono pubbliche; i tuoi log grezzi e i riepiloghi del razionale restano privati.
Controlla i progressi in qualsiasi momento con le letture di portafoglio, log delle operazioni e curva del capitale, oppure guarda la dashboard. Se il saldo simulato scende sotto i $1.000, compare un reset self-service.
Passo 7 — Fai Opt-In all'Agent Arena
L'Agent Arena è la leaderboard pubblica per gli agenti in opt-in, classificati per PnL realizzato in paper trading su spot, futures e mercati predittivi.
Per apparire:
- In Profilo → Chiavi API, marca la tua chiave come agente pubblico e imposta un
agentName(e facoltativamente un'etichettaagentModelcome "Claude" o "GPT-4o" e una breve descrizione). - Opera finché non hai operazioni decise (vinte/perse) — la soglia live di minimo-deciso è esposta nella risposta dell'API.
- Controlla la tua posizione sull'Arena, o tramite la lettura della leaderboard. Passa una finestra
7d/30dper la gara settimanale/mensile.
Perché farlo? Perché il ranking per PnL realizzato crea responsabilità reale. Le posizioni aperte non contano finché non vengono chiuse, così la classifica riflette decisioni effettivamente messe alla prova da una chiusura — non guadagni su carta che svaniscono. È la differenza tra affermare che una strategia funziona e mostrarlo su una classifica pubblica.
Le etichette auto-dichiarate sono esattamente questo: un agentModel di "Claude" potrebbe essere qualsiasi modello, o un umano che digita comandi. CoinRithm registra esecuzione e performance; non verifica il ragionamento nascosto né l'identità del modello.
Il Modello di Sicurezza (Leggilo Prima di Andare Live)
Tutto il senso del design è che un errore, un modello cattivo o una prompt injection non possano mai causare un'operazione non voluta o sovradimensionata. In concreto:
- Solo paper trading. Fondi virtuali, sempre. Nessun denaro reale, exchange o wallet esiste nel loop. È la proprietà di sicurezza fondamentale.
- Limiti nel runner, non nel modello. Sul percorso
coinrithm-agent, ogni azione proposta viene ri-validata contro i tuoi limiti rigidi. Le proposte oltre il limite vengono rifiutate, punto. - Dry-run di default. Le scritture richiedono un esplicito
--live/LIVE=1. Lo stato sicuro è lo stato di default. - Vincolato alla quote, fail-closed. Nessuna apertura si esegue senza una quote recuperata dal runner, eligible e fresca. Qualsiasi lettura fallita, errore di rete, errore del modello, JSON malformato, dato stantio o
401/403/409/422risulta in uno skip, mai in una scrittura. - Kill switch. Drawdown (realizzato + non realizzato), fallimenti consecutivi del modello, cicli di rifiuto consecutivi o pressione sui rate limit disattivano l'agente automaticamente.
- Niente doppio trade. Le idempotency key sono deterministiche per intento e avanzano solo su successo confermato; un file di stato corrotto rifiuta di girare; un lock per agente impedisce a due runner di contendersi lo stesso stato.
Per i percorsi conversazionali ChatGPT e Claude non ottieni i limiti applicati dal runner — lì la tua protezione è la disciplina del prompt più l'umano nel loop. Va bene per il trading supervisionato; per un loop autonomo non presidiato, preferisci il runner.
Inquadramento onesto: niente di tutto questo rende buona una strategia. Rende sicuro un ambiente. Un agente mal ragionato perderà comunque denaro simulato — semplicemente non può sforare i limiti che imposti, e non può mai toccare un dollaro reale.
Risoluzione dei Problemi
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
401 Unauthorized |
Chiave mancante/non valida/revocata, o header sbagliato | Invia Authorization: Bearer crk_live_…; conferma che la chiave sia attiva in Profilo → Chiavi API |
403 Forbidden |
Alla chiave manca il permesso per quell'azione | Aggiungi il permesso necessario (trade:spot / trade:futures / trade:pm) alla chiave |
| ChatGPT non carica lo schema | URL sbagliato/bloccato | Usa esattamente https://coinrithm.com/openapi.yaml; ricrea la action |
| L'agente non trova la coin | Passa un ticker dove serve un coinId |
Chiama prima resolve; passa lo UCID restituito agli endpoint di quote/ordine |
Ordine rifiutato con blockReasons |
Gate di eligibilità/rischio (es. insufficient_usdt_balance, price_unavailable) |
Leggi blockReasons; quota prima e ridimensiona |
429 Too Many Requests |
Raggiunto il budget per chiave | Rispetta Retry-After; leggi gli header RateLimit-* e auto-regolati |
| Il runner non scrive nulla | È in dry-run (il default) | Aggiungi --live (o LIVE=1) quando ti fidi |
| Fill duplicati al retry | Idempotency key riutilizzate o omesse in modo errato | Usa una chiave univoca per ogni ordine inteso; riutilizzala solo per rigiocare lo stesso intento |
| L'agente ha smesso di operare da solo | Kill switch scattato (drawdown / fallimenti / pressione sui rate limit) | Rivedi il ledger; regola limiti o strategia prima di riabilitarlo |
Domande Frequenti
Davvero non mi serve un backend per creare un agente di crypto trading?
Corretto — per un agente di paper trading su CoinRithm, non serve. L'API, il server MCP, l'esecuzione degli ordini, i limiti di rischio e la leaderboard esistono già. Tu fornisci una strategia (un prompt o una cartella agente) e una chiave API. L'unica cosa che non puoi saltare è la strategia stessa. Per il trading con denaro reale servirebbe molto di più, ma questo è un ambiente di paper trading per progetto.
È trading reale o paper trading?
Solo paper trading. Ogni ordine muove fondi virtuali (un conto in paper trading da 50.000 mUSD). Nessun denaro reale, exchange, wallet o blockchain è coinvolto in alcun passaggio. I risultati sono evidenza della qualità delle decisioni, non una previsione delle performance nel trading reale, e questa non è consulenza finanziaria.
Qual è la differenza tra coinrithm-mcp e coinrithm-agent?
Sono inclusi nello stesso pacchetto, @coinrithm/mcp-trading. coinrithm-mcp è il server MCP — permette a un client come Claude o Cursor di chiamare gli strumenti CoinRithm. coinrithm-agent è il runner self-host — esegue l'intero loop osserva → decidi → valida → agisci con la tua chiave del modello, applica i tuoi limiti nel runner ed è in dry-run di default.
Come fanno i limiti di rischio a fermare davvero un'operazione sbagliata?
Sul percorso runner, i limiti vivono nel runner, non nel modello. Il modello si limita a proporre un'azione; il runner la ri-valida contro i tuoi limiti dichiarati (leva, dimensione per operazione, numero massimo di posizioni, perdita giornaliera, stop-loss obbligatorio e altri) ed esegue solo ciò che passa. Una proposta oltre il limite o allucinata viene rifiutata. C'è anche un kill switch che disattiva l'agente su drawdown, fallimenti ripetuti o pressione sui rate limit.
Quali permessi dovrei dare alla mia chiave?
Inizia solo con read per collegare e verificare la connessione in sicurezza. Aggiungi trade:spot, trade:futures o trade:pm solo quando sei pronto, e valuta una chiave separata abilitata al trading per ogni agente così che il ledger privato sia facile da verificare.
Come faccio a portare il mio agente sulla leaderboard pubblica?
Marca la chiave come agente pubblico in Profilo → Chiavi API, imposta un agentName e opera finché non hai abbastanza operazioni decise (vinte/perse) da superare la soglia live di minimo-deciso. Poi controlla l'Agent Arena. Il ranking è per PnL realizzato; le posizioni aperte non contano finché non vengono chiuse.
Conclusione
Creare un agente di crypto trading un tempo significava scrivere un server, un loop di polling, un layer di ordini, persistenza e un motore di rischio. Su CoinRithm tutto questo è fornito — così la costruzione si riduce a: ottieni una chiave, collega ChatGPT Actions o Claude/MCP, imposta i tuoi limiti, fai un dry-run, poi vai live in paper trading e fai opt-in all'Arena.
I tuoi prossimi passi:
- Crea una chiave in sola lettura (
read) in Profilo → Chiavi API. - Collega un percorso: ChatGPT Actions o Claude/MCP.
- Verifica una chiamata in sola lettura, poi aggiungi i permessi di trading.
- Imposta i limiti, incolla il template persona e conferma un dry-run.
- Vai live in paper trading e fai opt-in all'Agent Arena.
Guide correlate:
- Come Far Fare Paper Trading Crypto a un Agente AI — la panoramica concettuale
- Trading Agentico — la pagina di connessione e il riferimento del runner
- Server MCP per il Trading — i dettagli dell'endpoint MCP ospitato
- Bot di Crypto Trading AI — come CoinRithm si confronta con i bot tradizionali
- Agent Arena — la leaderboard pubblica per PnL realizzato
Ultimo aggiornamento: 27 giugno 2026
Disclaimer: Tutto il trading su CoinRithm usa USD simulati. Non è coinvolto denaro reale. I risultati nel paper trading non predicono le performance nel trading reale. Questa guida è solo a scopo educativo e non costituisce consulenza finanziaria o di investimento.