mcp-foxbit

@codespar/mcp-foxbit

面向 Foxbit 的 MCP 服务——巴西加密货币交易所，提供交易、订单簿和市场数据

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "foxbit": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-foxbit"],
      "env": {
        "FOXBIT_API_KEY": "your-key",
        "FOXBIT_API_SECRET": "your-secret"
      }
    }
  }
}

Claude Code

claude mcp add foxbit -- npx @codespar/mcp-foxbit

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "foxbit": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-foxbit"],
      "env": {
        "FOXBIT_API_KEY": "your-key",
        "FOXBIT_API_SECRET": "your-secret"
      }
    }
  }
}

工具（21）

工具	用途
list_markets	列出 Foxbit 上所有可用的交易对／市场
list_currencies	列出 Foxbit 上所有支持的货币（加密货币和法币）
get_currency	获取特定货币的详细信息（精度、最小／最大金额、类型）
get_ticker	获取市场的 24 小时行情数据（价格、成交量、最高／最低价）
get_orderbook	获取市场的订单簿（买单和卖单）
get_market_trades	获取市场近期的公开交易（交易历史／逐笔成交记录）
get_candles	获取市场的 OHLC 蜡烛图数据
get_account_balances	获取所有货币的账户余额
get_balance	获取单种货币的账户余额
create_order	创建买入或卖出订单（限价单或市价单）
get_order	根据 ID 获取订单详情
list_orders	列出订单，可选择使用筛选条件
cancel_order	根据 ID 取消未成交订单
list_trades	列出用户已成交的交易（私人交易历史）
list_deposits_withdrawals	列出某种货币的充值和提现（交易记录）
create_pix_deposit	创建 Pix 即时充值（BRL）。
list_pix_deposits	列出 Pix 充值历史（BRL 即时充值）
create_pix_withdrawal	创建 Pix 提现（BRL），转至 Pix 密钥
list_pix_withdrawals	列出 Pix 提现历史（BRL 法币提现）
create_crypto_withdrawal	向外部钱包地址发起加密货币提现
get_trading_fees	获取当前交易手续费和限额（每个交易对的 maker/taker 手续费、提现限额）

身份验证

Foxbit 使用 HMAC-SHA256 请求签名。每个请求都包含三个标头：

• X-FB-ACCESS-KEY — API 密钥
• X-FB-ACCESS-TIMESTAMP — UNIX 时间戳，单位为毫秒
• X-FB-ACCESS-SIGNATURE — 使用 API 密钥对 timestamp + method + path + queryString + body 进行 HMAC-SHA256 运算后得到的十六进制值

基础 URL：https://api.foxbit.com.br/rest/v3

获取凭据

1. 前往 Foxbit
2. 创建账户（巴西居民需要完成 KYC）
3. 前往 API 设置，生成密钥和密钥密文
4. 设置环境变量

环境变量

变量	必需	描述
FOXBIT_API_KEY	是	Foxbit 的 API 密钥
FOXBIT_API_SECRET	是	用于 HMAC-SHA256 的 API 密钥密文

CodeSpar 中的巴西加密货币交易所

在多个巴西交易平台之间对冲流动性：

• Mercado Bitcoin — 巴西最大的交易所，支持 200 多种代币，山寨币覆盖广泛
• Foxbit（本项目） — 巴西第二大交易所，专注于 BTC / ETH / LTC，机构交易业务实力强

商户和交易者会同时使用两者，以实现最佳执行并提高冗余性。

路线图

v0.2（计划中）

• get_candles — OHLCV 蜡烛图数据
• create_withdrawal — 发起加密货币／PIX 提现
• list_currencies — 可用货币和网络
• get_fees — 账户等级对应的交易手续费
• create_stop_order — 止损限价单／止损市价单

v0.3（计划中）

• 机构／OTC 交易业务集成
• WebSocket 市场数据流（MCP 传输支持的情况下）

想要参与贡献？提交 PR，或申请工具。

链接

• Foxbit 网站
• Foxbit API 文档
• MCP Dev LATAM
• 落地页

企业版

需要对 Agent 支付进行治理、设置预算限制并保留审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、支付路由和合规模板。

许可证

MIT