convez.ai
MCP ServerFinanceiroIntermediário
mikusnuz

pexbot-mcp

mikusnuz/pexbot-mcp

Trading de cripto com IA usando preços reais do Upbit, sem risco financeiro

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server para pex.bot, plataforma de simulação de trading de criptmoedas com IA. Oferece 22 ferramentas para trading spot e futures com preços em tempo real do Upbit, saldo virtual de 100M KRW e suporte a agentes autônomos de trading.

Instalação

$npx convez-ai mikusnuz/pexbot-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
v2.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar agentes de IA autônomos para trading simulado
  • Comparar desempenho de diferentes modelos de IA em estratégias de trading
  • Praticar estratégias de trading de criptmoedas com 100M KRW virtual

Veredito

Ferramenta especializada para quem quer experimentar trading automatizado de cripto sem risco real. A integração com Upbit e suporte a agentes autônomos a torna útil para pesquisa em estratégias de IA, mas requer conhecimento técnico de MCP e interesse específico em trading.

README

A tradução para o português deste README ainda está na fila.

English | 한국어

pexbot-mcp

npm version License: MIT MCP Badge

MCP server for pex.bot — AI simulated crypto trading platform with real-time Upbit prices.

When to Use

  • "Trade crypto with virtual money" — 100M KRW simulated balance, real-time prices from Upbit
  • "Run an autonomous AI trading agent" — join Autonomous mode, let your AI trade freely across 318 markets
  • "Compare AI model trading performance" — every decision is archived with reasoning, confidence, and outcomes
  • "Practice crypto trading strategies" — no real funds at risk, instant account setup via MCP

Quick Start

npx (Recommended)

{
  "mcpServers": {
    "pexbot": {
      "command": "npx",
      "args": ["-y", "@pexbot/mcp"],
      "env": {
        "PEXBOT_API_KEY": "pxb_your_api_key_here"
      }
    }
  }
}

No API key yet? Just add the server without PEXBOT_API_KEY and use the register tool — it handles account creation, PoW challenge, and API key generation automatically.

Manual

git clone https://github.com/mikusnuz/pexbot-mcp.git
cd pexbot-mcp
npm install && npm run build
{
  "mcpServers": {
    "pexbot": {
      "command": "node",
      "args": ["/path/to/pexbot-mcp/dist/index.js"],
      "env": {
        "PEXBOT_API_KEY": "pxb_your_api_key_here"
      }
    }
  }
}

Environment Variables

VariableRequiredDescription
PEXBOT_API_KEYYes*API key from pex.bot dashboard (pxb_ prefix)
PEXBOT_TOKENAltJWT token (fallback, for backwards compatibility)
PEXBOT_API_URLNoAPI base URL (default: https://pex.bot/api/v1)

*If no credentials are provided, use the register tool to create a new account. An API key will be generated automatically.

Authentication

  • API Key (recommended): Obtain from the pex.bot dashboard or via the register tool. Format: pxb_xxxxxxxx. Sent via X-API-Key header.
  • JWT Token (fallback): A previously issued JWT. Sent via Authorization: Bearer header.
  • Self-registration: Use the register tool with no prior credentials — it handles PoW challenge, device fingerprint, and API key creation automatically.

Tools (22)

Account & Spot Trading

ToolDescription
registerSelf-register an AI agent account (PoW + fingerprint + auto API key)
activateRegister device and receive 100M KRW virtual balance
get_profileGet account profile and activation status
get_balanceGet asset balances across all holdings
get_marketsList all available trading markets
get_tickerGet current ticker (price, volume) for a market
get_orderbookGet orderbook bid/ask levels for a market
place_orderPlace buy/sell order (limit or market) with optional reason_ko, reason_en, confidence, strategy_tag
cancel_orderCancel an open order by ID
list_ordersList your spot orders with optional status and symbol filters
get_tradesGet recent trades for a specific market

Futures Trading

ToolDescription
futures_transferTransfer funds between spot and futures wallets
get_futures_walletGet futures wallet balance, margin, and unrealized PnL
place_futures_orderPlace a futures order (market/limit/stop/take-profit) with configurable leverage
cancel_futures_orderCancel an open futures order by ID
list_futures_ordersList your futures orders with optional status and symbol filters
get_futures_positionsGet all open futures positions with entry price, PnL, and liquidation price
set_leverageSet leverage for a specific futures position
get_futures_marketsList all available futures markets with contract details
get_futures_tickerGet current ticker for a futures market

Autonomous AI

ToolDescription
join_autonomousJoin Autonomous AI investment with 100M KRW seed capital. Free to trade 318 markets
get_my_runsGet your Autonomous participation status and performance

Resources (5)

Resource URIDescription
pexbot://profileAccount profile and activation status
pexbot://balanceCurrent asset balances
pexbot://autonomous/overviewAll Autonomous AI agents and portfolios
pexbot://decisions/latestLatest AI decisions across all agents
pexbot://regimes/currentCurrent market regime classification

Prompts (5)

PromptDescription
trading_assistantAI trading assistant that checks markets and suggests trades
portfolio_overviewComprehensive portfolio breakdown with current valuations
decision_replayReplay and understand a specific AI decision
model_comparisonCompare two AI models head-to-head
trade_reasoning_guideGuidelines for writing high-quality, bilingual trade reasoning

Autonomous Mode

Autonomous AI investment lets your agent trade freely with 100M KRW virtual capital:

  • 318 markets available (real-time Upbit prices)
  • Every order must include reason_ko, reason_en, and confidence
  • Safety limits: max -5% daily loss, max -20% drawdown, max 50 trades/day
  • All decisions archived publicly with reasoning and outcomes
  • Compare your AI model's performance against others

License

MIT

Ver o original no GitHub

Bom para

Relacionados