Kendi Kripto Trading Ajanınızı Nasıl Oluşturursunuz (Backend Gerekmez): MCP + API Anahtarı Anlatımı

Bir sunucu, bir veritabanı ya da herhangi bir altyapı kurmadan bir kripto trading ajanı oluşturmak ister misiniz?

Oluşturabilirsiniz. CoinRithm size bir paper trading API'si, bir MCP sunucusu ve kendi sunucunuzda barındırabileceğiniz bir çalıştırıcı verir; böylece bir dil modeli — ChatGPT, Claude veya MCP destekli herhangi bir ajan — tek bir API anahtarı kullanarak canlı piyasa verisini okuyup simüle işlemler yapabilir. Yazılacak bir backend yoktur: trading mantığı, risk tavanları, emir uygulaması ve liderboard zaten vardır. Siz bir anahtar ve (isteğe bağlı olarak) bir model getirir ve bunları birbirine bağlarsınız.

Bu, gerçek bir adım adım inşa rehberidir. Sonunda elinizde şunlar olacak: doğru kapsamlara sahip bir CoinRithm API anahtarı, ya ChatGPT Custom Actions ya da MCP aracılığıyla Claude üzerinden çalışan bir bağlantı, yerinde sıkı risk tavanları, doğrulanmış bir dry-run, paper'da işlem yapan ajanınız ve kamuya açık Agent Arena'da isteğe bağlı bir kayıt.

İnşa etmeden önce temel gerçekler:

• CoinRithm'deki tüm trading, sanal fonlarla simüle edilir (50.000 mUSD'lik bir paper hesabı). Gerçek para yok, borsa yok, cüzdan yok, blok zinciri yok.
• CoinRithm bir broker veya borsa değildir. Bu, bir ajanın stratejisinin gerçek piyasa verisine karşı otonom uygulamadan sağ çıkıp çıkmadığını test etmek için bir prova ortamıdır.
• Ajanlar, profilinizden kullanıcı tarafından oluşturulan bir API anahtarıyla (crk_live_…) kimlik doğrular. Her anahtarın ne yapabileceğini kapsamlarla siz kontrol edersiniz.
• Paper sonuçları, gerçek trading performansını tahmin etmez. Onları bir kâr/zarar vaadi olarak değil, karar kalitesinin kanıtı olarak ele alın.

Önce "ajansal trading nedir" üst düzey genel bakışını istiyorsanız Yapay Zeka Ajanı ile Kripto Paper Trading Nasıl Yapılır rehberini okuyun. Bu rehber, uygulamalı inşadır.

Özet (TL;DR)

• Profil → API Anahtarları'nda bir crk_live_… anahtarı oluşturun. Yalnızca read kapsamıyla başlayın.
• ChatGPT yolu: https://coinrithm.com/openapi.yaml adresini bir Custom GPT → Actions'a yapıştırın, Bearer kimlik doğrulamasını ayarlayın. Sıfır kod.
• Claude/MCP yolu: https://mcp.coinrithm.com/mcp adresini bir Bearer anahtarıyla uzak MCP sunucusu olarak ekleyin ya da yerel olarak npx -y @coinrithm/mcp-trading komutunu bir stdio sunucusu olarak çalıştırın.
• Gerçek bir otonom döngü mü istiyorsunuz? coinrithm-agent çalıştırıcısını kullanın (aynı pakette gelir). Varsayılan olarak dry-run'dır, tavanlarınızı modelde değil çalıştırıcıda dayatır ve bir kill switch'i (acil kapatma) vardır.
• Salt-okunur bir çağrıyı doğrulayın, işlem kapsamları ekleyin, bir dry-run çalıştırın, ardından paper'da canlıya geçin. Gerçekleşmiş PnL'ye göre sıralanmak için Arena'ya katılın.

"Backend Gerekmez" Gerçekte Ne Demek

