> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/ai-agents.md).

# Agen AI

Hubungkan Claude Desktop, Claude Code, Codex, Cursor, atau aplikasi MCP apa pun ke instalasi goodcryptoX-mu, dengan key yang membaca, mengusulkan, atau trading dalam batasmu.

goodcryptoX punya server MCP dan API bawaan: Claude Desktop, Claude Code, Codex, Cursor, atau aplikasi MCP apa pun bisa membaca posisimu, mengusulkan order, dan trading di exchange yang kamu hubungkan dalam batas yang kamu tetapkan, di instalasimu sendiri, tanpa akun di goodcryptoX. Program memakai [API](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/api.md). goodcryptoX-mu adalah instalasi pribadi di komputer, NAS, atau servermu, dan server MCP goodcryptoX serta API tersambung ke instalasi itu; kami tidak menjalankan API trading atau server MCP publik untuk kamu sambungi.

Relay kami adalah cara default menjangkau instalasimu dari perangkat lain. Relay tidak bisa membaca kunci akses, permintaan, atau balasanmu. Komputer bisa memakai [SSH tunnel](#use-an-ssh-tunnel-instead) sebagai gantinya, melewati relay; [ponsel](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/readme/phone-access.md) juga bisa terhubung lewat relay.

Akun demo dan tampilan Bybit untuk pengembang, termasuk contoh pengiriman dengan kunci hanya baca dan pemulihan, hanya untuk orang yang masuk ke panel. Kunci akses dan MCP tidak dapat menggunakan `demoBybitView` atau `demo=1`.

## Apa yang bisa dilakukan agen <a href="#what-an-agent-can-do" id="what-an-agent-can-do"></a>

Aksi-aksi ini tersedia lewat MCP maupun API. Key menetapkan apa yang diizinkan goodcryptoX; aturan agen AI sendiri mungkin mengizinkan lebih sedikit. Pembayaran dari wallet-mu, seperti membeli kredit, tetap kamu yang melakukannya: agen bisa memberitahumu caranya.

Dengan key apa pun, ia bisa:

* **Akun dan aset**: membaca akun, saldo, posisi, order terbuka, dan botmu, serta status akun dan goodcryptoX. Tool `portfolio` mengenali koin yang dikenal di berbagai akun dan aset exchange yang belum dicocokkan, lengkap dengan harga tiap aset dan harga yang belum ada ([API](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/api.md#portfolio-identities)).
* **Pengaturan jaminan**: membaca pengaturan jaminan setiap akun di snapshot `balances` (`perCoinCollateral`). Snapshot ini menyebut wallet, apakah exchange menerima setiap coin, dan apakah coin dipakai sebagai jaminan; nilai yang tidak ada bukan berarti Nonaktif. Hanya orang yang bisa mengubah pengaturan jaminan di goodcryptoX; API key dan alat MCP bisa membacanya. Akun demo dan pengaturannya hanya tersedia dalam sesi orang.
* **Volume trading**: membaca berapa banyak kamu bertransaksi sejak menghubungkan tiap akun, transaksi yang terisi, biaya, dan PnL terealisasi, menurut akun dan siapa yang memasang order, untuk seluruh periode atau per hari UTC. Jawabannya menunjukkan bagian mana yang belum memiliki riwayat atau harga ([API](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/api.md#trading-volume)).
* **Order dan riwayat**: membaca detail order dan order yang sudah selesai, dan menanyakan ke exchange tentang satu order sekarang, seperti Segarkan pada kartu order (tidak ada yang berubah di exchange).
* **Detail bot**: membaca rencana, order, hasil, dan pembayaran funding.
* **Pembayaran funding**: membaca jumlah yang dibayar atau diterima akun di suatu pasar, coin pembayaran, dan bagian setiap bot.
* **Pasar**: membaca pasar yang tersedia, aturan trading-nya, serta harga dan volume candle.
* **Mata uang dasar**: membaca mata uang yang kamu pilih untuk goodcryptoX dan kursnya terhadap dolar.
* **Kredit**: membaca kreditmu, sisa volume awal di CEX (`remaining`; tambahkan volume yang dibeli `balance` dengan tarif `rate` untuk mendapatkan total sisa volume di CEX pada panel), biaya, exchange mana saja yang membayar dengan kredit, apakah kredit hampir habis atau order dan bot baru dijeda, dan cara menambahnya. Di Solana, kredit juga bisa dibayar dengan $GOOD, yang dipegang atau dibeli dengan koin apa pun dalam pembayaran yang sama, dengan diskon $GOOD; program bisa meminta kutipan pembayaran dengan `POST /api/v1/credits/pay` (`input`, jumlah koin, atau `amount`, dengan `build: false`); pembayarannya sendiri tetap milikmu, dari wallet-mu. Alat `credits` yang sama mengembalikan `totals`: USD dibayar, kredit dari pembayaran, pemberian, volume CEX dan biaya sejak awal; rata-rata volume dan biaya harian serta bulanan 30 hari; rentang tanggal, apakah biaya diperkirakan, dan selisih saldo. Pembacaan per hari dengan `before` tetap tersedia.
* **Kode referral**: membaca kode yang kamu pakai saat bergabung dan biayamu, tiga kodemu sendiri, hasilnya, berapa teman yang bergabung dan berapa di antara mereka yang memasang order, serta pembayaranmu.
* **Key-nya sendiri**: membaca cakupan, akun, pasar, dan limitnya, serta berapa banyak dari 24 jam yang sudah terpakai.
* **API key exchange**: memeriksa ulang API key akun Binance setelah kamu mengubah izinnya di Binance dan membaca kemampuan terbarunya.
* **Pratinjau dan laporan**: mempratinjau order dan bot tanpa trading, dan menyelidiki apa yang terjadi.

Dengan key **Trading**, ia juga bisa:

* **Order**: menempatkan order dengan take-profit dan stop-loss, mengubah ordernya sendiri, dan membatalkan order non-bot di akun yang diizinkan.
* **Leverage**: mengatur leverage dan mode margin.
* **Menjaga API key tetap aktif**: melihat apakah Jaga API key saya tetap aktif aktif untuk akun Binance; hanya kamu yang bisa mengaktifkan atau menonaktifkannya.
* **Bayar biaya dengan BNB**: melihat apakah akun Binance membayar biayanya dengan BNB; hanya kamu yang bisa menyalakan atau mematikannya.
* **Margin terisolasi**: menambah atau mengurangi margin posisi terisolasi.
* **Bot**: membuat dan meluncurkan bot; mengubah, menghentikan, atau menutup bot yang dibuatnya.
* **Aksi massal**: membatalkan order non-bot, menghentikan botnya sendiri, atau menutup posisi yang cocok dengan filter, termasuk milikmu. Aset bot tetap ada kecuali ia juga menghentikan botnya sendiri dengan posisi ditutup.

Trading mengikuti [akun, pasar, dan limit](#keys-and-limits)-mu; pembatalan menjangkau order non-bot di akun yang diizinkan apa pun marketnya. Kamu menjeda dan melanjutkan botnya lewat **Tangguhkan** dan **Lanjutkan** milik key di goodcryptoX; agen tidak bisa melakukannya secara langsung.

Key **Usul** atau **Trading** bisa menyiapkan order dan bot untuk kamu tinjau dan luncurkan di goodcryptoX. [Usulan](#proposals) tidak trading sampai kamu meluncurkannya. Ia bisa menarik kembali usulannya sendiri selagi menunggu.

Tidak ada key yang bisa menarik atau mentransfer dana, mengubah pengaturanmu, atau membuat key lain. Key Trading hanya mengubah order dan bot miliknya sendiri, tetapi bisa membatalkan order non-bot mana pun di akun yang diizinkan. Ia tidak bisa membatalkan order bot secara langsung, bahkan setelah bot berhenti.

**Usulan order** dan **Usulan bot** sebuah key, serta saat ia **Mencapai batasnya**, sampai kepadamu di Telegram, dengan nama key. **Order diterima**, **Pembatalan diterima**, dan **Bot dibuat** juga datang kecuali kamu mematikan **Beri tahu saya di Telegram** di detail key; awalnya aktif. Yang kamu lakukan sendiri di panel tidak mengirim apa pun. Detail key di **Pengaturan › MCP & API** menyimpan aktivitasnya di bawah **Yang dilakukannya**: order yang dipasang dan dibatalkan, leverage yang diatur, serta margin yang ditambah atau dikurangi.

## Hubungkan aplikasi MCP atau program apa pun <a href="#connect-any-mcp-app-or-program" id="connect-any-mcp-app-or-program"></a>

Buka **Pengaturan › MCP & API**. Tekan **Buat kunci**, beri nama, dan pilih apa yang boleh dilakukannya:

* **Baca** membaca order, posisi, dan botmu. Tidak mengubah apa pun.
* **Usul** membaca dan mengusulkan order serta bot untuk kamu luncurkan di panel. Tidak ada yang trading tanpamu.
* **Trading** membaca, menempatkan, dan membatalkan order serta menjalankan botnya sendiri dalam [akun, pasar, dan limit](#keys-and-limits)-mu.

Tekan **Buat kunci** lagi, lalu **Salin** dan **Selesai**. Untuk melihat key lagi nanti, buka barisnya: **Kunci** tampil tersembunyi, dengan **Tampilkan** dan **Salin**. Beri setiap aplikasi atau program key-nya sendiri agar kamu bisa mencabut satu per satu.

Di bawah key, blok penghubung punya dua sisi, **Agen AI** dan **API**, dan di kanan atas ada key yang diisikan: key terakhir yang kamu buat sudah dipilih; pilih yang lain dari daftar. Setiap aplikasi punya satu baris yang menyebutkan tempat pengaturannya: salin dan tempel di sana. Key, alamat instalasi, dan cara menjangkaunya dari komputer lain sudah di dalamnya, jadi tidak ada yang perlu diisi. Kalau disalin lewat relay kami, baris yang sama bekerja pada komputer tempat goodcryptoX berjalan dan komputer lain ([Dari komputer lain](#from-another-computer)). Baris mengikuti sistem browser tempat kamu menyalinnya: salin pada komputer tempat aplikasi berjalan.

Claude Code, Codex, dan Cursor memulai konektor dengan Node.js 18 atau lebih baru di komputer tempat mereka berjalan; Claude Desktop membawa sendiri. Jika aplikasimu bilang tidak menemukan `npx`, pasang Node.js untuk sistemmu dari [nodejs.org](https://nodejs.org/) dan mulai aplikasi lagi. Awal pertama mengambil konektor, yang bisa memakan beberapa detik.

### Claude Desktop <a href="#claude-desktop" id="claude-desktop"></a>

Di Mac dan Windows.

1. Tekan **Unduh** di samping **Claude Desktop** dan buka filenya, bernama sesuai keymu (klik dua kali). Claude Desktop membuka jendela pemasangannya.
2. Tekan **Instal**. Claude Desktop menampilkan ini untuk setiap konektor di luar direktorinya. Konektor kami hanya berbicara dengan goodcryptoX, dengan key yang kamu berikan, dan tidak membaca apa pun di komputermu.
3. Claude Desktop meminta **goodcryptoX access key**-mu. Tekan **Salin** di samping **Unduh** di goodcryptoX, tempel key, dan tekan **Simpan**.
4. Aktifkan ekstensinya: Claude Desktop memasangnya dalam keadaan nonaktif sampai key-nya disimpan.
5. Setiap alat goodcryptoX dimulai sebagai **Ask**: Claude Desktop bertanya kepadamu sebelum memakainya. Di baris goodcryptoX tekan **Configure**, lalu ubah alat yang ingin kamu pakai tanpa bertanya dari **Ask** ke **Allow**; setidaknya alat baca (yang berjudul **Read …**), supaya ia bisa melihat tanpa bertanya setiap kali.
6. Tanyakan “Order apa saja yang sedang terbuka?”. Key-mu menetapkan paling banyak yang bisa dilakukan agen di goodcryptoX; izin Claude Desktop menentukan apa yang ditanyakannya kepadamu.

### Claude Code <a href="#claude-code" id="claude-code"></a>

Di terminal, IDE, dan tab Code.

1. Tekan **Salin** di samping **Claude Code**.
2. Buka terminal di komputer tempat kamu memakai Claude Code (Terminal di Mac dan Linux, PowerShell di Windows; terminal di dalam IDE-mu juga bisa), tempel barisnya, dan tekan Return. Claude Code menjawab `Added stdio MCP server gcx … to user config`. Sekali sudah cukup: terminal, IDE, dan tab Code-nya semua memakainya. Untuk menggantinya nanti (key lain, baris baru), jalankan dulu `claude mcp remove <name>` dengan nama yang mengikuti `--scope user` di baris itu: Claude Code menolak baris kedua dengan nama yang sama.
3. Jalankan `claude mcp list`: entri goodcryptoX tertulis `✓ Connected`. Dalam sesi Claude Code, `/mcp` mendaftarkannya beserta alatnya.
4. Tanyakan soal ordermu. Claude Code bertanya sebelum memakai alat untuk pertama kali: jawab **Ya**, atau **Yes, and don't ask again** untuk alat itu; `/permissions` menampilkan dan mengubah apa yang boleh dipakainya tanpa bertanya.

### Codex <a href="#codex" id="codex"></a>

1. Tekan **Salin** di samping **Codex**.
2. Cara mudah: tempel barisnya ke Codex dan minta ia menambahkannya ke konfigurasinya. Codex melakukannya dan menyuruhmu memulai ulang; mulai lagi.
3. Atau tambahkan sendiri: buka file konfigurasi Codex di editor teks apa pun, dan buat kalau belum ada: `~/.codex/config.toml` di Mac dan Linux, `%USERPROFILE%\.codex\config.toml` di Windows. Foldernya, `.codex`, tersembunyi: di dialog **Buka** editor, di Mac tekan Cmd+Shift+G dan ketik `~/.codex`; di Windows ketik path di atas di kolom nama file. Tempel barisnya di akhir, pertahankan yang sudah ada, dan simpan. Lalu mulai Codex lagi: `codex` baru di terminal, atau keluar dan buka ulang aplikasi Codex.
4. `codex mcp list` menampilkan goodcryptoX sebagai `enabled`; dalam sesi, `/mcp` mendaftarkan alatnya.
5. Tanyakan soal ordermu. Apakah Codex bertanya sebelum memakai alat bergantung pada pengaturan persetujuannya (`/approvals` dalam sesi).

### Cursor dan aplikasi lain <a href="#cursor-and-other-apps" id="cursor-and-other-apps"></a>

1. Tekan **Salin** di samping **Cursor dan aplikasi lain**.
2. Cara mudah: tempel barisnya ke chat Cursor dan minta ia menambahkannya ke pengaturan MCP-nya.
3. Atau tambahkan sendiri: di Cursor, buka **Cursor Settings** (Cmd+Shift+J di Mac, Ctrl+Shift+J di Windows dan Linux), lalu **Tools & MCPs**, dan tekan **Add Custom MCP**: Cursor membuka `mcp.json`-nya. Kalau file kosong, tempel barisnya; kalau sudah memuat server, tempel hanya entri goodcryptoX di dalam `"mcpServers"`-nya. Simpan.
4. Kembali di **Tools & MCPs**, goodcryptoX terdaftar beserta alatnya dan sakelar yang menyalakan atau mematikannya.
5. Tanyakan soal ordermu kepada agen. Cursor bertanya sebelum menjalankan alat kecuali kamu mengizinkannya menjalankan alat sendiri di pengaturannya.

Aplikasi lain yang menjalankan server MCP lewat standard input dan output memakai entri yang sama: perintahnya, argumennya, dan environment-nya. Konektor ini bukan alamat web untuk layanan chat yang di-host.

## Dari komputer lain <a href="#from-another-computer" id="from-another-computer"></a>

Baris yang disalin lewat relay kami bekerja dari komputer mana pun. Kalau goodcryptoX tidak berjalan pada komputer tempat aplikasimu berjalan, konektor menjangkau instalasi lewat relay kami yang tidak bisa membaca kunci akses, permintaan, atau balasan. Buka goodcryptoX dari komputer itu lewat relay kami, salin baris aplikasimu, lalu tempel seperti di atas.

Pertama kali aplikasi memulai konektor, ia memasangkan komputer itu dengan instalasimu, dengan kode sekali pakai yang dibawa barisnya. Kode itu berlaku sampai dipakai, paling lama sehari, baik halaman goodcryptoX tetap terbuka maupun tidak; memulai ulang goodcryptoX juga mengakhirinya. Sejak itu setiap aplikasi di komputer itu tersambung sendiri. Komputer itu muncul di **Pengaturan › Perangkat** sebagai **Program di …**, dengan **Hapus**.

Jika aplikasimu bilang **This connector has expired. Download it again from goodcryptoX**, belum tentu sudah lewat sehari: memulai ulang goodcryptoX atau memakai kode di komputer lain juga membuat baris lama tidak bisa dipakai. Salin baris baru dari **Pengaturan › MCP & API** dan ganti entri aplikasimu dengan mengikuti langkahnya di atas (di Claude Code, hapus yang lama dulu dengan `claude mcp remove`); untuk Claude Desktop, unduh lagi filenya. Kalau koneksi tersimpan tidak bisa dibuka, ikuti langkah di bawah.

Konektor memakai alamat instalasimu saat bisa memastikan bahwa goodcryptoX-mu menjawab di sana. Kalau tidak, konektor tersambung lewat relay kami. Di komputer lain, memakai relay itu normal.

Jika aplikasimu bilang **Can't open or save the connection on this computer**, periksa dulu bahwa kamu masuk sebagai pengguna komputer yang pertama kali menghubungkannya. Pesan ini juga bisa berarti file rusak, akses ditolak, atau Windows tidak bisa membuka atau menyimpannya. Hanya menyalin baris baru tidak memperbaiki file tersimpan.

Kalau file tersimpan perlu diganti, ikuti langkah ini. Langkah ini mengganti koneksi tersimpan milik pengguna komputer yang sedang kamu pakai; langkah ini tidak memperbaiki PowerShell yang diblokir atau izin folder.

1. Tutup aplikasi AI yang memakai goodcryptoX dan hentikan semua `gcx connect` yang berjalan.
2. Buka folder yang memuat file itu: di Windows, masukkan `%LOCALAPPDATA%\goodcryptoX` di bilah alamat File Explorer; di Mac, pakai **Go to Folder** di Finder dengan `~/Library/Application Support/goodcryptoX`; di Linux, buka `~/.local/share/goodcryptoX` di pengelola file.
3. Ganti nama `connect` ke nama yang belum dipakai, misalnya `connect-old`. Kalau tidak bisa mengganti namanya, perbaiki akses folder dulu.
4. Salin baris baru dari **Pengaturan › MCP & API**, ganti entri satu aplikasi dengan mengikuti langkahnya di atas, lalu mulai aplikasi itu. Untuk Claude Desktop, unduh lagi filenya.
5. Ulangi untuk setiap instalasi goodcryptoX yang kamu pakai. Aplikasi lain dari pengguna komputer dan instalasi yang sama lalu memakai ulang koneksi tersimpan itu.

Jika aplikasimu bilang **The connection took too long. Try again in a minute**, coba lagi dalam satu menit. Konektor yang berjalan mencoba lagi sendiri; kalau aplikasi AI menghentikan konektor, mulai ulang aplikasinya. Kalau terus terjadi, masalahnya perlu diperiksa lebih lanjut.

Jaga baris yang disalin tetap pribadi: ia memuat key-mu dan, selama sehari, kode yang memasangkan komputer. File Claude Desktop memuat kode tetapi bukan key: Claude Desktop memintanya. Kode saja tidak membaca dan tidak trading apa pun; key akses tetap dibutuhkan.

Konektor yang berjalan tersambung ulang setelah tidur atau gangguan jaringan; instalasimu terus trading selama berjalan dan tersambung ke exchange. Untuk tersambung tanpa relay kami, pakai [tunnel SSH](#use-an-ssh-tunnel-instead).

Dari [alamat rumah](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/readme/set-up-on-your-mac.md#your-home-network), baris yang kamu salin menghubungkan aplikasi AI atau program langsung ke instalasi yang membuatnya dengan key pilihanmu, tidak pernah lewat relay kami. Pakai pada jaringan yang kamu percaya, atau lewat alamat HTTPS tepercaya milikmu: lewat HTTP, orang yang bisa membaca trafik bisa menyalin key.

## Pakai tunnel SSH sebagai gantinya <a href="#use-an-ssh-tunnel-instead" id="use-an-ssh-tunnel-instead"></a>

Sebagai ganti relay kamu bisa memakai tunnel SSH; kalau kamu tidak tahu itu apa, kamu tidak membutuhkannya. Alternatif ini menyambungkan komputermu langsung ke komputer yang menjalankan goodcryptoX.

<details>

<summary>Sambungkan lewat SSH</summary>

1. Di komputermu, buka Terminal (PowerShell di Windows) dan teruskan port lokal ke port goodcryptoX di komputer lain. Misalnya, kalau goodcryptoX memakai port 8128:

   ```sh
   ssh -N -L 8128:127.0.0.1:8128 <user>@<server-address>
   ```

   Pakai user dan alamat SSH-mu, tambahkan `-i <private-key-file>` bila perlu. Pakai port goodcryptoX yang sebenarnya di kedua sisi baris dan di alamat di bawah. Biarkan perintah ini berjalan.
2. Buka `http://127.0.0.1:8128/gcx` lewat tunnel, memakai port goodcryptoX. Untuk login, jalankan `gcx open --print` di instalasi (`docker exec gcx gcx open --print` di Docker) dan buka tautannya dalam 60 detik. Lihat panduan [server](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/readme/set-up-on-a-server.md#sign-in) atau [NAS](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/readme/set-up-on-a-nas.md#sign-in) untuk rincian login.
3. Di **Pengaturan › MCP & API**, salin baris aplikasimu seperti di atas. Selama tunnel berjalan, konektor menemukan goodcryptoX di alamat lokal itu dan berbicara langsung dengannya.

Program memakai alamat lokal yang sama dan key-nya sendiri. Menutup perintah SSH mengakhiri akses dari komputer ini; bot dan order terus berjalan di instalasi.

</details>

## Perangkat dan penghapusan <a href="#devices-and-removal" id="devices-and-removal"></a>

**Pengaturan › Perangkat** mendaftarkan browser dan komputer yang dipasangkan. Setiap baris **Program di …** mencakup aplikasi dan program yang berbagi satu login komputer; kamu bisa mengganti namanya atau **Hapus**. Sambungan browser punya baris terpisah.

**Hapus** mengakhiri sambungan program komputer itu, bukan key aksesnya. Pasangkan lagi untuk menyambung kembali. Komputer lain tetap tersambung. Order yang sudah terkirim bisa selesai; penghapusan tidak membatalkan order, menghentikan bot, atau menutup posisi. Cabut key secara terpisah untuk mencabut aksesnya di mana pun ia dipakai.

## Statistik kunci <a href="#key-statistics" id="key-statistics"></a>

Setiap kunci menunjukkan aktivitas sendiri di Pengaturan dan Dashboard. **Aktif** menghitung order terbuka dan bot berjalan. **Volume** adalah nilai yang diperdagangkan order dan bot-nya, bukan saldo akun.

**PnL terealisasi** adalah laba atau rugi terealisasi dari transaksi kunci dan funding bot-nya setelah biaya. Tidak termasuk PnL belum terealisasi posisi terbuka yang berubah. Misalnya, laba tertutup 20 dikurangi biaya 2 dan funding dibayar 1 menyumbang 17. Funding diterima justru menambah hasil.

Angka menunjukkan total dan 24 jam terakhir. Jika kunci trading dalam beberapa mata uang, hasil tetap terpisah; laba satu mata uang tidak diam-diam ditambahkan ke mata uang lain.

## Key dan limit <a href="#keys-and-limits" id="keys-and-limits"></a>

Baris setiap key di **Pengaturan › MCP & API** menampilkan order dan bot terbukanya, volume trading, dan PnL; buka baris untuk melihat limitnya dan tekan **Ubah** untuk mengubah apa yang boleh dilakukannya atau limitnya. Usulannya menunggu di tab **Usulan** halaman Trade ([Usulan](#proposals)).

Untuk key **Trading**, pilih **Akun** dan **Pasar** (**Semua**, **Spot**, **Perpetual**, atau **Kustom**: pencarian dan pasar yang kamu centang dari hasilnya), lalu limit yang kamu inginkan. **Semua**, **Spot**, dan **Perpetual** mencakup pasar yang terdaftar kemudian. Akun dan pasar membatasi tempat ia trading; membaca dan mengusulkan tidak dibatasi. Tanpa akun atau pasar yang diatur, ia tidak bisa trading.

Setiap batas uang awalnya nonaktif dan bertuliskan **Tanpa batas**: aktifkan yang kamu mau lalu ketik nilainya. Batas dalam mata uang dasarmu (**Pengaturan › Umum › Mata uang dasar**, dolar AS sampai kamu memilih yang lain): key mempertahankan mata uang saat batasnya ditetapkan. Pasar dengan kuotasi stablecoin dihitung satu banding satu dengan dolar; pasar dengan kuotasi koin seperti BTC dinilai dengan harga koin itu. Batas membatasi ukuran transaksi agen, nilainya, bukan margin yang dipakai: pada 5x, order 1,000 USD memakai sekitar 200 USD margin.

Memilih mata uang dasar lain mengonversi batas setiap key sekali dengan kurs hari itu, lalu tetap menjadi jumlah dalam mata uang baru: batas 1,000 USD menjadi 900 EUR pada 0.9, dan yang diberlakukan adalah 900 EUR apa pun perubahan kurs berikutnya. Batas 24 jam menjumlahkan order dan bot key pada pasar berkuotasi berbeda, masing-masing dinilai dalam mata uang batas saat order diperiksa; pergantian tidak menulis ulang apa pun dalam 24 jam terakhir. Bot berukuran dekat batas bisa ditahan karena perubahan kurs; **Coba lagi** menjalankannya begitu sesuai. Kalau melebihi batas, penolakan menyebut kedua jumlah dalam mata uang batas ("Nilai order 945.00 EUR melebihi batas key ini sebesar 900.00 EUR"). Dengan BTC atau ETH sebagai mata uang dasar, batas berupa jumlah koin dan nilai dolar yang diizinkan berubah mengikuti harga koin.

| Bagian        | Limit                     | Yang kamu izinkan                                                                                                                                                                            |
| ------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Order**     | **Maks. per order**       | Nilai satu order yang ditempatkan agen, termasuk setelah perubahan. Exit dari trade-nya sendiri tidak dihitung.                                                                              |
|               | **Volume maks. 24 jam**   | Ordernya dalam 24 jam terakhir, terisi atau masih terbuka. Exit dari trade-nya sendiri dan order botnya tidak dihitung.                                                                      |
| **Bot**       | **Boleh menjalankan bot** | Aktif (bawaan): semua jenis bot, atau hanya jenis yang kamu centang. Mati: hanya order.                                                                                                      |
|               | **Maks. per bot**         | Uang satu bot: entry dan semua order averaging bot DCA, total investasi bot Grid.                                                                                                            |
|               | **Volume maks. 24 jam**   | Uang bot yang dimulainya dalam 24 jam terakhir. Siklus DCA dihitung saat dimulai; bot Grid saat diluncurkan dan saat investasinya bertambah.                                                 |
| **Perpetual** | **Maks. per posisi**      | Nilai posisinya di satu pasar setelah order. Ditampilkan bila pasarnya mencakup perpetual.                                                                                                   |
|               | **Maks. semua posisi**    | Nilai semua posisinya bersama-sama setelah order.                                                                                                                                            |
|               | **Margin**                | **Hanya terisolasi** (bawaan) atau **Apa saja**. Hanya terisolasi menjaga kerugian tiap posisi sebatas marginnya sendiri; margin cross bisa kehilangan seluruh akun.                         |
|               | **Leverage tertinggi**    | Mulai di 5x: leverage terbanyak yang boleh diatur atau dipakainya. Untuk bot, dicek saat peluncuran dan saat key mengubahnya. Ditampilkan, bersama Margin, bila pasarnya mencakup perpetual. |

Order yang memperkecil posisi selalu diizinkan, apa pun kata limit posisi. Key yang sama berbagi limitnya di semua aplikasi dan perangkat yang memakainya.

Kunci Trading dapat menempatkan order dan menjalankan bot pada akun dan pasar yang kamu izinkan, dalam batasnya. Bybit mendukung spot, futures USDT dan USDC serta futures invers; Bybit EU hanya spot. Di Binance dan Bybit, kunci dapat menetapkan leverage futures dalam **Leverage tertinggi** dan mengubah mode margin dalam **Margin** jika diizinkan bursa. Ubah mode margin Bybit Unified Trading Account di Bybit. Transaksi di Binance, Bybit dan Bybit EU membayar biaya goodcryptoX dengan [kredit](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/supported-exchanges/trading-credits.md); order dan bot baru memerlukan kredit seperti milikmu. Di pasar dengan margin koin, API dan alat MCP memberikan ukuran dalam kontrak, dengan nilai kontrak di sampingnya; panel menampilkan ukuran yang sama dalam USD dan koin.

Untuk agen di panduan ini, Volume maks. 24 jam untuk order adalah 10.000 USD dan 9.800 USD sudah terpakai. 400 lagi akan membawanya ke 10.200, jadi goodcryptoX menolak order itu. Pilih limit untuk trading yang kamu maksudkan, lalu salin key dan [hubungkan agen atau programmu](#connect-any-mcp-app-or-program).

Perlakukan key seperti password: siapa pun yang memegangnya bisa memakai izinnya di mana pun mereka bisa menjangkau instalasimu.

* **Tangguhkan** menghentikan key dari trading dan membatalkan ordernya yang menunggu yang akan membuka atau menambah posisi. Botnya dijeda: order entry dan averaging atau order pembukaan Grid dibatalkan, dan tidak ada siklus baru yang dimulai. Exit dan posisi yang ada tetap, dengan take-profit dan stop-loss tetap bekerja. Key tetap bisa membaca.
* **Lanjutkan** membiarkannya trading lagi dan melanjutkan botnya, memulihkan order pembukaan atau averaging yang dibatalkan oleh jeda. Order tunggal yang dibatalkan tetap dibatalkan; tidak perlu key atau pemasangan baru. Tinjau pasar dan bot sebelum melanjutkan.
* **Cabut** menghentikan key bekerja untuk selamanya, termasuk membaca, dan menerapkan jeda serta pembatalan yang sama. Botnya tetap dijeda sampai kamu menghentikannya. Buat key baru untuk memberi akses lagi. Key yang dicabut dan tidak pernah melakukan apa pun (tanpa order, bot, atau usulan) dihapus; yang punya catatan tetap di bawah **Dicabut** dengan riwayatnya; **Aktif** mendaftarkan key yang dipakai.

### Yang bisa dilakukan key trading <a href="#what-a-trading-key-can-do" id="what-a-trading-key-can-do"></a>

Ia bisa menempatkan order market, limit, stop, dan trailing, dengan take-profit dan stop-loss, di akun dan pasar yang diizinkan. Perubahan pada salah satu ordernya harus sesuai limitnya pada nilai yang diubah.

Ia bisa membatalkan order non-bot di akun yang diizinkan: milikmu, milik key lain, dan order yang ditempatkan di luar goodcryptoX, selain miliknya sendiri. Key memakai perintah yang diizinkan pada botnya sendiri; kamu bisa membatalkan sendiri order sisa bot yang berhenti.

Ia boleh menjual koin yang sudah kamu miliki atau trading melawan posisimu dalam limitnya. Jika agen ini menjual 0,1 ETH terhadap long 1 ETH-mu di akun yang posisinya digabung, long-mu menjadi 0,9 ETH. Simpan trading yang tidak terkait di akun lain kalau kamu ingin menghindari ini.

### Yang tidak dibatasi limit <a href="#what-the-limits-do-not-bound" id="what-the-limits-do-not-bound"></a>

Limit ini membatasi eksposur, bukan kerugian. Mereka tidak membatasi kerugian pada posisi yang dibangun selama beberapa hari, tidak mencegah trade dengan waktu buruk, atau menghentikan key menggeser atau membatalkan stop-loss-nya sendiri. Beberapa key yang berbagi satu akun menjumlahkan eksposurnya.

Pakai subakun terpisah dengan hanya dana yang siap kamu pertaruhkan. Ini memisahkan dana yang tersedia bagi agen dari trading lainmu; ini tidak membuat strateginya aman.

### Botnya <a href="#its-bots" id="its-bots"></a>

Bot dibatasi oleh limitnya sendiri, bukan limit order: order entry, averaging, dan grid-nya adalah rencananya. **Maks. per bot** dicek saat agen meluncurkan atau mengubah bot, dan lagi saat setiap siklus DCA dimulai. Peluncuran yang melebihinya ditolak dan tidak ada bot yang dibuat.

**Volume maks. 24 jam** milik bot menghitung uang tiap siklus DCA saat siklus dimulai, dan investasi bot Grid saat diluncurkan dan setiap kali bertambah. Jika agen ini meluncurkan tiga bot DCA dengan entry 500 USD dan empat order averaging masing-masing 300 USD, setiap siklus 1.700 USD. Di bawah limit 5.000 USD, dua yang pertama mulai; yang ketiga dibuat dan menunggu, dan kamu menerima pesan Telegram. Ia mulai sendiri begitu start pertama berumur 24 jam. Take-profit dan stop-loss yang ada tetap bekerja selama itu.

Permintaan pembuatan yang tidak menyebut `leverage` atau `marginMode` memakai nilai posisi yang terbuka, atau Isolated 5x jika tidak ada posisi, seperti yang dijelaskan referensi API. Jika exchange menolak leverage atau mode margin, permintaan pembuatan ditolak dan tidak ada bot yang mulai.

Key hanya bisa mengubah bot yang dibuatnya langsung. Pakai lembar strategi (contoh di akhir [Usulan](#proposals)) untuk menyiapkan dan meninjau rencana lengkap sebelum mengizinkannya meluncurkan.

Key yang dibuat sebelum limit ini mempertahankan aturan lamanya sampai kamu menyimpan limitnya lagi: setiap order bot harus sesuai order terbesarnya, dan setiap siklus dihitung di muka terhadap satu jatah 24 jam yang dibagi dengan ordernya.

### Saat key mencapai limit <a href="#when-a-key-meets-a-limit" id="when-a-key-meets-a-limit"></a>

Dashboard menampilkan **Mencapai batasnya**, dan Telegram menyebut agen dan limit yang tercapai. Buka key di **Pengaturan › MCP & API** dan tinjau aktivitas dan penggunaannya. Kurangi permintaan, tunggu jatah kosong, atau ubah limit sendiri; agen tidak bisa menaikkannya. Menurunkannya tidak menutup eksposur yang ada. Tinjau **Order → Buka**, **Posisi**, dan **Bot** saat kamu perlu mengurangi apa yang sudah berjalan.

### Memeriksa order lebih dulu <a href="#checking-an-order-first" id="checking-an-order-first"></a>

Minta pratinjau sebelum menempatkan order. Ia menampilkan ukuran, harga, nilai, dan peringatan yang diusulkan tanpa mengirim apa pun. Limit key dicek saat penempatan. Pratinjau adalah pemeriksaan rencana, bukan persetujuan trade.

Pratinjau bot DCA berisi `liquidation.price` untuk setiap sisi: harga saat exchange akan melikuidasi posisi seiring terisinya order bot. Pada Cross, ini perkiraan yang mengasumsikan tidak ada hal lain yang berubah di akun. `"0"` berarti tidak ada harga likuidasi (akun sepenuhnya menanggung posisi); `liquidation` bernilai `null` saat exchange tidak memberikan harga likuidasi untuk posisi (margin portofolio).

Pratinjau bot DCA juga memuat `margin`: `survive` adalah yang dibutuhkan akun agar bot mencapai stop loss-nya, dan `toLast` yang dibutuhkan untuk mengisi order averaging terakhirnya, keduanya termasuk fee dan dalam mata uang tempat pasar diselesaikan, seperti yang ditampilkan **Perkiraan margin** di formulir. Ukuran tiap order dibulatkan ke langkah exchange, jadi `margin.range`, `position.range`, dan `stop.range` memberi batas yang dilalui angka itu mengikuti harga; angka di halaman adalah yang akan dikirim sekarang. Ketiganya tidak ada bila kedua batas sama. Pratinjau Grid belum memuat kebutuhannya: agen membaca milik DCA.

Pratinjau bot Grid juga berisi `maxLoss`, baris **Rugi maks.** di form Grid: untuk Stop bawah dan Stop atas, rugi terbesar grid saat stop itu terpicu, termasuk biaya (`loss` dalam uang, `lossPct` persentase dari investasi (nilai order), seperti yang ditampilkan form; `by` menyebut apakah stop, stop loss, drawdown maksimum, atau likuidasi yang mengakhirinya lebih dulu). `by: none` dengan `reason` berarti tidak ada nilai terbesar, misalnya saat mengikuti ke dua arah. Ini perkiraan pada harga sekarang; lihat [Rugi maks. di stop](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/grid-bot/grid-setup.md#max-loss-at-a-stop).

Order key trading lolos dengan peringatan formulir; exchange masih bisa menolaknya. Minta agen menjelaskan peringatan itu sebelum trading. Key Usul menjaga keputusan itu di tanganmu.

## Usulan <a href="#proposals" id="proposals"></a>

Usulan adalah order atau bot yang disiapkan key **Usul** atau **Trading** untukmu. Ia menunggu sampai kamu meluncurkan atau membuangnya; tidak ada yang trading sebelumnya, dan hanya kamu yang bisa meluncurkannya.

Ia sampai kepadamu di Telegram, dengan tautan **Buka** setelah kamu memasangkan perangkat, dan menunggu di bagian atas Dashboard di **Perlu perhatianmu**. Untuk bertindak:

1. Tekan **Buka** di pesan Telegram, atau di baris Dashboard. Halaman Trade terbuka di tab **Usulan** (yang juga mendaftarkan setiap usulan yang menunggu).
2. Formulir order atau bot terisi dengan apa yang diusulkan agen, dengan catatan yang menyebut siapa yang mengusulkan. Ubah sesukamu.
3. Luncurkan dengan tombol yang disebut catatan, atau tekan **Buang** (juga ada di baris Dashboard).

Usulan diluncurkan sekali. Yang kamu luncurkan menjadi milikmu: key tidak bisa mengubahnya. Key yang diatur ke **Baca** membuang usulannya yang menunggu, begitu juga saat dicabut.

Program juga bisa menarik kembali usulannya sendiri selagi menunggu, dengan alat `withdraw_proposal` atau [API](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/api.md#withdrawing-a-proposal). Usulan itu langsung hilang dari daftarmu dan **Perlu perhatianmu**, dan tidak ada yang dikirim kepadamu; kartu key mencatatnya sebagai ditarik. Ia tidak bisa menarik usulan key lain, atau usulan yang sudah kamu luncurkan.

<details>

<summary>Contoh: lembar strategi menjadi bot DCA</summary>

Di sini agen AI mengubah lembar strategi, deskripsi bot yang ingin kamu jalankan, menjadi bot DCA di goodcryptoX.

1. **Pilih cara menyetujui.** Buat key **Usul** untuk meninjau dan meluncurkan setiap bot di goodcryptoX. Pilih **Trading** agar agen membuat bot sendiri, dengan akun, pasar, dan limit yang kamu izinkan. Mulai dengan Usul kalau kamu ingin memeriksa bagaimana ia membaca lembarmu.
2. **Hubungkan** memakai [Hubungkan aplikasi MCP atau program apa pun](#connect-any-mcp-app-or-program). Untuk goodcryptoX di komputer lain, pakai [Dari komputer lain](#from-another-computer) untuk memasangkan lewat relay; tunnel SSH adalah alternatif.
3. **Berikan lembar dan pilihanmu.** Mulai dengan satu profil: “Siapkan profil ETH ini di subakun trading-ku. Tunjukkan pengaturannya sebelum membuatnya.” Sebutkan profil mana yang kamu mau; beberapa profil di pasar yang sama menjumlahkan eksposurnya.
4. **Bandingkan pratinjau dengan lembar.** Minta pratinjau bot goodcryptoX. Periksa entry, setiap order averaging, total investasi, exit, dan pilihan pengulangan. Dengan Usul, [buka usulannya](#proposals) dan periksa formulir yang terisi sebelum **Luncurkan**. Dengan Trading, beri tahu agen kapan membuatnya. Kerugian stop di pratinjau (`stop.loss`) sudah termasuk fee: fee setiap order dan fee stop. Rugi maks. bot DCA adalah `slMaxLossPct`, persentase Investasinya. Bot yang dibuat sebelum 3.2.1 mungkin menyimpan `slLossPct` sebagai gantinya, persentase margin: tampilkan sebagai `slLossPct ÷` nilai `leverage` baris, dibulatkan ke bawah hingga 0,01 (20 pada 10x adalah 2), dan kirim `slMaxLossPct` untuk mengubahnya.
5. **Periksa hasilnya.** Buka **Bot** dan detail botnya. Tinjau apa yang dilakukan key di **Pengaturan › MCP & API**.

Ini satu profil DCA ETH. Entry dan keempat order averaging-nya masing-masing 359,35 USDC: lima order berjumlah 1.796,75 USDC untuk satu siklus. Take profit-nya 1,61% di atas harga entry rata-rata. Target itu tidak menjamin profit setelah semua biaya atau fill di harga target.

| Pengaturan lembar                                                               | Yang diperiksa di goodcryptoX                                                                              |
| ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Sinyal beli, candle 15 menit                                                    | **Kondisi masuk: Sinyal**; di bawah **Mulai saat**, peringkat TA Beli di 15m; Beli mencakup Beli kuat      |
| Long, mengikuti sinyal                                                          | **Mode masuk: Langsung**                                                                                   |
| Entry market                                                                    | **Jenis masuk: Market**                                                                                    |
| 359,35 USDC per order                                                           | **Ukuran masuk: 359,35**, dalam USDC                                                                       |
| Empat order averaging sama besar                                                | **Order averaging: 4**, **Order avg ke-1: Manual**, **Ukuran avg ke-1: 359,35**, **Pengali ukuran avg: 1** |
| Jarak pertama 0,96%; jarak berikutnya 1,1712%, dikali 1,22                      | **Langkah avg ke-1: 0,96%**, **Langkah harga avg: 1,1712%**, **Pengali langkah avg: 1,22**                 |
| Aktifkan setiap order averaging saat harga mencapai level terencana sebelumnya. | **Di exchange: Satu per satu**, **Post only** mati                                                         |
| Take Profit 1,61% dari entry rata-rata                                          | **Take profit** aktif di 1,61%, **Jenis TP: Limit**, **Tetapkan TP sebagai % dari harga order masuk** mati |
| Stop 2,197609% di bawah order averaging terakhir yang direncanakan              | **Stop loss** aktif di 2,197609%; **Stop loss sebagai: Dari order avg. terakhir, %**.                      |
| Satu siklus                                                                     | **Ulangi setelah:** **TP** dan **SL** keduanya mati                                                        |

Koma desimal di lembar tidak mengubah angkanya, begitu pula titik: 0,96% sama dengan 0.96%. Bandingkan harga dan jumlah di pratinjau dengan lembar. Dengan pengaturan ini, order averaging berada sekitar 0,960%, 2,120%, 3,519%, dan 5,200% di bawah entry. Pilih leverage dan margin dengan sengaja sebelum peluncuran.

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-4cbccfddbb1c69f7df536c890fcfea0d2d5ae3f0%2Fstrategy-sheet-form-entry.webp?alt=media" alt="Formulir DCA yang diisi dengan pengaturan entry dan averaging lembar, panah menunjuk Investment" width="300"><figcaption></figcaption></figure>

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-3b40082342a80336ec091fb0a958283ca3968d15%2Fstrategy-sheet-form-exits.webp?alt=media" alt="Formulir yang sama dengan exit dan Daftar order, panah menunjuk Total" width="300"><figcaption></figcaption></figure>

Minta agen menandai aturan yang tidak didukung. Pengaturan indikator platform lain, batas kerugian yang dimodelkan, pergeseran stop ke breakeven, atau batas waktu sejak fill pertama mungkin tidak punya pengaturan yang cocok. Ia harus menjelaskan bedanya sebelum kamu trading.

[Izin](#keys-and-limits) menentukan apakah agen membaca, mengusulkan, atau trading; ia tidak bisa menarik dana atau menaikkan jatahnya sendiri. Untuk peluncuran **Trading** langsung, [limit bot](#its-bots) key mencakup seluruh uang bot: siklus 1.796,75 USDC profil ini melebihi **Maks. per bot** 1.000 USD, jadi bot tidak dibuat; revisi profil atau limitnya sendiri. Usulan masih bisa disiapkan untuk kamu tinjau dan luncurkan.

</details>

## Pertanyaan <a href="#questions" id="questions"></a>

### Bisakah Claude menempatkan trade untukku? <a href="#can-claude-place-trades-for-me" id="can-claude-place-trades-for-me"></a>

Bisa, dengan key **Trading**: ia membaca, menempatkan, dan membatalkan order serta menjalankan botnya sendiri dalam akun, pasar, dan limitmu. Dengan key **Usul**, tidak ada yang trading tanpamu.

### Apakah goodcryptoX punya server MCP? <a href="#does-goodcryptox-have-an-mcp-server" id="does-goodcryptox-have-an-mcp-server"></a>

Ya: server MCP goodcryptoX menghubungkan Claude Desktop, Claude Code, Codex, Cursor, dan aplikasi MCP lain ke instalasimu sendiri, dengan key dari **Pengaturan › MCP & API**. Kami tidak menjalankan server MCP publik untuk kamu sambungi.

### Apakah key atau tradingku melewati server goodcryptoX? <a href="#does-my-key-or-my-trading-go-through-goodcryptoxs-servers" id="does-my-key-or-my-trading-go-through-goodcryptoxs-servers"></a>

Hanya dari perangkat lain, lewat relay kami, yang tidak bisa membaca key akses, permintaan, atau balasanmu. [Tunnel SSH](#use-an-ssh-tunnel-instead) melewati relay.

### Bisakah agen menarik dana? <a href="#can-the-agent-withdraw-funds" id="can-the-agent-withdraw-funds"></a>

Tidak: tidak ada key yang bisa menarik atau mentransfer dana, mengubah pengaturanmu, atau membuat key lain.

### Aplikasi mana yang bisa dipakai: Claude, Codex, Cursor, lainnya? <a href="#which-apps-work-claude-codex-cursor-others" id="which-apps-work-claude-codex-cursor-others"></a>

Claude Desktop, Claude Code, Codex, dan Cursor masing-masing punya barisnya sendiri di **Pengaturan › MCP & API**, tanpa yang perlu diisi. Aplikasi lain yang menjalankan server MCP lewat standard input dan output memakai entri yang sama.

### Apakah ada API? <a href="#is-there-an-api" id="is-there-an-api"></a>

Ya: programmu sendiri membaca dan trading lewat API goodcryptoX, dengan key, izin, dan limit yang sama seperti agen AI ([API](https://docs.goodcrypto.app/goodcryptox-id/goodcryptox-3.0/api.md)).
