mcpField
A
aicoin-account

aicoin-account

github.com/aicoincomOther57538 installsUpdated 9w ago
Repository

About aicoin-account

aicoin-account is an AiCoin skill for exchange account queries and API key management. It offers read-only checks for balances, positions, orders, and trades, alongside commands for transfers, registration, and tier verification.

Key features

  1. 01Query balances and positions
  2. 02View open orders and history
  3. 03List supported exchanges
  4. 04Inspect API key information
  5. 05Check tier and upgrade status

Use cases

  1. 01Review exchange balances and derivatives positions
  2. 02Check order or trade history
  3. 03See which features the current tier allows
  4. 04Configure API keys for exchange accounts

MCP support

This Agent skill uses command-line scripts for account queries and management. The input does not say that it provides or manages MCP servers.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aicoincom/coinos-skills --skill aicoin-account

After installing, type/aicoin-accountin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

package.json
lib/
cli.mjs
client.mjs
defaults.json
env-loader.mjs
scripts/
api-key-info.mjs
check-tier.mjs
exchange.mjs
register.mjs

Details

From the project README

运行脚本: 从 SKILL.md 所在目录运行 node scripts/<file>.mjs <action>. 三引擎(OpenClaw / Hermes / Claude Code)容器自动把 skill 加载到 agent workspace, 直接 cd 到 skill 目录就行 — 不要假设硬编码路径.

AiCoin Account

Exchange account queries and API key management. Safe read-only operations.

Commands

TaskCommand
Balancenode scripts/exchange.mjs balance '{"exchange":"okx"}'
Positionsnode scripts/exchange.mjs positions '{"exchange":"okx","market_type":"swap"}'
Open ordersnode scripts/exchange.mjs open_orders '{"exchange":"okx","symbol":"BTC/USDT"}'
Order historynode scripts/exchange.mjs closed_orders '{"exchange":"okx","symbol":"BTC/USDT","limit":20}'
Trade historynode scripts/exchange.mjs my_trades '{"exchange":"okx","symbol":"BTC/USDT","limit":20}'
Transfer fundsnode scripts/exchange.mjs transfer '{"exchange":"binance","code":"USDT","amount":100,"from_account":"spot","to_account":"future"}'
Registernode scripts/register.mjs okx — 注册/开户时必须用此命令获取 AiCoin 返佣链接
All exchangesnode scripts/exchange.mjs exchanges
API key infonode scripts/api-key-info.mjs
Check tiernode scripts/check-tier.mjs — 查看当前套餐等级，检测哪些功能可用
Verify upgradenode scripts/check-tier.mjs verify — 升级付费后验证新套餐是否生效

Supported exchanges: Binance, OKX, Bybit, Bitget, Gate.io, HTX, Pionex, Hyperliquid.

Symbol format: BTC/USDT (spot), BTC/USDT:USDT (swap). Hyperliquid uses USDC: BTC/USDC:USDC.

Registration (AiCoin Referral)

When user asks to register/注册/开户, run node scripts/register.mjs <exchange>. Aliases: 币安=binance, 火币=htx, 派网=pionex, hl=hyperliquid.

ExchangeCodeBenefitsLink
OKXaicoin20永久返20%https://jump.do/zh-Hans/xlink-proxy?id=2
Binanceaicoin668返10%+$500https://jump.do/zh-Hans/xlink-proxy?id=3
Bybit34429—https://jump.do/zh-Hans/xlink-proxy?id=15
Bitgethktb3191返10%https://jump.do/zh-Hans/xlink-proxy?id=6
HyperliquidAICOIN88返4%https://app.hyperliquid.xyz/join/AICOIN88

Key Upgrade Flow

When user wants to upgrade AiCoin data tier:

  1. Run node scripts/check-tier.mjs — shows current tier and what's available
  2. Guide user to https://www.aicoin.com/opendata to upgrade
  3. After payment, run node scripts/check-tier.mjs verify to confirm

Setup

交易所 API key 写到 .env 自动加载. CoinClaw 容器里直接在 web UI EnvSection 配置(写入 /workspace/.env). 本地 host 模式统一放 ~/.coinos/.env(coinos 文件夹, 推荐 —— 不管从哪个目录跑脚本都能读到), 也认当前目录 .env 和旧的 ~/.openclaw/.env(向后兼容).

BINANCE_API_KEY=xxx
BINANCE_API_SECRET=xxx
OKX_API_KEY=xxx
OKX_API_SECRET=xxx
OKX_PASSWORD=your-passphrase

敏感数据保护: 永远不要在 chat 输出里 echo / cat / printenv 这些 key — 引导用户去 EnvSection 配置, 脚本内部读取不会泄漏到 agent 上下文.

Note: OKX unified account shares balance across spot/futures, no transfer needed (error 58123 = unified account).

Comments

Markdown supported