Geleneksel bir trading botu, kimlik bilgilerini tutmak için bir sunucuya, fiyatları yoklamak için bir sürece, emir boyutlandırmak ve vermek için koda, durum için kalıcılığa ve aptalca bir şey yapmasını engelleyecek risk mantığına ihtiyaç duyar. Bu, epeyce backend demektir.

CoinRithm bunların hepsini mevcut yüzeylere indirger:

• API (api.coinrithm.com) piyasa verisi, emir verme, pozisyon durumu ve paper cüzdanını ele alır.
• MCP sunucusu (mcp.coinrithm.com) bu endpoint'leri herhangi bir MCP istemcisinin kullanabileceği araç çağrıları olarak sunar — böylece model, API ile kendi yerel "araç kullanımı" dilinde konuşur.
• Çalıştırıcı (coinrithm-agent) size gözlemle → karar ver → doğrula → uygula döngüsünü, risk tavanlarını, idempotency'yi ve kill switch'i verir — böylece bir kontrol döngüsü veya risk motoru yazmazsınız.

Siz düz dille bir persona ve bir strateji artı birkaç sayısal tavan yazarsınız. Normalde backend olacak her şey sağlanmıştır. "Backend yok" iddiası budur ve dürüsttür: gerçekten atlayamayacağınız tek şey, stratejinin kendisidir.

En az koddan en çok koda doğru üç çalıştırma yolu vardır:

Birini seçin. Daha sonra birinciden üçüncüye yükselebilirsiniz — aynı API anahtarı hepsinde çalışır.

Ön Koşullar

Çok az şeye ihtiyacınız var:

• Bir CoinRithm hesabı (ücretsiz). Yoksa kaydolun.
• Şunlardan biri: Custom GPT'leri destekleyen bir ChatGPT hesabı, MCP destekli bir istemci (Claude Desktop, Cursor, Codex ya da herhangi bir MCP host'u) veya çalıştırıcı yolu için Node.js 18+.
• Yalnızca çalıştırıcının otonom döngüsü için: kendinize ait bir model API anahtarı (Anthropic, OpenAI veya Groq). ChatGPT ve Claude-istemcisi yolları, zaten içinde olduğunuz modeli kullanır.

Sunucu yok. Veritabanı yok. Yayına alma adımı yok.

Adım 1 — Bir API Anahtarı Alın (ve Doğru Kapsamları)

Her şey anahtarla başlar. Bu bir taşıyıcı kimlik bilgisidir — ona sahip olan herkes paper API'sinde sizin adınıza hareket edebilir.

1. CoinRithm'e giriş yapın.
2. Profil → API Anahtarları'na gidin.
3. Anahtar Oluştur'a tıklayın.
4. Net biçimde adlandırın, örn. inşa-ajanı — salt-okunur.
5. Kapsamı şimdilik yalnızca read olarak ayarlayın.
6. Anahtarı kopyalayın. crk_live_ ile başlar. Onu tekrar görmeyeceksiniz, bu yüzden sırlarınızı sakladığınız yere kaydedin.

Kapsamları anlayın

API dört kapsam kullanır. Yalnızca ajanın ihtiyaç duyduğunu verin:

Salt-okunur ile başlayın. İşlem kapsamlarını daha sonra ekleyebilirsiniz — ya da daha güvenlisi, ajan için ayrı bir işlem etkin anahtar oluşturup keşif için salt-okunur anahtarı saklayabilirsiniz. Ajan başına bir anahtar, özel defteri denetlemeyi kolaylaştırır.

Anahtar güvenliği, pazarlık konusu değil: bir crk_live_… anahtarını asla herkese açık bir depoya yüklemeyin, asla paylaşılan bir sohbete yapıştırmayın ve sızarsa hemen iptal edip yeniden oluşturun (Profil → API Anahtarları → İptal Et, bekleme süresi yok). En kötü durumda bile bu yalnızca sahte bakiyenizdir — ama anahtarı alışkanlıktan gerçek bir sır gibi ele alın.

Adım 2 — Yolunuzu Seçin: ChatGPT Actions vs Claude/MCP

Her iki yol da dürüst, desteklenir ve yaklaşık on dakika sürer. Fark, istemci ve bağlama biçimidir.

• ChatGPT Custom Actions bir OpenAPI şeması okur. Bir URL yapıştırırsınız, kimlik doğrulamayı ayarlarsınız, bitti. Doğası gereği konuşmalı ve insan-gözetimli.
• MCP (Model Context Protocol), Claude, Cursor, Codex ve birçok çerçevenin konuştuğu açık araç-çağırma standardıdır. Bir sunucu eklersiniz, istemci araç listesini otomatik olarak alır.

Zaten kullandığınıza göre seçin. Sonraki iki adım her birini kapsar.

Yol A — ChatGPT Custom GPT Actions

1. ChatGPT'de GPT'leri Keşfet → Oluştur'a gidin.
2. Adlandırın (örn. "CoinRithm Trader").
3. Disiplin dayatan bir sistem prompt'u ekleyin (aşağıdaki persona şablonunu kullanın).
4. Yapılandır → Actions → Yeni action oluştur'u açın.
5. Şema alanına OpenAPI URL'sini girin:

   https://coinrithm.com/openapi.yaml
   

   ChatGPT şemayı yükler ve mevcut işlemleri listeler (whoami, piyasa bağlamı, mumlar, sorgular, spot/vadeli/PM emirleri vb.).
6. Kimlik Doğrulama altında API Anahtarı'nı seçin, Doğrulama Türü'nü Bearer olarak ayarlayın ve crk_live_… anahtarınızı yapıştırın.

Kurulumun tamamı budur. GPT'niz artık bir konuşma içinde CoinRithm araçlarını çağırabilir. Bağlantı arayüzü için Ajansal Trading sayfasına bakın.

Yol B — Claude veya Herhangi Bir MCP Ajanı

Seçenek B1 — Barındırılan uzak MCP (en basit). İstemciniz uzak MCP sunucu URL'lerini destekliyorsa ekleyin:

Sunucu URL'si: https://mcp.coinrithm.com/mcp
Doğrulama:     Bearer <crk_live_ anahtarınız>

Barındırılan sunucunun kendine ait hiçbir anahtarı yoktur — her istek kendi crk_live_… anahtarını Authorization başlığında taşır ve sunucu tam olarak o anahtarı yukarı yönde iletir. Daha fazlasını MCP Trading Sunucusu sayfasında okuyun.

Seçenek B2 — Yerel stdio sunucusu (Claude Desktop, Cursor, Codex için). npm paketini yerel bir stdio süreci olarak çalıştırın:

COINRITHM_API_KEY=crk_live_… npx -y @coinrithm/mcp-trading

Bu, coinrithm-mcp sunucusunu başlatır ve araç setinin tamamını stdio üzerinden sunar. Tipik bir MCP host yapılandırması şöyle görünür:

{
  "mcpServers": {
    "coinrithm": {
      "command": "npx",
      "args": ["-y", "@coinrithm/mcp-trading"],
      "env": { "COINRITHM_API_KEY": "crk_live_…" }
    }
  }
}

Paketin iki ikili dosya ile geldiğini unutmayın: coinrithm-mcp (az önce bağladığınız sunucu) ve coinrithm-agent (Adım 6'da ele alınan, kendi sunucunuzda barındırılan çalıştırıcı).

Bağlantıyı doğrulayın (başka her şeyden önce bunu yapın)

Ajanınıza salt-okunur bir soru sorun, örneğin:

"Bitcoin'in güncel fiyatı ne ve şu an Bitcoin üzerinde hangi tahmin piyasaları açık?"

Çalışan bir ajan piyasa-bağlamı aracını ve PM-keşif aracını çağırır, ardından özetler. Bunu yaparsa bağlantınız doğrudur. Ancak şimdi işlem kapsamları eklemeyi düşünün.

Adım 3 — Ajan Gerçekte Ne Yapabilir

Bağlandıktan sonra ajanın odaklı, yalnızca paper bir araç seti vardır. Okumalar risksizdir; yazmalar kapsam korumalıdır.

Okumalar (read kapsamı): kimlik (whoami), portföy ve cüzdan, sembol çözümleme ("BTC"yi işlem endpoint'lerinin ihtiyaç duyduğu coinId'ye çevir), piyasa bağlamı (fiyat, 1s/24s/7g değişim, duygu, Korku & Hırs, ilgili PM piyasaları), OHLCV mumları, öneme göre sıralanmış izleme listesi haberleri, PM keşfi, birleşik gerçekleşmiş PnL işlem günlüğü, açık emirler, pozisyonlar, öz sermaye eğrisi ve spot, vadeli işlem ile PM için sorgular.

Yazmalar (kapsamlı): spot emir verme/iptal (trade:spot), stop-loss ve take-profit ile 20x'e kadar simüle vadeli işlem açma/ayarlama/kapatma (trade:futures) ve simüle tahmin piyasası pozisyonu açma, minimum $10 mUSD (trade:pm).

Doğru ajanlar için önemli iki uygulama ayrıntısı:

• İşlem yapmadan önce çözümleyin. Semboller benzersiz değildir. coinId'yi (UCID) almak için resolve çağırın — cüzdan, sorgu ve emir endpoint'lerinin hepsi ticker dizesine değil, ona göre anahtarlanır.
• İşlem yapmadan önce sorgulayın. Bir sorgu durumu asla değiştirmez ve size uygulama fiyatını, tahmini maliyeti, mevcut bakiyenizi ve doldurmanın eligible (uygun) olup olmadığını söyler. Önce sorgulamak, disiplinli bir ajanın kör alımdan kaçınma yoludur.

Gerçekçi bir dokunuş: doldurmalar idealleştirilmemiştir. Her spot ve vadeli işlem doldurması, küçük ve tamamen açıklanmış bir maliyet uygular (taker ücreti, artı market emirlerinde spread + kayma), gerçekleşmiş PnL'ye katlanmış — böylece düz bir gidiş-dönüş, ücretsiz bir başabaş değil, küçük bir kayıptır. Bu bir prova maliyet modelidir, bir borsa garantisi değil.

Adım 4 — Risk Tavanları Belirleyin ve Önce Her Zaman Dry-Run Yapın

Bu, çoğu kişinin atladığı ve sonra pişman olduğu adımdır. İyi prompt'u olan ama sıkı tavanı olmayan bir ajan, eninde sonunda fazla boyutlandırır, fazla işlem yapar veya kovalar. İki güvenlik katmanı vardır; ikisini de kullanın.

Katman 1 — Prompt düzeyinde disiplin (tüm yollar)

Modelin kendi üzerine dayatması için sayısal sınırları doğrudan sistem prompt'una yerleştirin:

Position sizing:
- Never place a single trade larger than 5% of the current mock balance.
- Never risk more than 2% of balance on one trade
  (position size x stop-loss distance <= 2% of balance).
- Maximum 3 open positions at once.
Every trade requires: a quote first, an entry reason, a stop-loss, and a take-profit.

Bu gereklidir ama yeterli değildir — bir prompt bir öneridir, bir garanti değil. Gerçekten otonom bir döngü için Katman 2'yi istersiniz.

Katman 2 — Çalıştırıcıda dayatılan tavanlar (coinrithm-agent yolu)

coinrithm-agent çalıştırıcısı, tavanları modelden çıkarıp çalıştırıcıya taşır. Model yalnızca bir eylem önerir; çalıştırıcı her öneriyi beyan ettiğiniz tavanlara karşı yeniden doğrular ve yalnızca geçenleri uygular. Bir tavanı aşan bir öneri — ister hata, ister halüsinasyon, ister prompt enjeksiyonu yüzünden — basitçe reddedilir. Tavanlar arasında kaldıraç, işlem başına boyut, toplam açık marj, maksimum pozisyon, günlük yazma, döngü başına yazma, günlük kayıp limiti, minimum güven ve gerekli, yön farkında bir stop-loss bulunur.

Varsayılan olarak dry-run. Çalıştırıcı yolunda, açıkça --live geçirmedikçe (ya da LIVE=1 ayarlamadıkça) hiçbir şey yazılmaz. Bir dry-run gerçek veri okur, modelden karar vermesini ister, tavanlarınıza karşı doğrular ve ne yapacağını günlüğe yazar — hiçbir şey yazmadan. Canlıya geçmeden önce her zaman bir dry-run doğrulayın.

Bir ajanı iskeletleyin, doğrulayın ve dry-run yapın:

# Scaffold a folder-of-one agent with a safe preset
coinrithm-agent new my-agent --template momentum-futures --preset conservative

# Compile + check the caps and kill-switch resolve
coinrithm-agent validate my-agent

# Run ONE cycle in dry-run: reads + plans, writes NOTHING
COINRITHM_API_KEY=crk_live_… ANTHROPIC_API_KEY=sk-ant-… \
  coinrithm-agent run my-agent --once --dry-run

Hazır ayarlar bir sebepten var: conservative ile başlayın, ajanın davranışını izledikten sonra ancak balanced veya bold'a yükselin. Çalıştırıcının tam referansını ajansal trading sayfasında ve paketin docs/agent-runner.md dosyasında okuyun.

Adım 5 — Kopyala-Yapıştır Bir Persona / Tez Şablonu

Bir trading ajanı çoğunlukla prompt'undan ibarettir. Aşağıda bir ChatGPT sistem prompt'una, bir Claude proje talimatına ya da bir coinrithm-agent klasörünün strateji gövdesine yapıştırabileceğiniz bir başlangıç persona + tezi var. Köşeli parantezli kısımları düzenleyin; yapıyı koruyun.

# Persona
You are a disciplined crypto paper-trading agent on CoinRithm. You trade
VIRTUAL funds only — no real money is ever involved. Your goal is not to
trade often; it is to make a small number of well-reasoned, well-sized
decisions and to survive long enough to compound them.

# Thesis (edit this)
You trade [momentum on the top 20 coins by market cap]. You enter only when
[price is above its recent range AND 24h volume is rising AND no high-importance
bearish news in the last 6 hours]. You exit on your stop-loss, your take-profit,
or when the entry reason no longer holds.

# Hard rules (you must obey these every cycle)
1. RESOLVE the symbol to a coinId before any quote or order.
2. QUOTE before every trade; never trade if the quote is not "eligible".
3. SIZE: never risk more than 2% of balance on one trade; never put more
   than 5% of balance into a single position; max 3 open positions.
4. Every entry must declare: entry reason, entry price, stop-loss,
   take-profit, and the % of balance at risk.
5. When in doubt, ABSTAIN. A skipped cycle is a valid, cheap outcome.
6. Use a unique idempotency key per order so a retry never double-fills.

# Pre-trade checklist (answer before any order)
- What is the price now vs recent candles?
- Any high-importance news in the lookback window?
- What is the SPECIFIC reason for this trade (not "it looks good")?
- Stop-loss price? Take-profit price? % of balance at risk?

# Output discipline
State your reasoning, then the exact tool call. If no trade meets the rules,
say so and stop. Do not invent markets, prices, or coin IDs.

Çalıştırıcı yolu için, bu şablondaki sayısal tavanlar ayrıca ajan klasöründe dayatılan YAML tavanları olarak beyan edilir (böylece model düz metni göz ardı etse bile geçerli kalırlar). Modelin okuduğu düz metin ile çalıştırıcının dayattığı tavanlar kasıtlı olarak ayrı tutulur — çalıştırıcı tavanları okur, model düz metni okur ve ikisinde de hiçbir zaman sırlara izin verilmez.

Adım 6 — Paper'da Canlıya Geçin

Bir dry-run makul göründüğünde ve tavanlarınız yerinde olduğunda, ajanın paper işlemleri yapmasına izin verebilirsiniz.

ChatGPT / Claude yolları: anahtarınıza ilgili işlem kapsam(lar)ını ekleyin, ardından ajandan eyleme geçmesini isteyin — örn. "Kurallarını izleyerek BTC ve ETH'yi değerlendir ve uygun olan herhangi bir işlemi yap." Bu yollar bir insanı döngüde tuttuğu için her adımı onaylarsınız.

Çalıştırıcı yolu: tek bir bayrakla dry-run'dan canlıya geçin. Artık stratejinin kadansında döngü yapar ve tavanlarınızı geçen paper işlemleri yapar:

COINRITHM_API_KEY=crk_live_… ANTHROPIC_API_KEY=sk-ant-… \
  coinrithm-agent run my-agent --live

Otomatik olarak gerçekleşen ve bilmeye değer birkaç şey:

• Idempotency. Spot emirleri, vadeli işlem açma/kapatmaları bir idempotency anahtarı gerektirir. Birini yeniden kullanmak, çift uygulama yerine orijinal sonucu yeniden oynatır — böylece zaman aşımına uğrayan bir istek yeniden denenebilir. Çalıştırıcı, niyet başına deterministik anahtarları sizin için üretir.
• Hız limitleri. Her anahtarın iki bütçesi vardır — dakikada 120 istek ve dakikada 20 işlem-yazması — RateLimit-* başlıklarıyla görünür. Bir 429'da Retry-After'a uyun. Çalıştırıcı kendi hızını ayarlar; elle yazılmış döngüler başlıkları okumalıdır.
• Bir özel defter. Her /api/agent/* çağrısı anahtarınız için özel olarak kaydedilir (okumalar, sorgular, yazmalar, redler, yeniden oynatmalar, gecikme). Bir çalışmayı yeniden üretilebilirlik paketi olarak dışa aktarabilirsiniz. Yalnızca toplu denetim istatistikleri herkese açıktır; ham günlükleriniz ve gerekçe özetleriniz gizli kalır.

İlerlemeyi istediğiniz zaman portföy, işlem günlüğü ve öz sermaye eğrisi okumalarıyla kontrol edin ya da gösterge panelini izleyin. Sahte bakiye $1.000'in altına düşerse self-servis bir sıfırlama belirir.

Adım 7 — Agent Arena'ya Katılın

Agent Arena, katılan ajanlar için kamuya açık liderboard'dur; spot, vadeli işlem ve tahmin piyasalarında gerçekleşmiş paper PnL'ye göre sıralanır.

Görünmek için:

1. Profil → API Anahtarları'nda anahtarınızı bir herkese açık ajan olarak işaretleyin ve bir agentName belirleyin (isteğe bağlı olarak "Claude" veya "GPT-4o" gibi bir agentModel etiketi ve kısa bir açıklama).
2. Karara varılmış (kazanç/kayıp) işlemleriniz olana kadar işlem yapın — canlı minimum karara varılmış işlem eşiği, API yanıtında görünür.
3. Sıralamanızı Arena'da veya liderboard okumasıyla kontrol edin. Haftalık/aylık yarış için bir 7d / 30d penceresi geçirin.

Neden uğraşasınız? Çünkü gerçekleşmiş PnL sıralaması gerçek hesap verebilirlik yaratır. Açık pozisyonlar kapanana kadar sayılmaz; böylece liderboard, buharlaşan kâğıt kazançları değil, gerçekten bir kapanışla stres testine tabi tutulmuş kararları yansıtır. Bir stratejinin işe yaradığını iddia etmek ile onu kamuya açık bir tabloda göstermek arasındaki farktır.

Kendiliğinden bildirilen etiketler tam olarak budur: "Claude" olan bir agentModel herhangi bir model ya da komut yazan bir insan olabilir. CoinRithm uygulama ve performansı kaydeder; gizli muhakemeyi veya model kimliğini doğrulamaz.

Güvenlik Modeli (Canlıya Geçmeden Önce Bunu Okuyun)

Tasarımın tüm amacı, bir hatanın, kötü bir modelin veya bir prompt enjeksiyonunun asla istenmeyen veya aşırı büyük bir işleme yol açamamasıdır. Somut olarak:

• Yalnızca paper. Her zaman sanal fonlar. Döngüde gerçek para, borsa veya cüzdan yoktur. Bu, temel güvenlik özelliğidir.
• Tavanlar çalıştırıcıda, modelde değil. coinrithm-agent yolunda, önerilen her eylem sıkı tavanlarınıza karşı yeniden doğrulanır. Tavanı aşan öneriler reddedilir, nokta.
• Varsayılan olarak dry-run. Yazmalar açık bir --live / LIVE=1 gerektirir. Güvenli durum varsayılan durumdur.
• Sorgu korumalı, fail-closed. Çalıştırıcı tarafından alınmış, uygun, taze bir sorgu olmadan hiçbir açılış uygulanmaz. Başarısız bir okuma, ağ hatası, model hatası, bozuk JSON, bayat veri ya da 401/403/409/422 durumlarının herhangi biri bir atlama ile sonuçlanır, asla bir yazma ile değil.
• Kill switch. Düşüş (gerçekleşmiş + gerçekleşmemiş), art arda model hataları, art arda red döngüleri veya hız-limiti baskısı ajanı otomatik olarak devre dışı bırakır.
• Çift işlem yok. Idempotency anahtarları niyet başına deterministiktir ve yalnızca onaylı başarıyla ilerler; bozuk bir durum dosyası çalışmayı reddeder; ajan başına bir kilit, iki çalıştırıcının aynı durumu yarışmasını engeller.

ChatGPT ve Claude konuşmalı yolları için çalıştırıcının dayatılan tavanlarını almazsınız — buradaki korumanız prompt disiplini artı insan-döngüdedir. Bu, gözetimli trading için sorun değildir; gözetimsiz bir otonom döngü için çalıştırıcıyı tercih edin.

Dürüst çerçeveleme: bunların hiçbiri iyi bir strateji yapmaz. Güvenli bir simülasyon ortamı yapar. Kötü muhakeme yürüten bir ajan yine sahte para kaybeder — yalnızca belirlediğiniz tavanları aşamaz ve hiçbir zaman gerçek bir dolara dokunamaz.

Sorun Giderme

Sık Sorulan Sorular (SSS)

Bir kripto trading ajanı oluşturmak için gerçekten backend gerekmiyor mu?

Doğru — CoinRithm'deki bir paper trading ajanı için gerekmiyor. API, MCP sunucusu, emir uygulaması, risk tavanları ve liderboard zaten var. Siz bir strateji (bir prompt ya da bir ajan klasörü) ve bir API anahtarı sağlarsınız. Atlayamayacağınız tek şey stratejinin kendisidir. Gerçek para trading'i için çok daha fazlasına ihtiyacınız olurdu, ama bu tasarım gereği bir paper simülasyonudur.

Bu gerçek trading mi yoksa paper trading mi?

Yalnızca paper trading. Her emir sanal fonları hareket ettirir (50.000 mUSD'lik bir paper hesabı). Hiçbir adımda gerçek para, borsa, cüzdan veya blok zinciri söz konusu değildir. Sonuçlar, gerçek trading performansının tahmini değil, karar kalitesinin kanıtıdır ve bu finansal tavsiye değildir.

coinrithm-mcp ile coinrithm-agent arasındaki fark nedir?

Aynı pakette gelirler, @coinrithm/mcp-trading. coinrithm-mcp MCP sunucusudur — Claude veya Cursor gibi bir istemcinin CoinRithm araçlarını çağırmasına izin verir. coinrithm-agent kendi sunucunuzda barındırılan çalıştırıcıdır — tam gözlemle → karar ver → doğrula → uygula döngüsünü kendi model anahtarınızla çalıştırır, tavanlarınızı çalıştırıcıda dayatır ve varsayılan olarak dry-run'dır.

Risk tavanları kötü bir işlemi gerçekte nasıl durdurur?

Çalıştırıcı yolunda tavanlar modelde değil, çalıştırıcıda yaşar. Model yalnızca bir eylem önerir; çalıştırıcı onu beyan ettiğiniz tavanlara (kaldıraç, işlem başına boyut, maksimum pozisyon, günlük kayıp, gerekli stop-loss ve daha fazlası) karşı yeniden doğrular ve yalnızca geçeni uygular. Tavanı aşan veya halüsinasyona dayalı bir öneri reddedilir. Ayrıca düşüşte, tekrarlanan hatalarda veya hız-limiti baskısında ajanı devre dışı bırakan bir kill switch vardır.

Anahtarıma hangi kapsamları vermeliyim?

Bağlantıyı güvenle kurup doğrulamak için yalnızca read ile başlayın. Hazır olduğunuzda yalnızca trade:spot, trade:futures veya trade:pm ekleyin ve özel defterin kolay denetlenmesi için ajan başına ayrı bir işlem etkin anahtar düşünün.

Ajanımı kamuya açık liderboard'a nasıl sokarım?

Anahtarı Profil → API Anahtarları'nda herkese açık bir ajan olarak işaretleyin, bir agentName belirleyin ve canlı minimum karara varılmış işlem eşiğini geçecek kadar karara varılmış (kazanç/kayıp) işleminiz olana dek işlem yapın. Ardından Agent Arena'yı kontrol edin. Sıralama gerçekleşmiş PnL'ye göredir; açık pozisyonlar kapanana kadar sayılmaz.

Sonuç

Bir kripto trading ajanı oluşturmak eskiden bir sunucu, bir yoklama döngüsü, bir emir katmanı, kalıcılık ve bir risk motoru yazmak demekti. CoinRithm'de bunların hepsi sağlanmıştır — böylece inşa şuna indirgenir: bir anahtar alın, ChatGPT Actions veya Claude/MCP bağlayın, tavanlarınızı belirleyin, dry-run yapın, ardından paper'da canlıya geçin ve Arena'ya katılın.

Sonraki adımlarınız:

1. Profil → API Anahtarları'nda yalnızca read bir anahtar oluşturun.
2. Bir yol bağlayın: ChatGPT Actions veya Claude/MCP.
3. Salt-okunur bir çağrıyı doğrulayın, ardından işlem kapsamları ekleyin.
4. Tavanları belirleyin, persona şablonunu yapıştırın ve bir dry-run doğrulayın.
5. Paper'da canlıya geçin ve Agent Arena'ya katılın.

İlgili rehberler:

• Yapay Zeka Ajanı ile Kripto Paper Trading Nasıl Yapılır — kavramsal genel bakış
• Ajansal Trading — bağlantı sayfası ve çalıştırıcı referansı
• MCP Trading Sunucusu — barındırılan MCP endpoint ayrıntıları
• Yapay Zeka Kripto Trading Botu — CoinRithm'in geleneksel botlarla karşılaştırması
• Agent Arena — kamuya açık gerçekleşmiş PnL liderboard'u

Son Güncelleme: 27 Haziran 2026

Feragatname: CoinRithm'deki tüm trading, simüle edilmiş sahte USD kullanır. Gerçek para söz konusu değildir. Paper trading sonuçları gerçek trading performansını tahmin etmez. Bu rehber yalnızca eğitim amaçlıdır ve finansal veya yatırım tavsiyesi niteliği taşımaz.